@lwc/engine-core 6.0.0 → 6.1.1

package/dist/index.js

@@ -1,7 +1,7 @@
 /**
- * Copyright (C) 2023 salesforce.com, inc.
+ * Copyright (c) 2024 Salesforce, Inc.
  */
-import { noop, StringToLowerCase, isNull, ArrayPush as ArrayPush$1, ArrayJoin, isFrozen, isUndefined as isUndefined$1, defineProperty, ArrayIndexOf, ArraySplice, create, seal, isAPIFeatureEnabled, isArray as isArray$1, isFunction as isFunction$1, keys, hasOwnProperty as hasOwnProperty$1, globalThis as globalThis$1, entries, AriaPropNameToAttrNameMap, getPropertyDescriptor, forEach, defineProperties, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, assign, freeze, isObject, KEY__SYNTHETIC_MODE, isString, assert, toString as toString$1, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, isFalse, LWC_VERSION_COMMENT_REGEX, LWC_VERSION, getOwnPropertyNames as getOwnPropertyNames$1, getOwnPropertyDescriptors, htmlPropertyToAttribute, ArraySlice, ArrayMap, KEY__SCOPED_CSS, kebabCaseToCamelCase, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, StringSlice, ArrayShift, ArrayUnshift, isTrue, SVG_NAMESPACE, KEY__SHADOW_STATIC, KEY__SHADOW_RESOLVER, ArraySome, ArrayPop, isNumber, StringReplace, LOWEST_API_VERSION, KEY__NATIVE_GET_ELEMENT_BY_ID, KEY__NATIVE_QUERY_SELECTOR_ALL, ID_REFERENCING_ATTRIBUTES_SET, KEY__SHADOW_TOKEN, ArrayFilter, StringSplit, arrayEvery, ArrayIncludes, ArrayCopyWithin, ArrayFill, ArraySort, ArrayReverse } from '@lwc/shared';
+import { noop, StringToLowerCase, isNull, ArrayPush as ArrayPush$1, ArrayJoin, isFrozen, isUndefined as isUndefined$1, defineProperty, ArrayIndexOf, ArraySplice, create, seal, isAPIFeatureEnabled, isArray as isArray$1, isFunction as isFunction$1, keys, hasOwnProperty as hasOwnProperty$1, entries, AriaPropNameToAttrNameMap, getPropertyDescriptor, forEach, defineProperties, getPrototypeOf as getPrototypeOf$1, setPrototypeOf, assign, freeze, isObject, KEY__SYNTHETIC_MODE, isString, assert, toString as toString$1, getOwnPropertyDescriptor as getOwnPropertyDescriptor$1, isFalse, LWC_VERSION_COMMENT_REGEX, LWC_VERSION, getOwnPropertyNames as getOwnPropertyNames$1, getOwnPropertyDescriptors, htmlPropertyToAttribute, ArraySlice, ArrayMap, KEY__SCOPED_CSS, kebabCaseToCamelCase, StringCharCodeAt, XML_NAMESPACE, XLINK_NAMESPACE, StringSlice, ArrayShift, ArrayUnshift, isTrue, SVG_NAMESPACE, KEY__SHADOW_STATIC, KEY__SHADOW_RESOLVER, ArraySome, ArrayPop, isNumber, StringReplace, LOWEST_API_VERSION, KEY__NATIVE_GET_ELEMENT_BY_ID, KEY__NATIVE_QUERY_SELECTOR_ALL, ID_REFERENCING_ATTRIBUTES_SET, KEY__SHADOW_TOKEN, ArrayFilter, StringSplit, arrayEvery, ArrayIncludes, ArrayCopyWithin, ArrayFill, ArraySort, ArrayReverse } from '@lwc/shared';
 export { setFeatureFlag, setFeatureFlagForTest } from '@lwc/features';
 
 /*
@@ -409,6 +409,25 @@ function assertNotProd() {
         throw new ReferenceError();
     }
 }
+// Temporary fix for when the LWC v5 compiler is used in conjunction with a v6+ engine
+// The old compiler format used the "slot" attribute in the `data` bag, whereas the new
+// format uses the special `slotAssignment` key.
+// This should be removed when the LWC v5 compiler is not used anywhere where it could be mismatched
+// with another LWC engine version.
+// TODO [#3974]: remove temporary logic to support v5 compiler + v6+ engine
+function applyTemporaryCompilerV5SlotFix(data) {
+    if (lwcRuntimeFlags.DISABLE_TEMPORARY_V5_COMPILER_SUPPORT) {
+        return data;
+    }
+    const { attrs } = data;
+    if (!isUndefined$1(attrs)) {
+        const { slot } = attrs;
+        if (!isUndefined$1(slot) && !isNull(slot)) {
+            return Object.assign(Object.assign({}, data), { attrs: cloneAndOmitKey(attrs, 'slot'), slotAssignment: String(slot) });
+        }
+    }
+    return data;
+}
 
 /*
  * Copyright (c) 2020, salesforce.com, inc.
@@ -425,8 +444,8 @@ function isCircularModuleDependency(obj) {
 }
 
 var _a, _b;
-const instrumentDef = (_a = globalThis$1.__lwc_instrument_cmp_def) !== null && _a !== void 0 ? _a : noop;
-const instrumentInstance = (_b = globalThis$1.__lwc_instrument_cmp_instance) !== null && _b !== void 0 ? _b : noop;
+const instrumentDef = (_a = globalThis.__lwc_instrument_cmp_def) !== null && _a !== void 0 ? _a : noop;
+const instrumentInstance = (_b = globalThis.__lwc_instrument_cmp_instance) !== null && _b !== void 0 ? _b : noop;
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -3148,6 +3167,10 @@ function createComponentDef(Ctor) {
             ctorShadowSupportMode !== "native" /* ShadowSupportMode.Native */) {
             logError(`Invalid value for static property shadowSupportMode: '${ctorShadowSupportMode}'`);
         }
+        // TODO [#3971]: Completely remove shadowSupportMode "any"
+        if (ctorShadowSupportMode === "any" /* ShadowSupportMode.Any */) {
+            logWarn(`Invalid value 'any' for static property shadowSupportMode. 'any' is deprecated and will be removed in a future release--use 'native' instead.`);
+        }
         if (!isUndefined$1(ctorRenderMode) &&
             ctorRenderMode !== 'light' &&
             ctorRenderMode !== 'shadow') {
@@ -4816,6 +4839,8 @@ function h(sel, data, children = EmptyArray) {
             }
         });
     }
+    // TODO [#3974]: remove temporary logic to support v5 compiler + v6+ engine
+    data = applyTemporaryCompilerV5SlotFix(data);
     const { key, slotAssignment } = data;
     const vnode = {
         type: 2 /* VNodeType.Element */,
@@ -4852,6 +4877,8 @@ function s(slotName, data, children, slotset) {
     }
     const vmBeingRendered = getVMBeingRendered();
     const { renderMode, apiVersion } = vmBeingRendered;
+    // TODO [#3974]: remove temporary logic to support v5 compiler + v6+ engine
+    data = applyTemporaryCompilerV5SlotFix(data);
     if (!isUndefined$1(slotset) &&
         !isUndefined$1(slotset.slotAssignments) &&
         !isUndefined$1(slotset.slotAssignments[slotName]) &&
@@ -4955,6 +4982,8 @@ function c(sel, Ctor, data, children = EmptyArray) {
             });
         }
     }
+    // TODO [#3974]: remove temporary logic to support v5 compiler + v6+ engine
+    data = applyTemporaryCompilerV5SlotFix(data);
     const { key, slotAssignment } = data;
     let elm, aChildren, vm;
     const vnode = {
@@ -5479,7 +5508,6 @@ const parseSVGFragment = buildParseFragmentFn((html, renderer) => {
 });
 function evaluateTemplate(vm, html) {
     if (process.env.NODE_ENV !== 'production') {
-        assert.isTrue(isFunction$1(html), `evaluateTemplate() second argument must be an imported template instead of ${toString$1(html)}`);
         // in dev-mode, we support hot swapping of templates, which means that
         // the component instance might be attempting to use an old version of
         // the template, while internally, we have a replacement for it.
@@ -5498,6 +5526,10 @@ function evaluateTemplate(vm, html) {
         tro.observe(() => {
             // Reset the cache memoizer for template when needed.
             if (html !== cmpTemplate) {
+                // Check that the template was built by the compiler.
+                if (!isTemplateRegistered(html)) {
+                    throw new TypeError(`Invalid template returned by the render() method on ${vm.tagName}. It must return an imported template (e.g.: \`import html from "./${vm.def.name}.html"\`), instead, it has returned: ${toString$1(html)}.`);
+                }
                 if (process.env.NODE_ENV !== 'production') {
                     validateLightDomTemplate(html, vm);
                 }
@@ -5509,10 +5541,6 @@ function evaluateTemplate(vm, html) {
                     // and snabbdom just rely on the IDs.
                     resetComponentRoot(vm);
                 }
-                // Check that the template was built by the compiler.
-                if (!isTemplateRegistered(html)) {
-                    throw new TypeError(`Invalid template returned by the render() method on ${vm}. It must return an imported template (e.g.: \`import html from "./${vm.def.name}.html"\`), instead, it has returned: ${toString$1(html)}.`);
-                }
                 vm.cmpTemplate = html;
                 // Create a brand new template cache for the swapped templated.
                 context.tplCache = create(null);
@@ -5887,7 +5915,7 @@ function createVM(elm, ctor, renderer, options) {
         vm.debugInfo = create(null);
     }
     vm.stylesheets = computeStylesheets(vm, def.ctor);
-    const computedShadowMode = computeShadowMode(def, vm.owner, renderer);
+    const computedShadowMode = computeShadowMode(def, vm.owner, renderer, hydrated);
     if (lwcRuntimeFlags.ENABLE_FORCE_SHADOW_MIGRATE_MODE) {
         vm.shadowMode = 0 /* ShadowMode.Native */;
         vm.shadowMigrateMode = computedShadowMode === 1 /* ShadowMode.Synthetic */;
@@ -5974,48 +6002,45 @@ function computeShadowAndRenderMode(Ctor, renderer) {
     const def = getComponentInternalDef(Ctor);
     const { renderMode } = def;
     // Assume null `owner` - this is what happens in hydration cases anyway
-    const shadowMode = computeShadowMode(def, /* owner */ null, renderer);
+    // Also assume we are not in hydration mode for this exported API
+    const shadowMode = computeShadowMode(def, /* owner */ null, renderer, false);
     return { renderMode, shadowMode };
 }
-function computeShadowMode(def, owner, renderer) {
+function computeShadowMode(def, owner, renderer, hydrated) {
     // Force the shadow mode to always be native. Used for running tests with synthetic shadow patches
     // on, but components running in actual native shadow mode
     if (process.env.NODE_ENV !== 'production' &&
         lwcRuntimeFlags.ENABLE_FORCE_NATIVE_SHADOW_MODE_FOR_TEST) {
         return 0 /* ShadowMode.Native */;
     }
+    if (isTrue(hydrated)) {
+        // hydration only supports native shadow
+        return 0 /* ShadowMode.Native */;
+    }
     const { isSyntheticShadowDefined } = renderer;
     let shadowMode;
-    // If ENABLE_FORCE_SHADOW_MIGRATE_MODE is true, then ShadowMode.Synthetic here will mean "force-migrate" mode.
     if (isSyntheticShadowDefined || lwcRuntimeFlags.ENABLE_FORCE_SHADOW_MIGRATE_MODE) {
         if (def.renderMode === 0 /* RenderMode.Light */) {
             // ShadowMode.Native implies "not synthetic shadow" which is consistent with how
             // everything defaults to native when the synthetic shadow polyfill is unavailable.
             shadowMode = 0 /* ShadowMode.Native */;
         }
-        else if (lwcRuntimeFlags.ENABLE_MIXED_SHADOW_MODE ||
-            def.shadowSupportMode === "native" /* ShadowSupportMode.Native */) {
-            if (def.shadowSupportMode === "any" /* ShadowSupportMode.Any */ ||
-                def.shadowSupportMode === "native" /* ShadowSupportMode.Native */) {
+        else if (def.shadowSupportMode === "native" /* ShadowSupportMode.Native */) {
+            shadowMode = 0 /* ShadowMode.Native */;
+        }
+        else {
+            const shadowAncestor = getNearestShadowAncestor(owner);
+            if (!isNull(shadowAncestor) && shadowAncestor.shadowMode === 0 /* ShadowMode.Native */) {
+                // Transitive support for native Shadow DOM. A component in native mode
+                // transitively opts all of its descendants into native.
                 shadowMode = 0 /* ShadowMode.Native */;
             }
             else {
-                const shadowAncestor = getNearestShadowAncestor(owner);
-                if (!isNull(shadowAncestor) && shadowAncestor.shadowMode === 0 /* ShadowMode.Native */) {
-                    // Transitive support for native Shadow DOM. A component in native mode
-                    // transitively opts all of its descendants into native.
-                    shadowMode = 0 /* ShadowMode.Native */;
-                }
-                else {
-                    // Synthetic if neither this component nor any of its ancestors are configured
-                    // to be native.
-                    shadowMode = 1 /* ShadowMode.Synthetic */;
-                }
+                // Synthetic if neither this component nor any of its ancestors are configured
+                // to be native.
+                shadowMode = 1 /* ShadowMode.Synthetic */;
             }
         }
-        else {
-            shadowMode = 1 /* ShadowMode.Synthetic */;
-        }
     }
     else {
         // Native if the synthetic shadow polyfill is unavailable.
@@ -6390,12 +6415,12 @@ function resetRefVNodes(vm) {
 // See: https://sfdc.co/synthetic-aria
 //
 // Use the unpatched native getElementById/querySelectorAll rather than the synthetic one
-const getElementById = globalThis$1[KEY__NATIVE_GET_ELEMENT_BY_ID];
-const querySelectorAll = globalThis$1[KEY__NATIVE_QUERY_SELECTOR_ALL];
+const getElementById = globalThis[KEY__NATIVE_GET_ELEMENT_BY_ID];
+const querySelectorAll = globalThis[KEY__NATIVE_QUERY_SELECTOR_ALL];
 // This is a "handoff" from synthetic-shadow to engine-core – we want to clean up after ourselves
 // so nobody else can misuse these global APIs.
-delete globalThis$1[KEY__NATIVE_GET_ELEMENT_BY_ID];
-delete globalThis$1[KEY__NATIVE_QUERY_SELECTOR_ALL];
+delete globalThis[KEY__NATIVE_GET_ELEMENT_BY_ID];
+delete globalThis[KEY__NATIVE_QUERY_SELECTOR_ALL];
 function isSyntheticShadowRootInstance(rootNode) {
     return rootNode !== document && isTrue(rootNode.synthetic);
 }
@@ -7404,5 +7429,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.0.0 */
+/** version: 6.1.1 */
 //# sourceMappingURL=index.js.map