@lwc/ssr-runtime 8.14.0 → 8.15.0

package/dist/index.cjs.js

@@ -609,7 +609,23 @@ 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.14.0 */
+
+/*
+ * Copyright (c) 2025, salesforce.com, 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
+ */
+/**
+ * Global HTML "tabindex" attribute is specially massaged into a stringified number
+ * This follows the historical behavior in api.ts:
+ * https://github.com/salesforce/lwc/blob/f34a347/packages/%40lwc/engine-core/src/framework/api.ts#L193-L211
+ */
+function normalizeTabIndex(value) {
+    const shouldNormalize = value > 0 && typeof value !== 'boolean';
+    return shouldNormalize ? 0 : value;
+}
+/** version: 8.15.0 */
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -1334,7 +1350,7 @@ 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, publicProperties, privateProperties) {
+    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), SYMBOL__SET_INTERNALS)](props, attrs, publicProperties) {
         __classPrivateFieldSet(this, _LightningElement_props, props, "f");
         __classPrivateFieldSet(this, _LightningElement_attrs, attrs, "f");
         // Class should be set explicitly to avoid it being overridden by connectedCallback classList mutation.
@@ -1344,12 +1360,11 @@ class LightningElement {
         // 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 (publicProperties.has(propName) ||
-                ((REFLECTIVE_GLOBAL_PROPERTY_SET.has(propName) || isAriaAttribute(attrName)) &&
-                    !privateProperties.has(propName))) {
+                REFLECTIVE_GLOBAL_PROPERTY_SET.has(propName) ||
+                isAriaAttribute(attrName)) {
                 // For props passed from parents to children, they are intended to be read-only
                 // to avoid a child mutating its parent's state
                 this[propName] = getReadOnlyProxy(props[propName]);
@@ -1475,7 +1490,7 @@ class LightningElement {
 defineProperties(LightningElement.prototype, descriptors);
 
 /*
- * Copyright (c) 2024, salesforce.com, inc.
+ * Copyright (c) 2025, 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
@@ -1533,11 +1548,11 @@ function* renderAttrs(instance, attrs, hostScopeToken, scopeToken) {
 function renderAttrsNoYield(emit, instance, attrs, hostScopeToken, scopeToken) {
     emit(renderAttrsPrivate(instance, attrs, hostScopeToken, scopeToken));
 }
-function* fallbackTmpl(shadowSlottedContent, _lightSlottedContent, _scopedSlottedContent, Cmp, instance) {
+async function* fallbackTmpl(shadowSlottedContent, _lightSlottedContent, _scopedSlottedContent, Cmp, instance) {
     if (Cmp.renderMode !== 'light') {
         yield `<template shadowrootmode="open"></template>`;
         if (shadowSlottedContent) {
-            yield shadowSlottedContent(instance);
+            yield* shadowSlottedContent(instance);
         }
     }
 }
@@ -1561,6 +1576,8 @@ async function serverSideRenderComponent(tagName, Component, props = {}, mode =
     if (!generateMarkup) {
         // If a non-component is accidentally provided, render an empty template
         emit(`<${tagName}>`);
+        // Using a false type assertion for the `instance` param is safe because it's only used
+        // if there's slotted content, which we are not providing
         fallbackTmplNoYield(emit, null, null, null, Component, null);
         emit(`</${tagName}>`);
         return markup;
@@ -1817,6 +1834,7 @@ exports.htmlEscape = htmlEscape;
 exports.isComponentConstructor = isComponentConstructor;
 exports.mutationTracker = mutationTracker;
 exports.normalizeClass = normalizeClass;
+exports.normalizeTabIndex = normalizeTabIndex;
 exports.normalizeTextContent = normalizeTextContent;
 exports.parseFragment = parseFragment;
 exports.parseSVGFragment = parseSVGFragment;
@@ -1843,5 +1861,5 @@ exports.track = track;
 exports.unwrap = unwrap$1;
 exports.validateStyleTextContents = validateStyleTextContents;
 exports.wire = wire;
-/** version: 8.14.0 */
+/** version: 8.15.0 */
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 export * from './stubs';
-export { htmlEscape, setHooks, sanitizeHtmlContent, normalizeClass } from '@lwc/shared';
+export { htmlEscape, setHooks, sanitizeHtmlContent, normalizeClass, normalizeTabIndex, } from '@lwc/shared';
 export { ClassList } from './class-list';
 export { LightningElement, LightningElementConstructor, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, } from './lightning-element';
 export { mutationTracker } from './mutation-tracker';
-export { fallbackTmpl, fallbackTmplNoYield, GenerateMarkupFn, renderAttrs, renderAttrsNoYield, serverSideRenderComponent, serverSideRenderComponent as renderComponent, } from './render';
+export { fallbackTmpl, fallbackTmplNoYield, GenerateMarkupAsyncYield, renderAttrs, renderAttrsNoYield, serverSideRenderComponent, serverSideRenderComponent as renderComponent, } from './render';
 export { normalizeTextContent, renderTextContent } from './render-text-content';
 export { hasScopedStaticStylesheets, renderStylesheets } from './styles';
 export { toIteratorDirective } from './to-iterator-directive';

package/dist/index.js

@@ -605,7 +605,23 @@ 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.14.0 */
+
+/*
+ * Copyright (c) 2025, salesforce.com, 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
+ */
+/**
+ * Global HTML "tabindex" attribute is specially massaged into a stringified number
+ * This follows the historical behavior in api.ts:
+ * https://github.com/salesforce/lwc/blob/f34a347/packages/%40lwc/engine-core/src/framework/api.ts#L193-L211
+ */
+function normalizeTabIndex(value) {
+    const shouldNormalize = value > 0 && typeof value !== 'boolean';
+    return shouldNormalize ? 0 : value;
+}
+/** version: 8.15.0 */
 
 /*
  * Copyright (c) 2024, Salesforce, Inc.
@@ -1330,7 +1346,7 @@ 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, publicProperties, privateProperties) {
+    [(_LightningElement_props = new WeakMap(), _LightningElement_attrs = new WeakMap(), _LightningElement_classList = new WeakMap(), SYMBOL__SET_INTERNALS)](props, attrs, publicProperties) {
         __classPrivateFieldSet(this, _LightningElement_props, props, "f");
         __classPrivateFieldSet(this, _LightningElement_attrs, attrs, "f");
         // Class should be set explicitly to avoid it being overridden by connectedCallback classList mutation.
@@ -1340,12 +1356,11 @@ class LightningElement {
         // 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 (publicProperties.has(propName) ||
-                ((REFLECTIVE_GLOBAL_PROPERTY_SET.has(propName) || isAriaAttribute(attrName)) &&
-                    !privateProperties.has(propName))) {
+                REFLECTIVE_GLOBAL_PROPERTY_SET.has(propName) ||
+                isAriaAttribute(attrName)) {
                 // For props passed from parents to children, they are intended to be read-only
                 // to avoid a child mutating its parent's state
                 this[propName] = getReadOnlyProxy(props[propName]);
@@ -1471,7 +1486,7 @@ class LightningElement {
 defineProperties(LightningElement.prototype, descriptors);
 
 /*
- * Copyright (c) 2024, salesforce.com, inc.
+ * Copyright (c) 2025, 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
@@ -1529,11 +1544,11 @@ function* renderAttrs(instance, attrs, hostScopeToken, scopeToken) {
 function renderAttrsNoYield(emit, instance, attrs, hostScopeToken, scopeToken) {
     emit(renderAttrsPrivate(instance, attrs, hostScopeToken, scopeToken));
 }
-function* fallbackTmpl(shadowSlottedContent, _lightSlottedContent, _scopedSlottedContent, Cmp, instance) {
+async function* fallbackTmpl(shadowSlottedContent, _lightSlottedContent, _scopedSlottedContent, Cmp, instance) {
     if (Cmp.renderMode !== 'light') {
         yield `<template shadowrootmode="open"></template>`;
         if (shadowSlottedContent) {
-            yield shadowSlottedContent(instance);
+            yield* shadowSlottedContent(instance);
         }
     }
 }
@@ -1557,6 +1572,8 @@ async function serverSideRenderComponent(tagName, Component, props = {}, mode =
     if (!generateMarkup) {
         // If a non-component is accidentally provided, render an empty template
         emit(`<${tagName}>`);
+        // Using a false type assertion for the `instance` param is safe because it's only used
+        // if there's slotted content, which we are not providing
         fallbackTmplNoYield(emit, null, null, null, Component, null);
         emit(`</${tagName}>`);
         return markup;
@@ -1793,6 +1810,6 @@ function createContextProvider(adapter) {
     };
 }
 
-export { ClassList, LightningElement, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, api, connectContext, createContextProvider, createElement, establishContextfulRelationship, fallbackTmpl, fallbackTmplNoYield, freezeTemplate, getComponentDef, 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.14.0 */
+export { ClassList, LightningElement, SYMBOL__DEFAULT_TEMPLATE, SYMBOL__GENERATE_MARKUP, SYMBOL__SET_INTERNALS, api, connectContext, createContextProvider, createElement, establishContextfulRelationship, fallbackTmpl, fallbackTmplNoYield, freezeTemplate, getComponentDef, hasScopedStaticStylesheets, hot, htmlEscape, isComponentConstructor, mutationTracker, normalizeClass, normalizeTabIndex, 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.15.0 */
 //# sourceMappingURL=index.js.map

package/dist/lightning-element.d.ts

@@ -16,6 +16,9 @@ export declare class LightningElement implements PropsAvailableAtConstruction {
     #private;
     static renderMode?: 'light' | 'shadow';
     static stylesheets?: Stylesheets;
+    static delegatesFocus?: boolean;
+    static formAssociated?: boolean;
+    static shadowSupportMode?: 'any' | 'reset' | 'native';
     accessKey: string;
     dir: string;
     draggable: boolean;
@@ -28,7 +31,7 @@ export declare class LightningElement implements PropsAvailableAtConstruction {
     isConnected: boolean;
     tagName: string;
     constructor(propsAvailableAtConstruction: PropsAvailableAtConstruction & Properties);
-    [SYMBOL__SET_INTERNALS](props: Properties, attrs: Attributes, publicProperties: Set<string>, privateProperties: Set<string>): void;
+    [SYMBOL__SET_INTERNALS](props: Properties, attrs: Attributes, publicProperties: Set<string>): void;
     get className(): any;
     set className(newVal: any);
     get classList(): ClassList;

package/dist/render.d.ts

@@ -1,17 +1,55 @@
 import { SYMBOL__GENERATE_MARKUP } from './lightning-element';
+import type { CompilationMode } from '@lwc/shared';
 import type { LightningElement, LightningElementConstructor } from './lightning-element';
 import type { Attributes, Properties } from './types';
+/** Parameters used by all `generateMarkup` variants that don't get transmogrified. */
+type BaseGenerateMarkupParams = readonly [
+    tagName: string,
+    props: Properties | null,
+    attrs: Attributes | null,
+    parent: LightningElement | null,
+    scopeToken: string | null,
+    contextfulParent: LightningElement | null
+];
+/** Text emitter used by transmogrified formats. */
+type Emit = (str: string) => void;
+/** Slotted content function used by `asyncYield` mode. */
+type SlottedContentGenerator = (instance: LightningElement) => AsyncGenerator<string, void, unknown>;
+/** Slotted content function used by `sync` and `async` modes. */
+type SlottedContentEmitter = ($$emit: Emit, instance: LightningElement) => void;
+/** Slotted content map used by `asyncYield` mode. */
+type SlottedContentGeneratorMap = Record<number | string, SlottedContentGenerator[]>;
+/** Slotted content map used by `sync` and `async` modes. */
+type SlottedContentEmitterMap = Record<number | string, SlottedContentEmitter[]>;
+/** `generateMarkup` parameters used by `asyncYield` mode. */
+type GenerateMarkupGeneratorParams = readonly [
+    ...BaseGenerateMarkupParams,
+    shadowSlottedContent: SlottedContentGenerator | null,
+    lightSlottedContent: SlottedContentGeneratorMap | null,
+    scopedSlottedContent: SlottedContentGeneratorMap | null
+];
+/** `generateMarkup` parameters used by `sync` and `async` modes. */
+type GenerateMarkupEmitterParams = readonly [
+    emit: Emit,
+    ...BaseGenerateMarkupParams,
+    shadowSlottedContent: SlottedContentEmitter | null,
+    lightSlottedContent: SlottedContentEmitterMap | null,
+    scopedSlottedContent: SlottedContentEmitterMap | null
+];
+/** Signature for `asyncYield` compilation mode. */
+export type GenerateMarkupAsyncYield = (...args: GenerateMarkupGeneratorParams) => AsyncGenerator<string>;
+/** Signature for `async` compilation mode. */
+export type GenerateMarkupAsync = (...args: GenerateMarkupEmitterParams) => Promise<void>;
+/** Signature for `sync` compilation mode. */
+export type GenerateMarkupSync = (...args: GenerateMarkupEmitterParams) => void;
+type GenerateMarkupVariants = GenerateMarkupAsyncYield | GenerateMarkupAsync | GenerateMarkupSync;
 export declare function renderAttrs(instance: LightningElement, attrs: Attributes, hostScopeToken: string | undefined, scopeToken: string | undefined): Generator<string, void, unknown>;
 export declare function renderAttrsNoYield(emit: (segment: string) => void, instance: LightningElement, attrs: Attributes, hostScopeToken: string | undefined, scopeToken: string | undefined): void;
-export declare function fallbackTmpl(shadowSlottedContent: AsyncGeneratorFunction, _lightSlottedContent: unknown, _scopedSlottedContent: unknown, Cmp: LightningElementConstructor, instance: LightningElement): Generator<"<template shadowrootmode=\"open\"></template>" | AsyncGenerator<unknown, any, any>, void, unknown>;
-export declare function fallbackTmplNoYield(emit: (segment: string) => void, shadowSlottedContent: AsyncGeneratorFunction | null, _lightSlottedContent: unknown, _scopedSlottedContent: unknown, Cmp: LightningElementConstructor, instance: LightningElement | null): void;
-export type GenerateMarkupFn = (tagName: string, props: Properties | null, attrs: Attributes | null, shadowSlottedContent: AsyncGenerator<string> | null, lightSlottedContent: Record<number | string, AsyncGenerator<string>> | null, scopedSlottedContent: Record<number | string, AsyncGenerator<string>> | null, parent: LightningElement | null, scopeToken: string | null, contextfulParent: LightningElement | null) => AsyncGenerator<string>;
-export type GenerateMarkupFnAsyncNoGen = (emit: (segment: string) => void, tagName: string, props: Properties | null, attrs: Attributes | null, shadowSlottedContent: AsyncGenerator<string> | null, lightSlottedContent: Record<number | string, AsyncGenerator<string>> | null, scopedSlottedContent: Record<number | string, AsyncGenerator<string>> | null, parent: LightningElement | null, scopeToken: string | null, contextfulParent: LightningElement | null) => Promise<void>;
-export type GenerateMarkupFnSyncNoGen = (emit: (segment: string) => void, tagName: string, props: Properties | null, attrs: Attributes | null, shadowSlottedContent: AsyncGenerator<string> | null, lightSlottedContent: Record<number | string, AsyncGenerator<string>> | null, scopedSlottedContent: Record<number | string, AsyncGenerator<string>> | null, parent: LightningElement | null, scopeToken: string | null, contextfulParent: LightningElement | null) => void;
-type GenerateMarkupFnVariants = GenerateMarkupFn | GenerateMarkupFnAsyncNoGen | GenerateMarkupFnSyncNoGen;
+export declare function fallbackTmpl(shadowSlottedContent: SlottedContentGenerator | null, _lightSlottedContent: SlottedContentGeneratorMap | null, _scopedSlottedContent: SlottedContentGeneratorMap | null, Cmp: LightningElementConstructor, instance: LightningElement): AsyncGenerator<string>;
+export declare function fallbackTmplNoYield(emit: Emit, shadowSlottedContent: SlottedContentEmitter | null, _lightSlottedContent: SlottedContentEmitterMap | null, _scopedSlottedContent: SlottedContentEmitterMap | null, Cmp: LightningElementConstructor, instance: LightningElement): void;
 interface ComponentWithGenerateMarkup extends LightningElementConstructor {
-    [SYMBOL__GENERATE_MARKUP]?: GenerateMarkupFnVariants;
+    [SYMBOL__GENERATE_MARKUP]?: GenerateMarkupVariants;
 }
-export declare function serverSideRenderComponent(tagName: string, Component: ComponentWithGenerateMarkup, props?: Properties, mode?: 'asyncYield' | 'async' | 'sync'): Promise<string>;
+export declare function serverSideRenderComponent(tagName: string, Component: ComponentWithGenerateMarkup, props?: Properties, mode?: CompilationMode): Promise<string>;
 export {};
 //# sourceMappingURL=render.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.14.0",
+    "version": "8.15.0",
     "description": "Runtime complement to @lwc/ssr-compiler",
     "keywords": [
         "lwc",
@@ -48,8 +48,8 @@
         }
     },
     "devDependencies": {
-        "@lwc/shared": "8.14.0",
-        "@lwc/engine-core": "8.14.0",
+        "@lwc/shared": "8.15.0",
+        "@lwc/engine-core": "8.15.0",
         "observable-membrane": "2.0.0"
     }
 }