@lwc/ssr-runtime 8.12.3 → 8.12.4

package/LICENSE.md

@@ -2,7 +2,7 @@
 
 MIT LICENSE
 
-Copyright (c) 2024, Salesforce, Inc.
+Copyright (c) 2025, Salesforce, Inc.
 All rights reserved.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

package/dist/index.cjs.js

@@ -631,7 +631,7 @@ function setHooks(hooks) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const DEFAULT_SSR_MODE = 'sync';
-/** version: 8.12.3 */
+/** version: 8.12.4 */
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -1218,24 +1218,6 @@ const mutationTracker = new MutationTracker();
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-/**
- * Filters out the following types of properties that should not be set.
- * - Properties that are not public.
- * - Properties that are not global.
- * - Properties that are global but are internally overridden.
- */
-function filterProperties(props, publicFields, privateFields) {
-    const propsToAssign = create(null);
-    for (const propName of keys(props)) {
-        const attrName = htmlPropertyToAttribute(propName);
-        if (publicFields.has(propName) ||
-            ((REFLECTIVE_GLOBAL_PROPERTY_SET.has(propName) || isAriaAttribute(attrName)) &&
-                !privateFields.has(propName))) {
-            propsToAssign[propName] = props[propName];
-        }
-    }
-    return propsToAssign;
-}
 /**
  * Descriptor for IDL attribute reflections that merely reflect the string, e.g. `title`.
  */
@@ -1371,10 +1353,21 @@ class LightningElement {
         _LightningElement_classList.set(this, null);
         assign(this, propsAvailableAtConstruction);
     }
-    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), SYMBOL__SET_INTERNALS)](props, attrs) {
+    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), SYMBOL__SET_INTERNALS)](props, attrs, publicFields, privateFields) {
         __classPrivateFieldSet(this, _LightningElement_props, props, "f");
         __classPrivateFieldSet(this, _LightningElement_attrs, attrs, "f");
-        assign(this, props);
+        // Avoid setting the following types of properties that should not be set:
+        // - Properties that are not public.
+        // - Properties that are not global.
+        // - Properties that are global but are internally overridden.
+        for (const propName of keys(props)) {
+            const attrName = htmlPropertyToAttribute(propName);
+            if (publicFields.has(propName) ||
+                ((REFLECTIVE_GLOBAL_PROPERTY_SET.has(propName) || isAriaAttribute(attrName)) &&
+                    !privateFields.has(propName))) {
+                this[propName] = props[propName];
+            }
+        }
     }
     get className() {
         return __classPrivateFieldGet(this, _LightningElement_props, "f").class ?? '';
@@ -1591,14 +1584,27 @@ async function serverSideRenderComponent(tagName, Component, props = {}, mode =
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 /**
- * Given an object, render it for use as a text content node.
+ * Given an object, render it for use as a text content node. Not that this applies to individual text nodes,
+ * not the concatenated result of multiple adjacent text nodes.
  * @param value
  */
-function massageTextContent(value) {
+function normalizeTextContent(value) {
     // Using non strict equality to align with original implementation (ex. undefined == null)
     // See: https://github.com/salesforce/lwc/blob/348130f/packages/%40lwc/engine-core/src/framework/api.ts#L548
     return value == null ? '' : String(value);
 }
+/**
+ * Given a string, render it for use as text content in HTML. Notably this escapes HTML and renders as
+ * a ZWJ is empty. Intended to be used on the result of concatenating multiple adjacent text nodes together.
+ * @param value
+ */
+function renderTextContent(value) {
+    // We are at the end of a series of text nodes - flush to a concatenated string
+    // We only render the ZWJ if there were actually any dynamic text nodes rendered
+    // The ZWJ is just so hydration can compare the SSR'd dynamic text content against
+    // the CSR'd text content.
+    return value === '' ? '\u200D' : htmlEscape(value);
+}
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -1798,7 +1804,6 @@ exports.createElement = createElement;
 exports.establishContextfulRelationship = establishContextfulRelationship;
 exports.fallbackTmpl = fallbackTmpl;
 exports.fallbackTmplNoYield = fallbackTmplNoYield;
-exports.filterProperties = filterProperties;
 exports.freezeTemplate = freezeTemplate;
 exports.getComponentDef = getComponentDef;
 exports.getReadOnlyProxy = getReadOnlyProxy;
@@ -1806,9 +1811,9 @@ exports.hasScopedStaticStylesheets = hasScopedStaticStylesheets;
 exports.hot = hot;
 exports.htmlEscape = htmlEscape;
 exports.isComponentConstructor = isComponentConstructor;
-exports.massageTextContent = massageTextContent;
 exports.mutationTracker = mutationTracker;
 exports.normalizeClass = normalizeClass;
+exports.normalizeTextContent = normalizeTextContent;
 exports.parseFragment = parseFragment;
 exports.parseSVGFragment = parseSVGFragment;
 exports.readonly = readonly;
@@ -1819,6 +1824,7 @@ exports.renderAttrs = renderAttrs;
 exports.renderAttrsNoYield = renderAttrsNoYield;
 exports.renderComponent = serverSideRenderComponent;
 exports.renderStylesheets = renderStylesheets;
+exports.renderTextContent = renderTextContent;
 exports.renderer = renderer;
 exports.sanitizeAttribute = sanitizeAttribute;
 exports.serverSideRenderComponent = serverSideRenderComponent;
@@ -1833,5 +1839,5 @@ exports.track = track;
 exports.unwrap = unwrap$1;
 exports.validateStyleTextContents = validateStyleTextContents;
 exports.wire = wire;
-/** version: 8.12.3 */
+/** version: 8.12.4 */
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.d.ts

@@ -4,9 +4,8 @@ export { ClassList } from './class-list';
 export { getReadOnlyProxy } from './get-read-only-proxy';
 export { LightningElement, LightningElementConstructor, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, } from './lightning-element';
 export { mutationTracker } from './mutation-tracker';
-export { filterProperties } from './reflection';
 export { fallbackTmpl, fallbackTmplNoYield, GenerateMarkupFn, renderAttrs, renderAttrsNoYield, serverSideRenderComponent, serverSideRenderComponent as renderComponent, } from './render';
-export { massageTextContent } from './render-text-content';
+export { normalizeTextContent, renderTextContent } from './render-text-content';
 export { hasScopedStaticStylesheets, renderStylesheets } from './styles';
 export { toIteratorDirective } from './to-iterator-directive';
 export { validateStyleTextContents } from './validate-style-text-contents';

package/dist/index.js

@@ -627,7 +627,7 @@ function setHooks(hooks) {
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 const DEFAULT_SSR_MODE = 'sync';
-/** version: 8.12.3 */
+/** version: 8.12.4 */
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -1214,24 +1214,6 @@ const mutationTracker = new MutationTracker();
  * SPDX-License-Identifier: MIT
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
-/**
- * Filters out the following types of properties that should not be set.
- * - Properties that are not public.
- * - Properties that are not global.
- * - Properties that are global but are internally overridden.
- */
-function filterProperties(props, publicFields, privateFields) {
-    const propsToAssign = create(null);
-    for (const propName of keys(props)) {
-        const attrName = htmlPropertyToAttribute(propName);
-        if (publicFields.has(propName) ||
-            ((REFLECTIVE_GLOBAL_PROPERTY_SET.has(propName) || isAriaAttribute(attrName)) &&
-                !privateFields.has(propName))) {
-            propsToAssign[propName] = props[propName];
-        }
-    }
-    return propsToAssign;
-}
 /**
  * Descriptor for IDL attribute reflections that merely reflect the string, e.g. `title`.
  */
@@ -1367,10 +1349,21 @@ class LightningElement {
         _LightningElement_classList.set(this, null);
         assign(this, propsAvailableAtConstruction);
     }
-    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), SYMBOL__SET_INTERNALS)](props, attrs) {
+    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), SYMBOL__SET_INTERNALS)](props, attrs, publicFields, privateFields) {
         __classPrivateFieldSet(this, _LightningElement_props, props, "f");
         __classPrivateFieldSet(this, _LightningElement_attrs, attrs, "f");
-        assign(this, props);
+        // Avoid setting the following types of properties that should not be set:
+        // - Properties that are not public.
+        // - Properties that are not global.
+        // - Properties that are global but are internally overridden.
+        for (const propName of keys(props)) {
+            const attrName = htmlPropertyToAttribute(propName);
+            if (publicFields.has(propName) ||
+                ((REFLECTIVE_GLOBAL_PROPERTY_SET.has(propName) || isAriaAttribute(attrName)) &&
+                    !privateFields.has(propName))) {
+                this[propName] = props[propName];
+            }
+        }
     }
     get className() {
         return __classPrivateFieldGet(this, _LightningElement_props, "f").class ?? '';
@@ -1587,14 +1580,27 @@ async function serverSideRenderComponent(tagName, Component, props = {}, mode =
  * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
  */
 /**
- * Given an object, render it for use as a text content node.
+ * Given an object, render it for use as a text content node. Not that this applies to individual text nodes,
+ * not the concatenated result of multiple adjacent text nodes.
  * @param value
  */
-function massageTextContent(value) {
+function normalizeTextContent(value) {
     // Using non strict equality to align with original implementation (ex. undefined == null)
     // See: https://github.com/salesforce/lwc/blob/348130f/packages/%40lwc/engine-core/src/framework/api.ts#L548
     return value == null ? '' : String(value);
 }
+/**
+ * Given a string, render it for use as text content in HTML. Notably this escapes HTML and renders as
+ * a ZWJ is empty. Intended to be used on the result of concatenating multiple adjacent text nodes together.
+ * @param value
+ */
+function renderTextContent(value) {
+    // We are at the end of a series of text nodes - flush to a concatenated string
+    // We only render the ZWJ if there were actually any dynamic text nodes rendered
+    // The ZWJ is just so hydration can compare the SSR'd dynamic text content against
+    // the CSR'd text content.
+    return value === '' ? '\u200D' : htmlEscape(value);
+}
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -1782,6 +1788,6 @@ function createContextProvider(adapter) {
     };
 }
 
-export { ClassList, LightningElement, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, api, connectContext, createContextProvider, createElement, establishContextfulRelationship, fallbackTmpl, fallbackTmplNoYield, filterProperties, freezeTemplate, getComponentDef, getReadOnlyProxy, hasScopedStaticStylesheets, hot, htmlEscape, isComponentConstructor, massageTextContent, mutationTracker, normalizeClass, parseFragment, parseSVGFragment, readonly, registerComponent, registerDecorators, registerTemplate, renderAttrs, renderAttrsNoYield, serverSideRenderComponent as renderComponent, renderStylesheets, renderer, sanitizeAttribute, sanitizeHtmlContent, serverSideRenderComponent, setFeatureFlag, setFeatureFlagForTest, setHooks, swapComponent, swapStyle, swapTemplate, toIteratorDirective, track, unwrap$1 as unwrap, validateStyleTextContents, wire };
-/** version: 8.12.3 */
+export { ClassList, LightningElement, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, api, connectContext, createContextProvider, createElement, establishContextfulRelationship, fallbackTmpl, fallbackTmplNoYield, freezeTemplate, getComponentDef, getReadOnlyProxy, hasScopedStaticStylesheets, hot, htmlEscape, isComponentConstructor, mutationTracker, normalizeClass, normalizeTextContent, parseFragment, parseSVGFragment, readonly, registerComponent, registerDecorators, registerTemplate, renderAttrs, renderAttrsNoYield, serverSideRenderComponent as renderComponent, renderStylesheets, renderTextContent, renderer, sanitizeAttribute, sanitizeHtmlContent, serverSideRenderComponent, setFeatureFlag, setFeatureFlagForTest, setHooks, swapComponent, swapStyle, swapTemplate, toIteratorDirective, track, unwrap$1 as unwrap, validateStyleTextContents, wire };
+/** version: 8.12.4 */
 //# sourceMappingURL=index.js.map

package/dist/lightning-element.d.ts

@@ -29,7 +29,7 @@ export declare class LightningElement implements PropsAvailableAtConstruction {
     isConnected: boolean;
     tagName: string;
     constructor(propsAvailableAtConstruction: PropsAvailableAtConstruction & Properties);
-    [SYMBOL__SET_INTERNALS](props: Properties, attrs: Attributes): void;
+    [SYMBOL__SET_INTERNALS](props: Properties, attrs: Attributes, publicFields: Set<string>, privateFields: Set<string>): void;
     get className(): any;
     set className(newVal: any);
     get classList(): ClassList;

package/dist/reflection.d.ts

@@ -1,9 +1,2 @@
-/**
- * Filters out the following types of properties that should not be set.
- * - Properties that are not public.
- * - Properties that are not global.
- * - Properties that are global but are internally overridden.
- */
-export declare function filterProperties(props: Record<string, unknown>, publicFields: Set<string>, privateFields: Set<string>): Record<string, unknown>;
 export declare const descriptors: Record<string, PropertyDescriptor>;
 //# sourceMappingURL=reflection.d.ts.map

package/dist/render-text-content.d.ts

@@ -1,6 +1,13 @@
 /**
- * Given an object, render it for use as a text content node.
+ * Given an object, render it for use as a text content node. Not that this applies to individual text nodes,
+ * not the concatenated result of multiple adjacent text nodes.
  * @param value
  */
-export declare function massageTextContent(value: unknown): string;
+export declare function normalizeTextContent(value: unknown): string;
+/**
+ * Given a string, render it for use as text content in HTML. Notably this escapes HTML and renders as
+ * a ZWJ is empty. Intended to be used on the result of concatenating multiple adjacent text nodes together.
+ * @param value
+ */
+export declare function renderTextContent(value: string): string;
 //# sourceMappingURL=render-text-content.d.ts.map

package/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/ssr-runtime",
-    "version": "8.12.3",
+    "version": "8.12.4",
     "description": "Runtime complement to @lwc/ssr-compiler",
     "keywords": [
         "lwc",
@@ -48,8 +48,8 @@
         }
     },
     "devDependencies": {
-        "@lwc/shared": "8.12.3",
-        "@lwc/engine-core": "8.12.3",
+        "@lwc/shared": "8.12.4",
+        "@lwc/engine-core": "8.12.4",
         "observable-membrane": "2.0.0"
     }
 }