@lwc/engine-core 6.2.0 → 6.2.1

package/dist/index.js

@@ -23,8 +23,7 @@ let enabled$1 = false;
 const reportingControl = {
     /**
      * Attach a new reporting control (aka dispatcher).
-     *
-     * @param dispatcher - reporting control
+     * @param dispatcher reporting control
      */
     attachDispatcher(dispatcher) {
         enabled$1 = true;
@@ -67,7 +66,7 @@ function onReportingEnabled(callback) {
 /**
  * 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) {
@@ -1430,6 +1429,7 @@ const reactiveMembrane = new ObservableMembrane({
  * 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.
@@ -1543,6 +1543,8 @@ function applyShadowMigrateMode(shadowRoot) {
  * 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 { get, set, enumerable, configurable } = descriptor;
@@ -1592,7 +1594,7 @@ const refsCache = new WeakMap();
 /**
  * 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
@@ -2461,9 +2463,11 @@ function internalTrackDecorator(key) {
  * 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') {
@@ -2574,6 +2578,8 @@ function validateMethodDecoratedWithApi(Ctor, methodName, descriptor) {
 /**
  * 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;
@@ -2762,6 +2768,7 @@ function isTemplateRegistered(tpl) {
 /**
  * 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') {
@@ -2775,6 +2782,10 @@ function registerTemplate(tpl) {
 /**
  * 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
@@ -3360,6 +3371,7 @@ function createComponentDef(Ctor) {
 /**
  * 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)) {
@@ -3433,6 +3445,7 @@ const lightingElementDef = {
 /**
  * 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);
@@ -3629,6 +3642,8 @@ function getNearestShadowComponent(vm) {
  * 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) {
@@ -3642,6 +3657,7 @@ function getScopeTokenClass(owner, legacy) {
  * 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 { template } = getComponentInternalDef(vnode.ctor);
@@ -4050,11 +4066,9 @@ function traverseAndSetElements(root, parts, renderer) {
 }
 /**
  * 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) {
     // On the server, we don't support ref (because it relies on renderedCallback), nor do we
@@ -4079,9 +4093,8 @@ function mountStaticParts(root, vnode, renderer) {
 }
 /**
  * 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) {
     // On the server, we don't support ref (because it relies on renderedCallback), nor do we
@@ -4596,6 +4609,7 @@ function allocateChildren(vnode, vm) {
  * 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 = [];
@@ -5209,6 +5223,7 @@ function i(iterable, factory) {
 }
 /**
  * [f]lattening
+ * @param items
  */
 function f(items) {
     if (process.env.NODE_ENV !== 'production') {
@@ -5325,6 +5340,10 @@ function fid(url) {
  * [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') {
@@ -5343,6 +5362,9 @@ function ddc(sel, Ctor, data, children = EmptyArray) {
 }
 /**
  * [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') {
@@ -5370,13 +5392,13 @@ function dc(Ctor, data, children = EmptyArray) {
  * 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') {
@@ -5400,6 +5422,7 @@ let sanitizeHtmlContentHook = () => {
 };
 /**
  * Sets the sanitizeHtmlContentHook.
+ * @param newHookImpl
  */
 function setSanitizeHtmlContentHook(newHookImpl) {
     sanitizeHtmlContentHook = newHookImpl;
@@ -5841,6 +5864,8 @@ const registeredComponentMap = new Map();
 /**
  * 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
@@ -6198,7 +6223,7 @@ function computeShadowMode(def, owner, renderer, hydrated) {
     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.`);
     }
 }
@@ -6391,6 +6416,7 @@ function runLightChildNodesDisconnectedCallback(vm) {
  * 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) {
@@ -7546,6 +7572,7 @@ function freezeTemplate(tmpl) {
 /**
  * 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;
@@ -7570,6 +7597,7 @@ function getComponentConstructor(elm) {
  * 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') {
@@ -7582,5 +7610,5 @@ function readonly(obj) {
 }
 
 export { LightningElement, profilerControl as __unstable__ProfilerControl, reportingControl as __unstable__ReportingControl, api$1 as api, computeShadowAndRenderMode, connectRootElement, createContextProviderWithRegister, createVM, disconnectRootElement, freezeTemplate, getAssociatedVMIfPresent, getComponentAPIVersion, getComponentConstructor, getComponentDef, getComponentHtmlPrototype, hydrateRoot, isComponentConstructor, parseFragment, parseSVGFragment, readonly, registerComponent, registerDecorators, registerTemplate, runFormAssociatedCallback, runFormDisabledCallback, runFormResetCallback, runFormStateRestoreCallback, sanitizeAttribute, setHooks, swapComponent, swapStyle, swapTemplate, track, unwrap, wire };
-/** version: 6.2.0 */
+/** version: 6.2.1 */
 //# sourceMappingURL=index.js.map