@lwc/engine-core 8.1.2 → 8.2.0

package/dist/framework/main.d.ts

@@ -20,7 +20,7 @@ export { getComponentConstructor } from './get-component-constructor';
 export type { RendererAPI, LifecycleCallback } from './renderer';
 export type { Stylesheets } from './stylesheet';
 export type { Template } from './template';
-export type { ConfigValue as WireConfigValue, ContextConsumer as WireContextConsumer, ContextProvider as WireContextProvider, ContextValue as WireContextValue, DataCallback, WireAdapter, WireAdapterConstructor, WireAdapterSchemaValue, WireContextSubscriptionPayload, WireContextSubscriptionCallback, } from './wiring';
+export type { ConfigValue as WireConfigValue, ContextConsumer as WireContextConsumer, ContextProvider as WireContextProvider, ContextValue as WireContextValue, DataCallback as WireDataCallback, WireAdapter, WireAdapterConstructor, WireAdapterSchemaValue, WireContextSubscriptionPayload, WireContextSubscriptionCallback, } from './wiring';
 export type { FormRestoreState, FormRestoreReason } from './vm';
 export { LightningElement } from './base-lightning-element';
 export { default as api } from './decorators/api';

package/dist/framework/utils.d.ts

@@ -6,9 +6,6 @@ export declare const EmptyObject: any;
 export declare const EmptyArray: never[];
 export declare function addCallbackToNextTick(callback: Callback): void;
 export declare function guid(): string;
-export declare function parseStyleText(cssText: string): {
-    [name: string]: string;
-};
 export declare function cloneAndOmitKey(object: {
     [key: string]: any;
 }, keyToOmit: string): {

package/dist/index.cjs.js

@@ -221,23 +221,6 @@ function guid() {
     }
     return s4() + s4() + '-' + s4() + '-' + s4() + '-' + s4() + '-' + s4() + s4() + s4();
 }
-// Borrowed from Vue template compiler.
-// https://github.com/vuejs/vue/blob/531371b818b0e31a989a06df43789728f23dc4e8/src/platforms/web/util/style.js#L5-L16
-const DECLARATION_DELIMITER = /;(?![^(]*\))/g;
-const PROPERTY_DELIMITER = /:(.+)/;
-function parseStyleText(cssText) {
-    const styleMap = {};
-    const declarations = cssText.split(DECLARATION_DELIMITER);
-    for (const declaration of declarations) {
-        if (declaration) {
-            const [prop, value] = declaration.split(PROPERTY_DELIMITER);
-            if (prop !== undefined && value !== undefined) {
-                styleMap[prop.trim()] = value.trim();
-            }
-        }
-    }
-    return styleMap;
-}
 // Make a shallow copy of an object but omit the given key
 function cloneAndOmitKey(object, keyToOmit) {
     const result = {};
@@ -3937,6 +3920,12 @@ function isVStaticPartText(vnode) {
     return vnode.type === 0 /* VStaticPartType.Text */;
 }
 
+/*
+ * 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 sanitizedHtmlContentSymbol = Symbol('lwc-get-sanitized-html-content');
 function isSanitizedHtmlContent(object) {
     return shared.isObject(object) && !shared.isNull(object) && sanitizedHtmlContentSymbol in object;
@@ -7658,31 +7647,41 @@ function textNodeContentsAreEqual(node, vnode, renderer) {
 // Any attribute names specified in that array will not be validated, and the
 // LWC runtime will assume that VDOM attrs and DOM attrs are in sync.
 function getValidationPredicate(elm, renderer, optOutStaticProp) {
-    // `data-lwc-host-mutated` is a special attribute added by the SSR engine itself,
-    // which does the same thing as an explicit `static validationOptOut = ['attr1', 'attr2']`.
+    // `data-lwc-host-mutated` is a special attribute added by the SSR engine itself, which automatically detects
+    // host mutations during `connectedCallback`.
     const hostMutatedValue = renderer.getAttribute(elm, 'data-lwc-host-mutated');
-    if (shared.isString(hostMutatedValue)) {
-        const mutatedAttrValues = new Set(shared.StringSplit.call(hostMutatedValue, / /));
-        return (attrName) => !mutatedAttrValues.has(attrName);
-    }
-    if (shared.isUndefined(optOutStaticProp)) {
-        return (_attrName) => true;
-    }
+    const detectedHostMutations = shared.isString(hostMutatedValue)
+        ? new Set(shared.StringSplit.call(hostMutatedValue, / /))
+        : undefined;
     // If validationOptOut is true, no attributes will be checked for correctness
     // and the runtime will assume VDOM attrs and DOM attrs are in sync.
-    if (shared.isTrue(optOutStaticProp)) {
-        return (_attrName) => false;
-    }
-    // If validationOptOut is an array of strings, attributes specified in the
-    // array will be "opted out". Attributes not specified in the array will still
-    // be validated.
-    if (shared.isArray(optOutStaticProp) && shared.arrayEvery(optOutStaticProp, shared.isString)) {
-        return (attrName) => !shared.ArrayIncludes.call(optOutStaticProp, attrName);
-    }
-    if (process.env.NODE_ENV !== 'production') {
-        logWarn('Validation opt out must be `true` or an array of attributes that should not be validated.');
-    }
-    return (_attrName) => true;
+    const fullOptOut = shared.isTrue(optOutStaticProp);
+    // If validationOptOut is an array of strings, attributes specified in the array will be "opted out". Attributes
+    // not specified in the array will still be validated.
+    const isValidArray = shared.isArray(optOutStaticProp) && shared.arrayEvery(optOutStaticProp, shared.isString);
+    const conditionalOptOut = isValidArray ? new Set(optOutStaticProp) : undefined;
+    if (process.env.NODE_ENV !== 'production' &&
+        !shared.isUndefined(optOutStaticProp) &&
+        !shared.isTrue(optOutStaticProp) &&
+        !isValidArray) {
+        logWarn('`validationOptOut` must be `true` or an array of attributes that should not be validated.');
+    }
+    return (attrName) => {
+        // Component wants to opt out of all validation
+        if (fullOptOut) {
+            return false;
+        }
+        // Mutations were automatically detected and should be ignored
+        if (!shared.isUndefined(detectedHostMutations) && detectedHostMutations.has(attrName)) {
+            return false;
+        }
+        // Component explicitly wants to opt out of certain validations, regardless of auto-detection
+        if (!shared.isUndefined(conditionalOptOut) && conditionalOptOut.has(attrName)) {
+            return false;
+        }
+        // Attribute must be validated
+        return true;
+    };
 }
 function hydrateText(node, vnode, renderer) {
     if (!hasCorrectNodeType(vnode, node, 3 /* EnvNodeTypes.TEXT */, renderer)) {
@@ -8046,12 +8045,12 @@ function validateStyleAttr(vnode, elm, data, renderer) {
         vnodeStyle = style;
     }
     else if (!shared.isUndefined(styleDecls)) {
-        const parsedVnodeStyle = parseStyleText(elmStyle);
+        const parsedVnodeStyle = shared.parseStyleText(elmStyle);
         const expectedStyle = [];
         // styleMap is used when style is set to static value.
         for (let i = 0, n = styleDecls.length; i < n; i++) {
             const [prop, value, important] = styleDecls[i];
-            expectedStyle.push(`${prop}: ${value + (important ? ' important!' : '')}`);
+            expectedStyle.push(`${prop}: ${value + (important ? ' !important' : '')};`);
             const parsedPropValue = parsedVnodeStyle[prop];
             if (shared.isUndefined(parsedPropValue)) {
                 nodesAreCompatible = false;
@@ -8066,7 +8065,7 @@ function validateStyleAttr(vnode, elm, data, renderer) {
         if (shared.keys(parsedVnodeStyle).length > styleDecls.length) {
             nodesAreCompatible = false;
         }
-        vnodeStyle = shared.ArrayJoin.call(expectedStyle, ';');
+        vnodeStyle = shared.ArrayJoin.call(expectedStyle, ' ');
     }
     if (!nodesAreCompatible) {
         if (process.env.NODE_ENV !== 'production') {
@@ -8478,5 +8477,5 @@ exports.swapTemplate = swapTemplate;
 exports.track = track;
 exports.unwrap = unwrap;
 exports.wire = wire;
-/** version: 8.1.2 */
+/** version: 8.2.0 */
 //# sourceMappingURL=index.cjs.js.map