@lwc/ssr-runtime 9.4.6-alpha.1 → 9.5.0

package/dist/index.cjs

@@ -40,9 +40,6 @@ function registerComponent(..._) {
 function registerDecorators(..._) {
     throw new Error('registerDecorators cannot be used in SSR context.');
 }
-function registerTemplate(..._) {
-    throw new Error('registerTemplate cannot be used in SSR context.');
-}
 function sanitizeAttribute(..._) {
     throw new Error('sanitizeAttribute cannot be used in SSR context.');
 }
@@ -467,6 +464,7 @@ function isTrustedContext(target) {
     }
     return trustedContext.has(target);
 }
+const KEY__SANITIZE_HTML_CONTENT = '$sanitizeHtmlContent$';
 // These are HTML standard prop/attribute IDL mappings, but are not predictable based on camel/kebab-case conversion
 const SPECIAL_PROPERTY_ATTRIBUTE_MAPPING = /*@__PURE__@*/ new Map([
     ['accessKey', 'accesskey'],
@@ -631,6 +629,16 @@ function setHooks(hooks) {
     isFalse$1(hooksAreSet, 'Hooks are already overridden, only one definition is allowed.');
     hooksAreSet = true;
     sanitizeHtmlContentImpl = hooks.sanitizeHtmlContent;
+    // Synthetic shadow and the runtime bundle with separate copies of @lwc/shared,
+    // so they can't directly share the sanitize set with `setHooks`.
+    // Set once at boot and left non-writable/non-configurable so the reference stays stable app-wide.
+    if (isUndefined$1(globalThis[KEY__SANITIZE_HTML_CONTENT])) {
+        defineProperty(globalThis, KEY__SANITIZE_HTML_CONTENT, {
+            value: sanitizeHtmlContent,
+            writable: false,
+            configurable: false,
+        });
+    }
 }
 
 /*
@@ -680,7 +688,7 @@ function normalizeTabIndex(value) {
     const shouldNormalize = value > 0 && typeof value !== 'boolean';
     return shouldNormalize ? 0 : value;
 }
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 
 /**
  * Copyright (c) 2026 Salesforce, Inc.
@@ -704,7 +712,7 @@ function normalizeTabIndex(value) {
  * @param value
  * @param msg
  */
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 
 /*
  * Copyright (c) 2023, salesforce.com, inc.
@@ -728,7 +736,7 @@ class SignalBaseClass {
         }
     }
 }
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 
 /**
  * Copyright (c) 2026 Salesforce, Inc.
@@ -754,7 +762,6 @@ const features = {
     DISABLE_HOST_ATTACH_SHADOW_GUARD: null,
     DISABLE_STRICT_VALIDATION: null,
     DISABLE_DETACHED_REHYDRATION: null,
-    DISABLE_BRIDGE_ELEMENT_PROPERTY_GUARD: null,
     // Remove in 270
     ENABLE_LEGACY_ITEM_POLYFILL: null,
     // Remove in 270
@@ -763,12 +770,8 @@ const features = {
     ENABLE_BROKEN_HTML_COLLECTION_NAMED_ITEM: null,
     // Remove in 270
     ENABLE_LEGACY_ATTRIBUTE_CHANGED_CALLBACK: null,
-    // Remove in 270
-    DISABLE_HYDRATION_CUSTOM_ELEMENT_CHECK: null,
     DISABLE_SANITIZED_HTML_CONTENT_IDENTITY_CHECK: null,
-    ENABLE_INTRINSIC_TEMPLATE_INVOCATION: null,
-    ENABLE_PARSE_FRAGMENT_SANITIZATION: null,
-    ENABLE_RENDERER_FACTORY_GUARD: null,
+    DISABLE_NATIVE_SHADOWROOT_SINK_SANITIZATION: null,
 };
 if (!globalThis.lwcRuntimeFlags) {
     Object.defineProperty(globalThis, 'lwcRuntimeFlags', { value: create(null) });
@@ -829,7 +832,7 @@ function setFeatureFlagForTest(name, value) {
         setFeatureFlag(name, value);
     }
 }
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -874,7 +877,7 @@ class ClassList {
                 listOfClasses[idx] = newClassName;
             }
         });
-        this.el.className = listOfClasses.join(' ');
+        this.el.className = Array.from(new Set(listOfClasses)).join(' ');
         return classWasReplaced;
     }
     toggle(classNameToToggle, force) {
@@ -2146,6 +2149,30 @@ function* toIteratorDirective(iterable) {
     }
 }
 
+/*
+ * Copyright (c) 2026, 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 registeredTemplates = new WeakSet();
+/**
+ * Marks a template as having been generated by the compiler
+ * @param tmpl the compiled template function to register
+ * @returns the same template function, for chaining with an assignment
+ * @internal
+ */
+function registerTemplate(tmpl) {
+    registeredTemplates.add(tmpl);
+    return tmpl;
+}
+function isTemplateRegistered(tmpl) {
+    if (tmpl === null || (typeof tmpl !== 'function' && typeof tmpl !== 'object')) {
+        return false;
+    }
+    return registeredTemplates.has(tmpl);
+}
+
 /** The class property that holds a component's resolved `@api` allowlist. */
 const PUBLIC_PROPERTIES_KEY = '__lwcPublicProperties__';
 /**
@@ -2221,7 +2248,18 @@ function createComponent(Component, publicProps, wireAdapters, tagName, props, a
     // If a render() function is defined on the class or any of its superclasses, then that takes priority.
     // Next, if the class or any of its superclasses has an implicitly-associated template, then that takes
     // second priority (e.g. a foo.html file alongside a foo.js file). Finally, there is a fallback empty template.
-    const renderTemplate = instance.render?.() ?? Component[SYMBOL__DEFAULT_TEMPLATE] ?? defaultTmpl;
+    let renderTemplate;
+    if (instance.render) {
+        renderTemplate = instance.render();
+        if (!isTemplateRegistered(renderTemplate)) {
+            throw new TypeError(`Invalid template returned by the render() method on ${tagName}. It must return ` +
+                `an imported template (e.g.: \`import html from "./${Component.name}.html"\`), ` +
+                `instead, it has returned: ${toString(renderTemplate)}.`);
+        }
+    }
+    else {
+        renderTemplate = Component[SYMBOL__DEFAULT_TEMPLATE] ?? defaultTmpl;
+    }
     const hostHasScopedStylesheets = renderTemplate.hasScopedStylesheets || hasScopedStaticStylesheets(Component);
     const hostScopeToken = hostHasScopedStylesheets
         ? renderTemplate.stylesheetScopeToken + '-host'
@@ -2332,5 +2370,5 @@ exports.track = track;
 exports.unwrap = unwrap$1;
 exports.validateStyleTextContents = validateStyleTextContents;
 exports.wire = wire;
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -14,4 +14,5 @@ export { createContextProvider, establishContextfulRelationship, connectContext
 export { readonly } from './get-read-only-proxy';
 export { setStaticInternals } from './set-static-internals';
 export { registerPublicProperties } from './register-public-properties';
+export { registerTemplate } from './register-template';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -36,9 +36,6 @@ function registerComponent(..._) {
 function registerDecorators(..._) {
     throw new Error('registerDecorators cannot be used in SSR context.');
 }
-function registerTemplate(..._) {
-    throw new Error('registerTemplate cannot be used in SSR context.');
-}
 function sanitizeAttribute(..._) {
     throw new Error('sanitizeAttribute cannot be used in SSR context.');
 }
@@ -463,6 +460,7 @@ function isTrustedContext(target) {
     }
     return trustedContext.has(target);
 }
+const KEY__SANITIZE_HTML_CONTENT = '$sanitizeHtmlContent$';
 // These are HTML standard prop/attribute IDL mappings, but are not predictable based on camel/kebab-case conversion
 const SPECIAL_PROPERTY_ATTRIBUTE_MAPPING = /*@__PURE__@*/ new Map([
     ['accessKey', 'accesskey'],
@@ -627,6 +625,16 @@ function setHooks(hooks) {
     isFalse$1(hooksAreSet, 'Hooks are already overridden, only one definition is allowed.');
     hooksAreSet = true;
     sanitizeHtmlContentImpl = hooks.sanitizeHtmlContent;
+    // Synthetic shadow and the runtime bundle with separate copies of @lwc/shared,
+    // so they can't directly share the sanitize set with `setHooks`.
+    // Set once at boot and left non-writable/non-configurable so the reference stays stable app-wide.
+    if (isUndefined$1(globalThis[KEY__SANITIZE_HTML_CONTENT])) {
+        defineProperty(globalThis, KEY__SANITIZE_HTML_CONTENT, {
+            value: sanitizeHtmlContent,
+            writable: false,
+            configurable: false,
+        });
+    }
 }
 
 /*
@@ -676,7 +684,7 @@ function normalizeTabIndex(value) {
     const shouldNormalize = value > 0 && typeof value !== 'boolean';
     return shouldNormalize ? 0 : value;
 }
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 
 /**
  * Copyright (c) 2026 Salesforce, Inc.
@@ -700,7 +708,7 @@ function normalizeTabIndex(value) {
  * @param value
  * @param msg
  */
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 
 /*
  * Copyright (c) 2023, salesforce.com, inc.
@@ -724,7 +732,7 @@ class SignalBaseClass {
         }
     }
 }
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 
 /**
  * Copyright (c) 2026 Salesforce, Inc.
@@ -750,7 +758,6 @@ const features = {
     DISABLE_HOST_ATTACH_SHADOW_GUARD: null,
     DISABLE_STRICT_VALIDATION: null,
     DISABLE_DETACHED_REHYDRATION: null,
-    DISABLE_BRIDGE_ELEMENT_PROPERTY_GUARD: null,
     // Remove in 270
     ENABLE_LEGACY_ITEM_POLYFILL: null,
     // Remove in 270
@@ -759,12 +766,8 @@ const features = {
     ENABLE_BROKEN_HTML_COLLECTION_NAMED_ITEM: null,
     // Remove in 270
     ENABLE_LEGACY_ATTRIBUTE_CHANGED_CALLBACK: null,
-    // Remove in 270
-    DISABLE_HYDRATION_CUSTOM_ELEMENT_CHECK: null,
     DISABLE_SANITIZED_HTML_CONTENT_IDENTITY_CHECK: null,
-    ENABLE_INTRINSIC_TEMPLATE_INVOCATION: null,
-    ENABLE_PARSE_FRAGMENT_SANITIZATION: null,
-    ENABLE_RENDERER_FACTORY_GUARD: null,
+    DISABLE_NATIVE_SHADOWROOT_SINK_SANITIZATION: null,
 };
 if (!globalThis.lwcRuntimeFlags) {
     Object.defineProperty(globalThis, 'lwcRuntimeFlags', { value: create(null) });
@@ -825,7 +828,7 @@ function setFeatureFlagForTest(name, value) {
         setFeatureFlag(name, value);
     }
 }
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -870,7 +873,7 @@ class ClassList {
                 listOfClasses[idx] = newClassName;
             }
         });
-        this.el.className = listOfClasses.join(' ');
+        this.el.className = Array.from(new Set(listOfClasses)).join(' ');
         return classWasReplaced;
     }
     toggle(classNameToToggle, force) {
@@ -2142,6 +2145,30 @@ function* toIteratorDirective(iterable) {
     }
 }
 
+/*
+ * Copyright (c) 2026, 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 registeredTemplates = new WeakSet();
+/**
+ * Marks a template as having been generated by the compiler
+ * @param tmpl the compiled template function to register
+ * @returns the same template function, for chaining with an assignment
+ * @internal
+ */
+function registerTemplate(tmpl) {
+    registeredTemplates.add(tmpl);
+    return tmpl;
+}
+function isTemplateRegistered(tmpl) {
+    if (tmpl === null || (typeof tmpl !== 'function' && typeof tmpl !== 'object')) {
+        return false;
+    }
+    return registeredTemplates.has(tmpl);
+}
+
 /** The class property that holds a component's resolved `@api` allowlist. */
 const PUBLIC_PROPERTIES_KEY = '__lwcPublicProperties__';
 /**
@@ -2217,7 +2244,18 @@ function createComponent(Component, publicProps, wireAdapters, tagName, props, a
     // If a render() function is defined on the class or any of its superclasses, then that takes priority.
     // Next, if the class or any of its superclasses has an implicitly-associated template, then that takes
     // second priority (e.g. a foo.html file alongside a foo.js file). Finally, there is a fallback empty template.
-    const renderTemplate = instance.render?.() ?? Component[SYMBOL__DEFAULT_TEMPLATE] ?? defaultTmpl;
+    let renderTemplate;
+    if (instance.render) {
+        renderTemplate = instance.render();
+        if (!isTemplateRegistered(renderTemplate)) {
+            throw new TypeError(`Invalid template returned by the render() method on ${tagName}. It must return ` +
+                `an imported template (e.g.: \`import html from "./${Component.name}.html"\`), ` +
+                `instead, it has returned: ${toString(renderTemplate)}.`);
+        }
+    }
+    else {
+        renderTemplate = Component[SYMBOL__DEFAULT_TEMPLATE] ?? defaultTmpl;
+    }
     const hostHasScopedStylesheets = renderTemplate.hasScopedStylesheets || hasScopedStaticStylesheets(Component);
     const hostScopeToken = hostHasScopedStylesheets
         ? renderTemplate.stylesheetScopeToken + '-host'
@@ -2272,5 +2310,5 @@ function setStaticInternals(Component, defaultTagName, cmpPublicProps, wireAdapt
 }
 
 export { ClassList, LightningElement, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, SignalBaseClass, addTrustedContext as __dangerous_do_not_use_addTrustedContext, addSlottedContent, api, connectContext$1 as connectContext, createContextProvider, createElement, establishContextfulRelationship, fallbackTmpl, fallbackTmplNoYield, freezeTemplate, getComponentDef, hasScopedStaticStylesheets, hot, htmlEscape, isComponentConstructor, isTrustedSignal, mutationTracker, normalizeClass, normalizeTabIndex, normalizeTextContent, parseFragment, parseSVGFragment, readonly, registerComponent, registerDecorators, registerPublicProperties, registerTemplate, renderAttrs, renderAttrsNoYield, serverSideRenderComponent as renderComponent, renderStylesheets, renderTextContent, renderer, sanitizeAttribute, sanitizeHtmlContent, serverSideRenderComponent, setContextKeys, setFeatureFlag, setFeatureFlagForTest, setHooks, setStaticInternals, setTrustedContextSet, setTrustedSignalSet, swapComponent, swapStyle, swapTemplate, toIteratorDirective, track, unwrap$1 as unwrap, validateStyleTextContents, wire };
-/** version: 9.4.6-alpha.1 */
+/** version: 9.5.0 */
 //# sourceMappingURL=index.js.map

package/dist/register-template.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Marks a template as having been generated by the compiler
+ * @param tmpl the compiled template function to register
+ * @returns the same template function, for chaining with an assignment
+ * @internal
+ */
+export declare function registerTemplate<T extends object>(tmpl: T): T;
+export declare function isTemplateRegistered(tmpl: unknown): boolean;
+//# sourceMappingURL=register-template.d.ts.map

package/dist/set-static-internals.d.ts

@@ -1,14 +1,10 @@
 import { SYMBOL__DEFAULT_TEMPLATE, type LightningElementConstructor } from './lightning-element';
 import { type PUBLIC_PROPERTIES_KEY } from './register-public-properties';
+import type { Template } from './types';
 import type { CompilationMode } from '@lwc/shared';
 import type { LightningElement } from './lightning-element';
 import type { WireAdapterConstructor } from '@lwc/engine-core';
-interface Template {
-    (...args: never[]): unknown;
-    hasScopedStylesheets?: boolean;
-    stylesheetScopeToken?: string;
-}
-interface ComponentStaticInternals {
+export interface ComponentStaticInternals {
     [PUBLIC_PROPERTIES_KEY]?: Set<string>;
     [SYMBOL__DEFAULT_TEMPLATE]: Template;
 }

package/dist/stubs.d.ts

@@ -7,7 +7,6 @@ export declare function parseFragment(..._: unknown[]): never;
 export declare function parseSVGFragment(..._: unknown[]): never;
 export declare function registerComponent(..._: unknown[]): never;
 export declare function registerDecorators(..._: unknown[]): never;
-export declare function registerTemplate(..._: unknown[]): never;
 export declare function sanitizeAttribute(..._: unknown[]): never;
 export declare function swapComponent(..._: unknown[]): never;
 export declare function swapStyle(..._: unknown[]): never;

package/dist/types.d.ts

@@ -1,3 +1,8 @@
 export type Attributes = Record<string, string>;
 export type Properties = Record<string, unknown>;
+export interface Template {
+    (...args: never[]): unknown;
+    hasScopedStylesheets?: boolean;
+    stylesheetScopeToken?: string;
+}
 //# sourceMappingURL=types.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": "9.4.6-alpha.1",
+    "version": "9.5.0",
     "description": "Runtime complement to @lwc/ssr-compiler",
     "keywords": [
         "lwc",
@@ -53,10 +53,10 @@
         }
     },
     "devDependencies": {
-        "@lwc/shared": "9.4.6-alpha.1",
-        "@lwc/engine-core": "9.4.6-alpha.1",
-        "@lwc/features": "9.4.6-alpha.1",
-        "@lwc/signals": "9.4.6-alpha.1",
+        "@lwc/shared": "9.5.0",
+        "@lwc/engine-core": "9.5.0",
+        "@lwc/features": "9.5.0",
+        "@lwc/signals": "9.5.0",
         "observable-membrane": "2.0.0"
     }
 }