@lwrjs/everywhere 0.12.0-alpha.16 → 0.12.0-alpha.18

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

@@ -1,4 +1,4 @@
-LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
+LWR.define('lwc/v/6_2_1', ['exports'], (function (exports) { 'use strict';
 
   /**
    * Copyright (c) 2024 Salesforce, Inc.
@@ -12,21 +12,40 @@ LWR.define('lwc/v/6_2_0', ['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
    */
+  /**
+   *
+   * @param value
+   * @param msg
+   */
   function invariant(value, msg) {
     if (!value) {
       throw new Error(`Invariant Violation: ${msg}`);
     }
   }
+  /**
+   *
+   * @param value
+   * @param msg
+   */
   function isTrue$1(value, msg) {
     if (!value) {
       throw new Error(`Assert Violation: ${msg}`);
     }
   }
+  /**
+   *
+   * @param value
+   * @param msg
+   */
   function isFalse$1(value, msg) {
     if (value) {
       throw new Error(`Assert Violation: ${msg}`);
     }
   }
+  /**
+   *
+   * @param msg
+   */
   function fail(msg) {
     throw new Error(msg);
   }
@@ -39,31 +58,50 @@ LWR.define('lwc/v/6_2_0', ['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
    */
   const {
+    /** Detached {@linkcode Object.assign}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/assign MDN Reference}. */
     assign,
+    /** Detached {@linkcode Object.create}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/create MDN Reference}. */
     create,
+    /** Detached {@linkcode Object.defineProperties}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperties MDN Reference}. */
     defineProperties,
+    /** Detached {@linkcode Object.defineProperty}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/defineProperty MDN Reference}. */
     defineProperty,
+    /** Detached {@linkcode Object.entries}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries MDN Reference}. */
     entries,
+    /** Detached {@linkcode Object.freeze}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze MDN Reference}. */
     freeze,
+    /** Detached {@linkcode Object.getOwnPropertyDescriptor}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptor MDN Reference}. */
     getOwnPropertyDescriptor: getOwnPropertyDescriptor$1,
+    /** Detached {@linkcode Object.getOwnPropertyDescriptors}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptors MDN Reference}. */
     getOwnPropertyDescriptors,
+    /** Detached {@linkcode Object.getOwnPropertyNames}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyNames MDN Reference}. */
     getOwnPropertyNames: getOwnPropertyNames$1,
+    /** Detached {@linkcode Object.getPrototypeOf}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getPrototypeOf MDN Reference}. */
     getPrototypeOf: getPrototypeOf$1,
+    /** Detached {@linkcode Object.hasOwnProperty}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty MDN Reference}. */
     hasOwnProperty: hasOwnProperty$1,
+    /** Detached {@linkcode Object.isFrozen}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/isFrozen MDN Reference}. */
     isFrozen,
+    /** Detached {@linkcode Object.keys}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/keys MDN Reference}. */
     keys,
+    /** Detached {@linkcode Object.seal}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/seal MDN Reference}. */
     seal,
+    /** Detached {@linkcode Object.setPrototypeOf}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/setPrototypeOf MDN Reference}. */
     setPrototypeOf
   } = Object;
+  /** Detached {@linkcode Array.isArray}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray MDN Reference}. */
   const {
     isArray: isArray$1
   } = Array;
+  // For some reason, JSDoc don't get picked up for multiple renamed destructured constants (even
+  // though it works fine for one, e.g. isArray), so comments for these are added to the export
+  // statement, rather than this declaration.
   const {
     concat: ArrayConcat$1,
     copyWithin: ArrayCopyWithin,
@@ -86,7 +124,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
     sort: ArraySort,
     splice: ArraySplice,
     unshift: ArrayUnshift,
-    forEach
+    forEach // Weird anomaly!
   } = Array.prototype;
   // The type of the return value of Array.prototype.every is `this is T[]`. However, once this
   // Array method is pulled out of the prototype, the function is now referencing `this` where
@@ -94,12 +132,21 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   //
   // Exposing this helper function is the closest we can get to preserving the usage patterns
   // of Array.prototype methods used elsewhere in the codebase.
+  /**
+   * Wrapper for {@linkcode Array.prototype.every} that correctly preserves the type predicate in the
+   * return value; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/every MDN Reference}.
+   * @param arr Array to test.
+   * @param predicate A function to execute for each element of the array.
+   * @returns Whether all elements in the array pass the test provided by the predicate.
+   */
   function arrayEvery(arr, predicate) {
     return ArrayEvery.call(arr, predicate);
   }
+  /** Detached {@linkcode String.fromCharCode}; see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/fromCharCode MDN Reference}. */
   const {
     fromCharCode: StringFromCharCode
   } = String;
+  // No JSDocs here - see comment for Array.prototype
   const {
     charCodeAt: StringCharCodeAt,
     replace: StringReplace,
@@ -107,54 +154,124 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
     slice: StringSlice,
     toLowerCase: StringToLowerCase
   } = String.prototype;
+  /**
+   * Determines whether the argument is `undefined`.
+   * @param obj Value to test
+   * @returns `true` if the value is `undefined`.
+   */
   function isUndefined$1(obj) {
     return obj === undefined;
   }
+  /**
+   * Determines whether the argument is `null`.
+   * @param obj Value to test
+   * @returns `true` if the value is `null`.
+   */
   function isNull(obj) {
     return obj === null;
   }
+  /**
+   * Determines whether the argument is `true`.
+   * @param obj Value to test
+   * @returns `true` if the value is `true`.
+   */
   function isTrue(obj) {
     return obj === true;
   }
+  /**
+   * Determines whether the argument is `false`.
+   * @param obj Value to test
+   * @returns `true` if the value is `false`.
+   */
   function isFalse(obj) {
     return obj === false;
   }
+  /**
+   * Determines whether the argument is a boolean.
+   * @param obj Value to test
+   * @returns `true` if the value is a boolean.
+   */
   function isBoolean(obj) {
     return typeof obj === 'boolean';
   }
+  /**
+   * Determines whether the argument is a function.
+   * @param obj Value to test
+   * @returns `true` if the value is a function.
+   */
   // Replacing `Function` with a narrower type that works for all our use cases is tricky...
   // eslint-disable-next-line @typescript-eslint/ban-types
   function isFunction$1(obj) {
     return typeof obj === 'function';
   }
+  /**
+   * Determines whether the argument is an object or null.
+   * @param obj Value to test
+   * @returns `true` if the value is an object or null.
+   */
   function isObject(obj) {
     return typeof obj === 'object';
   }
+  /**
+   * Determines whether the argument is a string.
+   * @param obj Value to test
+   * @returns `true` if the value is a string.
+   */
   function isString(obj) {
     return typeof obj === 'string';
   }
+  /**
+   * Determines whether the argument is a number.
+   * @param obj Value to test
+   * @returns `true` if the value is a number.
+   */
   function isNumber(obj) {
     return typeof obj === 'number';
   }
+  /** Does nothing! 🚀 */
   function noop() {
     /* Do nothing */
   }
   const OtS$1 = {}.toString;
+  /**
+   * Converts the argument to a string, safely accounting for objects with "null" prototype.
+   * Note that `toString(null)` returns `"[object Null]"` rather than `"null"`.
+   * @param obj Value to convert to a string.
+   * @returns String representation of the value.
+   */
   function toString$1(obj) {
-    if (obj && obj.toString) {
+    if (obj?.toString) {
       // Arrays might hold objects with "null" prototype So using
       // Array.prototype.toString directly will cause an error Iterate through
       // all the items and handle individually.
       if (isArray$1(obj)) {
+        // This behavior is slightly different from Array#toString:
+        // 1. Array#toString calls `this.join`, rather than Array#join
+        // Ex: arr = []; arr.join = () => 1; arr.toString() === 1; toString(arr) === ''
+        // 2. Array#toString delegates to Object#toString if `this.join` is not a function
+        // Ex: arr = []; arr.join = 'no'; arr.toString() === '[object Array]; toString(arr) = ''
+        // 3. Array#toString converts null/undefined to ''
+        // Ex: arr = [null, undefined]; arr.toString() === ','; toString(arr) === '[object Null],undefined'
+        // 4. Array#toString converts recursive references to arrays to ''
+        // Ex: arr = [1]; arr.push(arr, 2); arr.toString() === '1,,2'; toString(arr) throws
+        // Ref: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toString
         return ArrayJoin.call(ArrayMap.call(obj, toString$1), ',');
       }
       return obj.toString();
     } else if (typeof obj === 'object') {
+      // This catches null and returns "[object Null]". Weird, but kept for backwards compatibility.
       return OtS$1.call(obj);
     } else {
-      return obj + '';
+      return String(obj);
     }
   }
+  /**
+   * Gets the property descriptor for the given object and property key. Similar to
+   * {@linkcode Object.getOwnPropertyDescriptor}, but looks up the prototype chain.
+   * @param o Value to get the property descriptor for
+   * @param p Property key to get the descriptor for
+   * @returns The property descriptor for the given object and property key.
+   */
   function getPropertyDescriptor(o, p) {
     do {
       const d = getOwnPropertyDescriptor$1(o, p);
@@ -175,6 +292,11 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   // It's a bit annoying to do have to do this manually, but this makes the file tree-shakeable,
   // passing the `verify-treeshakeable.js` test.
   const LOWEST_API_VERSION = 58 /* APIVersion.V58_244_SUMMER_23 */;
+  /**
+   *
+   * @param apiVersionFeature
+   * @param apiVersion
+   */
   function isAPIFeatureEnabled(apiVersionFeature, apiVersion) {
     switch (apiVersionFeature) {
       case 0 /* APIFeature.LOWERCASE_SCOPE_TOKENS */:
@@ -261,6 +383,10 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * Map associating previously transformed HTML property into HTML attribute.
    */
   const CACHED_PROPERTY_ATTRIBUTE_MAPPING = /*@__PURE__@*/new Map();
+  /**
+   *
+   * @param propName
+   */
   function htmlPropertyToAttribute(propName) {
     const ariaAttributeName = AriaPropNameToAttrNameMap[propName];
     if (!isUndefined$1(ariaAttributeName)) {
@@ -293,6 +419,10 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * Map associating previously transformed kabab-case attributes into camel-case props.
    */
   const CACHED_KEBAB_CAMEL_MAPPING = /*@__PURE__@*/new Map();
+  /**
+   *
+   * @param attrName
+   */
   function kebabCaseToCamelCase(attrName) {
     let result = CACHED_KEBAB_CAMEL_MAPPING.get(attrName);
     if (isUndefined$1(result)) {
@@ -309,16 +439,16 @@ LWR.define('lwc/v/6_2_0', ['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.0";
+  const LWC_VERSION = "6.2.1";
   const LWC_VERSION_COMMENT_REGEX = /\/\*LWC compiler v([\d.]+)\*\/\s*}/;
-  /** version: 6.2.0 */
+  /** version: 6.2.1 */
 
   /**
    * Copyright (c) 2024 Salesforce, Inc.
    */
 
   /*
-   * 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
@@ -346,6 +476,10 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * Set the value at runtime of a given feature flag. This method only be invoked once per feature
    * flag. It is meant to be used during the app initialization.
+   * @param name Name of the feature flag to set
+   * @param value Whether the feature flag should be enabled
+   * @throws Will throw if a non-boolean value is provided when running in production.
+   * @example setFeatureFlag("DISABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE", true)
    */
   function setFeatureFlag(name, value) {
     if (!isBoolean(value)) {
@@ -383,6 +517,9 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * Set the value at runtime of a given feature flag. This method should only be used for testing
    * purposes. It is a no-op when invoked in production mode.
+   * @param name Name of the feature flag to enable or disable
+   * @param value Whether the feature flag should be enabled
+   * @example setFeatureFlag("DISABLE_NATIVE_CUSTOM_ELEMENT_LIFECYCLE", true)
    */
   function setFeatureFlagForTest(name, value) {
     // This may seem redundant, but `process.env.NODE_ENV === 'test-karma-lwc'` is replaced by Karma tests
@@ -390,7 +527,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
       setFeatureFlag(name, value);
     }
   }
-  /** version: 6.2.0 */
+  /** version: 6.2.1 */
 
   /**
    * Copyright (c) 2024 Salesforce, Inc.
@@ -415,8 +552,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   const reportingControl = {
     /**
      * Attach a new reporting control (aka dispatcher).
-     *
-     * @param dispatcher - reporting control
+     * @param dispatcher reporting control
      */
     attachDispatcher(dispatcher) {
       enabled$1 = true;
@@ -457,7 +593,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * Report to the current dispatcher, if there is one.
    * @param reportingEventId
-   * @param payload - data to report
+   * @param payload data to report
    */
   function report(reportingEventId, payload) {
     if (enabled$1) {
@@ -1600,7 +1736,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
       valueMutated(originalTarget, key);
       return true;
     }
-    /*LWC compiler v6.2.0*/
+    /*LWC compiler v6.2.1*/
   }
   const getterMap = new WeakMap();
   const setterMap = new WeakMap();
@@ -1693,7 +1829,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
       /* istanbul ignore next */
       return false;
     }
-    /*LWC compiler v6.2.0*/
+    /*LWC compiler v6.2.1*/
   }
   function extract(objectOrArray) {
     if (isArray(objectOrArray)) {
@@ -1879,6 +2015,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * EXPERIMENTAL: This function implements an unwrap mechanism that
    * works for observable membrane objects. This API is subject to
    * change or being removed.
+   * @param value
    */
   function unwrap(value) {
     // On the server side, we don't need mutation tracking. Skipping it improves performance.
@@ -1992,6 +2129,8 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * that a Custom Element can support (including AOM properties), which
    * determines what kind of capabilities the Base Lightning Element should support. When producing the new descriptors
    * for the Base Lightning Element, it also include the reactivity bit, so the standard property is reactive.
+   * @param propName
+   * @param descriptor
    */
   function createBridgeToElementDescriptor(propName, descriptor) {
     const {
@@ -2046,7 +2185,7 @@ LWR.define('lwc/v/6_2_0', ['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
   const LightningElement = function () {
     // This should be as performant as possible, while any initialization should be done lazily
@@ -3034,9 +3173,11 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
    */
   /**
-   * @wire decorator to wire fields and methods to a wire adapter in
+   * The @wire decorator wires fields and methods to a wire adapter in
    * LWC Components. This function implements the internals of this
    * decorator.
+   * @param _adapter
+   * @param _config
    */
   function wire(_adapter, _config) {
     if (process.env.NODE_ENV !== 'production') {
@@ -3144,6 +3285,8 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * INTERNAL: This function can only be invoked by compiled code. The compiler
    * will prevent this function from being imported by user-land code.
+   * @param Ctor
+   * @param meta
    */
   function registerDecorators(Ctor, meta) {
     const proto = Ctor.prototype;
@@ -3339,6 +3482,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * INTERNAL: This function can only be invoked by compiled code. The compiler
    * will prevent this function from being imported by userland code.
+   * @param tpl
    */
   function registerTemplate(tpl) {
     if (process.env.NODE_ENV !== 'production') {
@@ -3352,6 +3496,10 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * EXPERIMENTAL: This function acts like a hook for Lightning Locker Service and other similar
    * libraries to sanitize vulnerable attributes.
+   * @param tagName
+   * @param namespaceUri
+   * @param attrName
+   * @param attrValue
    */
   function sanitizeAttribute(tagName, namespaceUri, attrName, attrValue) {
     // locker-service patches this function during runtime to sanitize vulnerable attributes. When
@@ -3450,7 +3598,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   }
   function HTMLBridgeElementFactory(SuperClass, publicProperties, methods, observedFields, proto, hasCustomSuperClass) {
     const HTMLBridgeElement = class extends SuperClass {
-      /*LWC compiler v6.2.0*/
+      /*LWC compiler v6.2.1*/
     };
     // generating the hash table for attributes to avoid duplicate fields and facilitate validation
     // and false positives in case of inheritance.
@@ -3957,6 +4105,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * EXPERIMENTAL: This function allows for the identification of LWC constructors. This API is
    * subject to change or being removed.
+   * @param ctor
    */
   function isComponentConstructor(ctor) {
     if (!isFunction$1(ctor)) {
@@ -4030,6 +4179,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * EXPERIMENTAL: This function allows for the collection of internal component metadata. This API is
    * subject to change or being removed.
+   * @param Ctor
    */
   function getComponentDef(Ctor) {
     const def = getComponentInternalDef(Ctor);
@@ -4244,6 +4394,8 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * If the component that is currently being rendered uses scoped styles,
    * this returns the unique token for that scoped stylesheet. Otherwise
    * it returns null.
+   * @param owner
+   * @param legacy
    */
   // TODO [#3733]: remove support for legacy scope tokens
   function getScopeTokenClass(owner, legacy) {
@@ -4258,6 +4410,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * exists. Otherwise it returns null.
    *
    * A host style token is applied to the component if scoped styles are used.
+   * @param vnode
    */
   function getStylesheetTokenHost(vnode) {
     const {
@@ -4732,11 +4885,9 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   }
   /**
    * Given an array of static parts, do all the mounting required for these parts.
-   *
-   * @param root - the root element
-   * @param vnode - the parent VStatic
-   * @param renderer - the renderer to use
-   * @param mount - true this is a first (mount) render as opposed to a subsequent (patch) render
+   * @param root the root element
+   * @param vnode the parent VStatic
+   * @param renderer the renderer to use
    */
   function mountStaticParts(root, vnode, renderer) {
     const {
@@ -4759,9 +4910,8 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   }
   /**
    * Mounts elements to the newly generated VStatic node
-   *
-   * @param n1 - the previous VStatic vnode
-   * @param n2 - the current VStatic vnode
+   * @param n1 the previous VStatic vnode
+   * @param n2 the current VStatic vnode
    */
   function patchStaticParts(n1, n2) {
     const {
@@ -5337,6 +5487,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * With the delimiters removed, the contents are marked dynamic so they are diffed correctly.
    *
    * This function is used for slotted VFragments to avoid the text delimiters interfering with slotting functionality.
+   * @param children
    */
   function flattenFragmentsInChildren(children) {
     const flattenedChildren = [];
@@ -5951,6 +6102,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   }
   /**
    * [f]lattening
+   * @param items
    */
   function f(items) {
     if (process.env.NODE_ENV !== 'production') {
@@ -6072,6 +6224,10 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * [ddc] - create a (deprecated) dynamic component via `<x-foo lwc:dynamic={Ctor}>`
    *
    * TODO [#3331]: remove usage of lwc:dynamic in 246
+   * @param sel
+   * @param Ctor
+   * @param data
+   * @param children
    */
   function ddc(sel, Ctor, data, children = EmptyArray) {
     if (process.env.NODE_ENV !== 'production') {
@@ -6090,6 +6246,9 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   }
   /**
    * [dc] - create a dynamic component via `<lwc:component lwc:is={Ctor}>`
+   * @param Ctor
+   * @param data
+   * @param children
    */
   function dc(Ctor, data, children = EmptyArray) {
     if (process.env.NODE_ENV !== 'production') {
@@ -6117,13 +6276,13 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * to the engine that a particular collection of children must be diffed using the slow
    * algo based on keys due to the nature of the list. E.g.:
    *
-   *   - slot element's children: the content of the slot has to be dynamic when in synthetic
-   *                              shadow mode because the `vnode.children` might be the slotted
-   *                              content vs default content, in which case the size and the
-   *                              keys are not matching.
-   *   - children that contain dynamic components
-   *   - children that are produced by iteration
-   *
+   * - slot element's children: the content of the slot has to be dynamic when in synthetic
+   * shadow mode because the `vnode.children` might be the slotted
+   * content vs default content, in which case the size and the
+   * keys are not matching.
+   * - children that contain dynamic components
+   * - children that are produced by iteration
+   * @param vnodes
    */
   function sc(vnodes) {
     if (process.env.NODE_ENV !== 'production') {
@@ -6147,6 +6306,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   };
   /**
    * Sets the sanitizeHtmlContentHook.
+   * @param newHookImpl
    */
   function setSanitizeHtmlContentHook(newHookImpl) {
     sanitizeHtmlContentHook = newHookImpl;
@@ -6606,6 +6766,8 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * INTERNAL: This function can only be invoked by compiled code. The compiler
    * will prevent this function from being imported by userland code.
+   * @param Ctor
+   * @param metadata
    */
   function registerComponent(
   // We typically expect a LightningElementConstructor, but technically you can call this with anything
@@ -6978,7 +7140,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
     return shadowMode;
   }
   function assertIsVM(obj) {
-    if (isNull(obj) || !isObject(obj) || !('renderRoot' in obj)) {
+    if (!isObject(obj) || isNull(obj) || !('renderRoot' in obj)) {
       throw new TypeError(`${obj} is not a VM.`);
     }
   }
@@ -7181,6 +7343,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * need to continue into its children because by attempting to disconnect the
    * custom element itself will trigger the removal of anything slotted or anything
    * defined on its shadow.
+   * @param vnodes
    */
   function recursivelyDisconnectChildren(vnodes) {
     for (let i = 0, len = vnodes.length; i < len; i += 1) {
@@ -8404,6 +8567,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   /**
    * EXPERIMENTAL: This function provides access to the component constructor, given an HTMLElement.
    * This API is subject to change or being removed.
+   * @param elm
    */
   function getComponentConstructor(elm) {
     let ctor = null;
@@ -8428,6 +8592,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * EXPERIMENTAL: This function allows you to create a reactive readonly
    * membrane around any object value. This API is subject to change or
    * being removed.
+   * @param obj
    */
   function readonly(obj) {
     if (process.env.NODE_ENV !== 'production') {
@@ -8438,7 +8603,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
     }
     return getReadOnlyProxy(obj);
   }
-  /** version: 6.2.0 */
+  /** version: 6.2.1 */
 
   /*
    * Copyright (c) 2018, salesforce.com, inc.
@@ -8448,8 +8613,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    */
   /**
    * Displays the header for a custom element.
-   *
-   * @param ce the custom element
+   * @param ce The custom element to get the header for.
    * @param componentInstance component instance associated with the custom element.
    */
   function getHeaderForCustomElement(ce, componentInstance) {
@@ -8690,7 +8854,7 @@ LWR.define('lwc/v/6_2_0', ['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.0*/
+      /*LWC compiler v6.2.1*/
     }
     for (const [propName, callback] of entries(LIFECYCLE_CALLBACKS)) {
       UpgradableConstructor.prototype[propName] = function () {
@@ -8726,7 +8890,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   };
 
   /*
-   * 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
@@ -8738,7 +8902,6 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * Example usage:
    * import { renderer, rendererFactory } from 'lwc';
    * const customRenderer = rendererFactory(renderer);
-   *
    * @param baseRenderer Either null or the base renderer imported from 'lwc'.
    */
   function rendererFactory(baseRenderer) {
@@ -8752,21 +8915,40 @@ LWR.define('lwc/v/6_2_0', ['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
        */
+      /**
+       *
+       * @param value
+       * @param msg
+       */
       function invariant(value, msg) {
         if (!value) {
           throw new Error(`Invariant Violation: ${msg}`);
         }
       }
+      /**
+       *
+       * @param value
+       * @param msg
+       */
       function isTrue$1(value, msg) {
         if (!value) {
           throw new Error(`Assert Violation: ${msg}`);
         }
       }
+      /**
+       *
+       * @param value
+       * @param msg
+       */
       function isFalse$1(value, msg) {
         if (value) {
           throw new Error(`Assert Violation: ${msg}`);
         }
       }
+      /**
+       *
+       * @param msg
+       */
       function fail(msg) {
         throw new Error(msg);
       }
@@ -8777,13 +8959,23 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
         isFalse: isFalse$1,
         isTrue: isTrue$1
       });
+      /**
+       * Determines whether the argument is `undefined`.
+       * @param obj Value to test
+       * @returns `true` if the value is `undefined`.
+       */
       function isUndefined(obj) {
         return obj === undefined;
       }
+      /**
+       * Determines whether the argument is `null`.
+       * @param obj Value to test
+       * @returns `true` if the value is `null`.
+       */
       function isNull(obj) {
         return obj === null;
       }
-      /** version: 6.2.0 */
+      /** version: 6.2.1 */
 
       /*
        * Copyright (c) 2023, salesforce.com, inc.
@@ -8803,7 +8995,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
           this.setNewContext = setNewContext;
           this.setDisconnectedCallback = setDisconnectedCallback;
         }
-        /*LWC compiler v6.2.0*/
+        /*LWC compiler v6.2.1*/
       }
       function registerContextConsumer(elm, adapterContextToken, subscriptionPayload) {
         dispatchEvent(elm, new WireContextSubscriptionEvent(adapterContextToken, subscriptionPayload));
@@ -9107,9 +9299,7 @@ LWR.define('lwc/v/6_2_0', ['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.
-   *
-   * @deprecated since version 1.3.11
-   *
+   * @param Ctor
    * @example
    * ```
    * import { buildCustomElementConstructor } from 'lwc';
@@ -9118,6 +9308,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
    * customElements.define('x-foo', WC);
    * const elm = document.createElement('x-foo');
    * ```
+   * @deprecated since version 1.3.11
    */
   function deprecatedBuildCustomElementConstructor(Ctor) {
     if (process.env.NODE_ENV !== 'production') {
@@ -9183,7 +9374,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
       attributeChangedCallback(name, oldValue, newValue) {
         attributeChangedCallback.call(this, name, oldValue, newValue);
       }
-      /*LWC compiler v6.2.0*/
+      /*LWC compiler v6.2.1*/
     }, _a.observedAttributes = observedAttributes, _a;
   }
 
@@ -9244,17 +9435,24 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
       }
     });
   }
+  // For some reason, JSDOC says "options.is" is a syntax error. And we can't disable the rule using
+  // `eslint-disable-next-line` because that gets included in the JSDOC, so we need this workaround.
+  /* eslint-disable jsdoc/valid-types */
   /**
    * EXPERIMENTAL: This function is almost identical to document.createElement with the slightly
    * 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
    * @example
    * ```
    * const el = createElement('x-foo', { is: FooCtor });
    * ```
    */
+  /* eslint-enable jsdoc/valid-types */
   function createElement(sel, options) {
     if (!isObject(options) || isNull(options)) {
       throw new TypeError(`"createElement" function expects an object as second parameter but received "${toString$1(options)}".`);
@@ -9280,6 +9478,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
      * 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, {
@@ -9310,6 +9509,7 @@ LWR.define('lwc/v/6_2_0', ['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
    */
   function isNodeShadowed(node) {
     if (isFalse(node instanceof _Node)) {
@@ -9351,12 +9551,11 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
   }
   /**
    * This static getter 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. E.g.:
-   *
-   *      import Foo from 'ns/foo';
-   *      customElements.define('x-foo', Foo.CustomElementConstructor);
-   *      const elm = document.createElement('x-foo');
-   *
+   * as a new element via customElements.define() at any given time.
+   * @example
+   * import Foo from 'ns/foo';
+   * customElements.define('x-foo', Foo.CustomElementConstructor);
+   * const elm = document.createElement('x-foo');
    */
   defineProperty(LightningElement, 'CustomElementConstructor', {
     get() {
@@ -9398,7 +9597,7 @@ LWR.define('lwc/v/6_2_0', ['exports'], (function (exports) { 'use strict';
       });
     });
   }
-  /** version: 6.2.0 */
+  /** version: 6.2.1 */
 
   exports.LightningElement = LightningElement;
   exports.__unstable__ProfilerControl = profilerControl;