@stencil/core 5.0.0-beta.34 → 5.0.0-beta.36

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { C as Build, S as setErrorHandler, _ as getAssetPath, a as transformTag, b as writeTask, c as Mixin, d as Host, f as h, g as getShadowRoot, h as getElement, i as setTagTransformer, l as getMode, m as getRenderingRef, o as render, p as forceUpdate, s as ReactiveControllerHost, u as setMode, v as setAssetPath, x as setPlatformHelpers, y as readTask } from "./client-UbH-XkYu.mjs";
+import { C as Build, S as setErrorHandler, _ as getAssetPath, a as transformTag, b as writeTask, c as Mixin, d as Host, f as h, g as getShadowRoot, h as getElement, i as setTagTransformer, l as getMode, m as getRenderingRef, o as render, p as forceUpdate, s as ReactiveControllerHost, u as setMode, v as setAssetPath, x as setPlatformHelpers, y as readTask } from "./client-CqQpuOUk.mjs";
 import { t as Fragment } from "./fragment-Di1hWOC8.mjs";
 //#region src/client/client-decorators.ts
 /**

package/dist/jsx-runtime.mjs

@@ -1,3 +1,3 @@
-import { n as jsxDEV, r as jsxs, t as jsx } from "./client-UbH-XkYu.mjs";
+import { n as jsxDEV, r as jsxs, t as jsx } from "./client-CqQpuOUk.mjs";
 import { t as Fragment } from "./fragment-Di1hWOC8.mjs";
 export { Fragment, jsx, jsxDEV, jsxs };

package/dist/{node-eg7pofz5.mjs → node-DwwBX_GL.mjs}

@@ -1,5 +1,5 @@
 import { n as __require } from "./rolldown-runtime-BhDjJH2R.mjs";
-import "./client-UbH-XkYu.mjs";
+import "./client-CqQpuOUk.mjs";
 import { c as isFunction, f as isString, m as noop, r as flatOne } from "./helpers-Cpp3qc3u.mjs";
 import { X as TASK_CANCELED_MSG, Z as buildError, et as catchError, it as isGlob, q as normalizePath, rt as shouldIgnoreError } from "./util-C-H1H84W.mjs";
 import fs from "node:fs";

package/dist/runtime/client/lazy.js

@@ -1137,7 +1137,9 @@ const patchTextContent = (hostElementPrototype) => {
 	Object.defineProperty(hostElementPrototype, "textContent", {
 		get: function() {
 			let text = "";
-			(this.__childNodes ? this.childNodes : getSlottedChildNodes(this.childNodes)).forEach((node) => text += node.textContent || "");
+			(this.__childNodes ? this.childNodes : getSlottedChildNodes(this.childNodes)).forEach((node) => {
+				if (node.nodeType !== NODE_TYPE.CommentNode) text += node.textContent || "";
+			});
 			return text;
 		},
 		set: function(value) {
@@ -1145,7 +1147,7 @@ const patchTextContent = (hostElementPrototype) => {
 				if (node["s-ol"]) node["s-ol"].remove();
 				node.remove();
 			});
-			this.insertAdjacentHTML("beforeend", value);
+			if (value != null && value !== "") this.append(this.ownerDocument.createTextNode(String(value)));
 		}
 	});
 };
@@ -1786,7 +1788,7 @@ let _registry;
 const setRegistry = (registry) => {
 	_registry = registry;
 };
-const getRegistry = () => _registry ?? customElements;
+const getRegistry = () => _registry ?? globalThis.customElements;
 /**
 * @param elm a defined component host
 * @returns the registry the host's class was defined in, else the active registry
@@ -3761,6 +3763,11 @@ const addSlottedNodes = (slottedNodes, slotNodeId, slotName, slotNode, hostId) =
 * @returns the first corresponding node of the type
 */
 const findCorrespondingNode = (node, type) => {
+	if (type === NODE_TYPE.TextNode) {
+		const next = node.nextSibling;
+		if (next?.nodeType === NODE_TYPE.TextNode) return next;
+		return node.parentNode.insertBefore(node.ownerDocument.createTextNode(""), next);
+	}
 	let sibling = node;
 	do
 		sibling = sibling.nextSibling;
@@ -5434,4 +5441,4 @@ function hasKeys(obj) {
 	return false;
 }
 //#endregion
-export { AttachInternals, AttrDeserialize, BUILD, Build, Component, Element$1 as Element, Env, Event, Fragment, H, H as HTMLElement, HYDRATED_STYLE_ID, Host, Listen, Method, Mixin, NAMESPACE, Prop, PropSerialize, ReactiveControllerHost, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, isMemberInElement, jsx, jsxDEV, jsxs, loadModule, modeResolver, needsScopedSSR, nextTick, normalizeWatchers, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, registerSideEffectStyleTarget, render, resolveVar, setAssetPath, setErrorHandler, setLazyLoadBasePath, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setRegistry, setScopedSSR, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, transformTag, unregisterSideEffectStyleTarget, win, writeTask };
+export { AttachInternals, AttrDeserialize, BUILD, Build, Component, Element$1 as Element, Env, Event, Fragment, H, H as HTMLElement, HYDRATED_STYLE_ID, Host, Listen, Method, Mixin, NAMESPACE, Prop, PropSerialize, ReactiveControllerHost, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, applySerializers, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, isMemberInElement, jsx, jsxDEV, jsxs, loadModule, modeResolver, needsScopedSSR, nextTick, normalizeWatchers, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, registerSideEffectStyleTarget, render, resolveVar, setAssetPath, setErrorHandler, setLazyLoadBasePath, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setRegistry, setScopedSSR, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, transformTag, unregisterSideEffectStyleTarget, win, writeTask };

package/dist/runtime/client/runtime.d.ts

@@ -1413,6 +1413,16 @@ interface SsrDocumentOptions {
    * Sets `document.referrer`
    */
   referrer?: string;
+  /**
+   * Render into one long-lived mock window, reset between renders, instead of creating a new one
+   * for every call. Skips evaluating the whole SSR platform (runtime and every component)
+   * on each render: most of the cost of rendering a small fragment, and a good part of a whole page.
+   *
+   * Applies to HTML string input (not a `Document`). One window per distinct `serializeShadowRoot` value,
+   * and renders sharing a window run one at a time.
+   * Defaults to `false`, except in the `ssr-wasm` output target, where it defaults to `true`.
+   */
+  reuseWindow?: boolean;
   /**
    * Removes every `<script>` element found in the `document`. Defaults to `false`.
    */
@@ -1544,6 +1554,12 @@ interface SsrFactoryOptions extends SerializeDocumentOptions {
   serializeToHtml: boolean;
   destroyWindow: boolean;
   destroyDocument: boolean;
+  /**
+   * A canonical key for `serializeShadowRoot`, set by the renderer. Renders with the same key
+   * render every component the same way, so they can share an SSR platform.
+   * @internal
+   */
+  serializeShadowRootKey?: string;
 }
 //#endregion
 //#region src/declarations/stencil-private.d.ts
@@ -2511,6 +2527,7 @@ declare function render(vnode: VNode, container: Element): void;
 declare const HYDRATED_STYLE_ID = "sty-id";
 //#endregion
 //#region src/runtime/set-value.d.ts
+declare const applySerializers: (hostRef: HostRef, cmpMeta: ComponentRuntimeMeta, propName: string, val: any, instance: any) => void;
 declare const getValue: (ref: RuntimeRef, propName: string) => any;
 declare const setValue: (ref: RuntimeRef, propName: string, newVal: any, cmpMeta: ComponentRuntimeMeta) => void;
 //#endregion
@@ -2547,4 +2564,4 @@ declare const jsxs: typeof jsx;
  */
 declare const jsxDEV: typeof jsx;
 //#endregion
-export { AttachInternals, AttrDeserialize, BUILD, Build, Component, Element$1 as Element, Env, Event, Fragment, H, H as HTMLElement, type HTMLStencilElement, HYDRATED_STYLE_ID, Host, type JSXBase, Listen, Method, Mixin, NAMESPACE, Prop, PropSerialize, ReactiveControllerHost, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, isMemberInElement, jsx, jsxDEV, jsxs, loadModule, modeResolver, needsScopedSSR, nextTick, normalizeWatchers, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, registerSideEffectStyleTarget, render, resolveVar, setAssetPath, setErrorHandler, setLazyLoadBasePath, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setRegistry, setScopedSSR, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, transformTag, unregisterSideEffectStyleTarget, win, writeTask };
+export { AttachInternals, AttrDeserialize, BUILD, Build, Component, Element$1 as Element, Env, Event, Fragment, H, H as HTMLElement, type HTMLStencilElement, HYDRATED_STYLE_ID, Host, type JSXBase, Listen, Method, Mixin, NAMESPACE, Prop, PropSerialize, ReactiveControllerHost, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, applySerializers, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, isMemberInElement, jsx, jsxDEV, jsxs, loadModule, modeResolver, needsScopedSSR, nextTick, normalizeWatchers, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, registerSideEffectStyleTarget, render, resolveVar, setAssetPath, setErrorHandler, setLazyLoadBasePath, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setRegistry, setScopedSSR, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, transformTag, unregisterSideEffectStyleTarget, win, writeTask };

package/dist/runtime/client/runtime.js

@@ -1131,7 +1131,9 @@ const patchTextContent = (hostElementPrototype) => {
 	Object.defineProperty(hostElementPrototype, "textContent", {
 		get: function() {
 			let text = "";
-			(this.__childNodes ? this.childNodes : getSlottedChildNodes(this.childNodes)).forEach((node) => text += node.textContent || "");
+			(this.__childNodes ? this.childNodes : getSlottedChildNodes(this.childNodes)).forEach((node) => {
+				if (node.nodeType !== NODE_TYPE.CommentNode) text += node.textContent || "";
+			});
 			return text;
 		},
 		set: function(value) {
@@ -1139,7 +1141,7 @@ const patchTextContent = (hostElementPrototype) => {
 				if (node["s-ol"]) node["s-ol"].remove();
 				node.remove();
 			});
-			this.insertAdjacentHTML("beforeend", value);
+			if (value != null && value !== "") this.append(this.ownerDocument.createTextNode(String(value)));
 		}
 	});
 };
@@ -1780,7 +1782,7 @@ let _registry;
 const setRegistry = (registry) => {
 	_registry = registry;
 };
-const getRegistry = () => _registry ?? customElements;
+const getRegistry = () => _registry ?? globalThis.customElements;
 /**
 * @param elm a defined component host
 * @returns the registry the host's class was defined in, else the active registry
@@ -3755,6 +3757,11 @@ const addSlottedNodes = (slottedNodes, slotNodeId, slotName, slotNode, hostId) =
 * @returns the first corresponding node of the type
 */
 const findCorrespondingNode = (node, type) => {
+	if (type === NODE_TYPE.TextNode) {
+		const next = node.nextSibling;
+		if (next?.nodeType === NODE_TYPE.TextNode) return next;
+		return node.parentNode.insertBefore(node.ownerDocument.createTextNode(""), next);
+	}
 	let sibling = node;
 	do
 		sibling = sibling.nextSibling;
@@ -5428,4 +5435,4 @@ function hasKeys(obj) {
 	return false;
 }
 //#endregion
-export { AttachInternals, AttrDeserialize, BUILD, Build, Component, Element$1 as Element, Env, Event, Fragment, H, H as HTMLElement, HYDRATED_STYLE_ID, Host, Listen, Method, Mixin, NAMESPACE, Prop, PropSerialize, ReactiveControllerHost, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, isMemberInElement, jsx, jsxDEV, jsxs, loadModule, modeResolver, needsScopedSSR, nextTick, normalizeWatchers, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, registerSideEffectStyleTarget, render, resolveVar, setAssetPath, setErrorHandler, setLazyLoadBasePath, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setRegistry, setScopedSSR, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, transformTag, unregisterSideEffectStyleTarget, win, writeTask };
+export { AttachInternals, AttrDeserialize, BUILD, Build, Component, Element$1 as Element, Env, Event, Fragment, H, H as HTMLElement, HYDRATED_STYLE_ID, Host, Listen, Method, Mixin, NAMESPACE, Prop, PropSerialize, ReactiveControllerHost, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, applySerializers, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, isMemberInElement, jsx, jsxDEV, jsxs, loadModule, modeResolver, needsScopedSSR, nextTick, normalizeWatchers, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, registerSideEffectStyleTarget, render, resolveVar, setAssetPath, setErrorHandler, setLazyLoadBasePath, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setRegistry, setScopedSSR, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, transformTag, unregisterSideEffectStyleTarget, win, writeTask };

package/dist/runtime/index.d.ts

@@ -199,6 +199,7 @@ declare function render(vnode: VNode, container: Element): void;
 declare const HYDRATED_STYLE_ID = "sty-id";
 //#endregion
 //#region src/runtime/set-value.d.ts
+declare const applySerializers: (hostRef: HostRef, cmpMeta: ComponentRuntimeMeta, propName: string, val: any, instance: any) => void;
 declare const getValue: (ref: RuntimeRef, propName: string) => any;
 declare const setValue: (ref: RuntimeRef, propName: string, newVal: any, cmpMeta: ComponentRuntimeMeta) => void;
 //#endregion
@@ -235,4 +236,4 @@ declare const jsxs: typeof jsx;
  */
 declare const jsxDEV: typeof jsx;
 //#endregion
-export { Fragment, type HTMLStencilElement, HYDRATED_STYLE_ID, Host, type JSXBase, Mixin, ReactiveControllerHost, addHostEventListeners, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, jsx, jsxDEV, jsxs, normalizeWatchers, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, registerSideEffectStyleTarget, render, setAssetPath, setMode, setNonce, setPlatformOptions, setRegistry, setTagTransformer, setValue, transformTag, unregisterSideEffectStyleTarget };
+export { Fragment, type HTMLStencilElement, HYDRATED_STYLE_ID, Host, type JSXBase, Mixin, ReactiveControllerHost, addHostEventListeners, applySerializers, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, jsx, jsxDEV, jsxs, normalizeWatchers, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, registerSideEffectStyleTarget, render, setAssetPath, setMode, setNonce, setPlatformOptions, setRegistry, setTagTransformer, setValue, transformTag, unregisterSideEffectStyleTarget };

package/dist/runtime/index.js

@@ -1003,7 +1003,9 @@ const patchTextContent = (hostElementPrototype) => {
 	Object.defineProperty(hostElementPrototype, "textContent", {
 		get: function() {
 			let text = "";
-			(this.__childNodes ? this.childNodes : getSlottedChildNodes(this.childNodes)).forEach((node) => text += node.textContent || "");
+			(this.__childNodes ? this.childNodes : getSlottedChildNodes(this.childNodes)).forEach((node) => {
+				if (node.nodeType !== NODE_TYPE.CommentNode) text += node.textContent || "";
+			});
 			return text;
 		},
 		set: function(value) {
@@ -1011,7 +1013,7 @@ const patchTextContent = (hostElementPrototype) => {
 				if (node["s-ol"]) node["s-ol"].remove();
 				node.remove();
 			});
-			this.insertAdjacentHTML("beforeend", value);
+			if (value != null && value !== "") this.append(this.ownerDocument.createTextNode(String(value)));
 		}
 	});
 };
@@ -1652,7 +1654,7 @@ let _registry;
 const setRegistry = (registry) => {
 	_registry = registry;
 };
-const getRegistry = () => _registry ?? customElements;
+const getRegistry = () => _registry ?? globalThis.customElements;
 /**
 * @param elm a defined component host
 * @returns the registry the host's class was defined in, else the active registry
@@ -3627,6 +3629,11 @@ const addSlottedNodes = (slottedNodes, slotNodeId, slotName, slotNode, hostId) =
 * @returns the first corresponding node of the type
 */
 const findCorrespondingNode = (node, type) => {
+	if (type === NODE_TYPE.TextNode) {
+		const next = node.nextSibling;
+		if (next?.nodeType === NODE_TYPE.TextNode) return next;
+		return node.parentNode.insertBefore(node.ownerDocument.createTextNode(""), next);
+	}
 	let sibling = node;
 	do
 		sibling = sibling.nextSibling;
@@ -5300,4 +5307,4 @@ function hasKeys(obj) {
 	return false;
 }
 //#endregion
-export { Fragment, HYDRATED_STYLE_ID, Host, Mixin, ReactiveControllerHost, addHostEventListeners, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, jsx, jsxDEV, jsxs, normalizeWatchers, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, registerSideEffectStyleTarget, render, setAssetPath, setMode, setNonce, setPlatformOptions, setRegistry, setTagTransformer, setValue, transformTag, unregisterSideEffectStyleTarget };
+export { Fragment, HYDRATED_STYLE_ID, Host, Mixin, ReactiveControllerHost, addHostEventListeners, applySerializers, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRegistry, getRenderingRef, getShadowRoot, getValue, h, injectSideEffectStyle, jsx, jsxDEV, jsxs, normalizeWatchers, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, registerSideEffectStyleTarget, render, setAssetPath, setMode, setNonce, setPlatformOptions, setRegistry, setTagTransformer, setValue, transformTag, unregisterSideEffectStyleTarget };

package/dist/runtime/server/index.d.mts

@@ -218,6 +218,16 @@ interface SsrDocumentOptions {
    * Sets `document.referrer`
    */
   referrer?: string;
+  /**
+   * Render into one long-lived mock window, reset between renders, instead of creating a new one
+   * for every call. Skips evaluating the whole SSR platform (runtime and every component)
+   * on each render: most of the cost of rendering a small fragment, and a good part of a whole page.
+   *
+   * Applies to HTML string input (not a `Document`). One window per distinct `serializeShadowRoot` value,
+   * and renders sharing a window run one at a time.
+   * Defaults to `false`, except in the `ssr-wasm` output target, where it defaults to `true`.
+   */
+  reuseWindow?: boolean;
   /**
    * Removes every `<script>` element found in the `document`. Defaults to `false`.
    */
@@ -349,6 +359,12 @@ interface SsrFactoryOptions extends SerializeDocumentOptions {
   serializeToHtml: boolean;
   destroyWindow: boolean;
   destroyDocument: boolean;
+  /**
+   * A canonical key for `serializeShadowRoot`, set by the renderer. Renders with the same key
+   * render every component the same way, so they can share an SSR platform.
+   * @internal
+   */
+  serializeShadowRootKey?: string;
 }
 interface Diagnostic {
   absFilePath?: string | undefined;

package/dist/runtime/server/index.mjs

@@ -50,6 +50,8 @@ const NODE_TYPE = {
 const HYDRATE_ID = "s-id";
 const HYDRATED_STYLE_ID = "sty-id";
 const HYDRATE_CHILD_ID = "c-id";
+/** `Symbol.for()` key of the `ssrProp()` registry on the server's real global object. */
+const SSR_PROPS_REGISTRY_KEY = "stencil.ssrProps";
 const HYDRATED_CSS = "{visibility:hidden}.hydrated{visibility:inherit}";
 const STENCIL_DOC_DATA = "_stencilDocData";
 const DEFAULT_DOC_DATA = {
@@ -799,7 +801,9 @@ const patchTextContent = (hostElementPrototype) => {
 	Object.defineProperty(hostElementPrototype, "textContent", {
 		get: function() {
 			let text = "";
-			(this.__childNodes ? this.childNodes : getSlottedChildNodes(this.childNodes)).forEach((node) => text += node.textContent || "");
+			(this.__childNodes ? this.childNodes : getSlottedChildNodes(this.childNodes)).forEach((node) => {
+				if (node.nodeType !== NODE_TYPE.CommentNode) text += node.textContent || "";
+			});
 			return text;
 		},
 		set: function(value) {
@@ -807,7 +811,7 @@ const patchTextContent = (hostElementPrototype) => {
 				if (node["s-ol"]) node["s-ol"].remove();
 				node.remove();
 			});
-			this.insertAdjacentHTML("beforeend", value);
+			if (value != null && value !== "") this.append(this.ownerDocument.createTextNode(String(value)));
 		}
 	});
 };
@@ -1373,6 +1377,13 @@ const hydrateScopedToShadow = () => {
 */
 const isDef = (v) => v != null && v !== void 0;
 /**
+* Convert a string from PascalCase to dash-case
+*
+* @param str the string to convert
+* @returns a converted string
+*/
+const toDashCase = (str) => str.replace(/([A-Z0-9])/g, (match) => ` ${match[0]}`).trim().split(" ").join("-").toLowerCase();
+/**
 * Check whether a value is a 'complex type', defined here as an object or a
 * function.
 *
@@ -1416,7 +1427,7 @@ const emitEvent = (elm, name, opts) => {
 	elm.dispatchEvent(ev);
 	return ev;
 };
-const getRegistry = () => customElements;
+const getRegistry = () => globalThis.customElements;
 /**
 * @param elm a defined component host
 * @returns the registry the host's class was defined in, else the active registry
@@ -3389,6 +3400,11 @@ const addSlottedNodes = (slottedNodes, slotNodeId, slotName, slotNode, hostId) =
 * @returns the first corresponding node of the type
 */
 const findCorrespondingNode = (node, type) => {
+	if (type === NODE_TYPE.TextNode) {
+		const next = node.nextSibling;
+		if (next?.nodeType === NODE_TYPE.TextNode) return next;
+		return node.parentNode.insertBefore(node.ownerDocument.createTextNode(""), next);
+	}
 	let sibling = node;
 	do
 		sibling = sibling.nextSibling;
@@ -5029,7 +5045,10 @@ const insertVNodeAnnotations = (doc, hostElm, vnode, docData, cmpData) => {
 	if (vnode != null) {
 		const hostId = ++docData.hostIds;
 		hostElm.setAttribute(HYDRATE_ID, hostId);
-		if (hostElm["s-cr"] != null) hostElm["s-cr"].nodeValue = `r.${hostId}`;
+		if (hostElm["s-cr"] != null) {
+			if (hostElm.shadowRoot) hostElm["s-cr"].remove();
+			else hostElm["s-cr"].nodeValue = `r.${hostId}`;
+		}
 		if (vnode.$children$ != null) {
 			const depth = 0;
 			vnode.$children$.forEach((vnodeChild, index) => {
@@ -5091,7 +5110,14 @@ const insertChildVNodeAnnotations = (doc, vnodeChild, cmpData, hostId, depth, in
 };
 //#endregion
 //#region src/server/platform/proxy-host-element.ts
-function proxyHostElement(elm, cstr) {
+/**
+* Set up a component's host element on the server: its props (from attributes, values set on
+* the element before it was defined, and `ssrProp()` references), getters/setters and shadow root.
+* @param elm the host element
+* @param cstr the component's constructor
+* @param warn report a problem with the render (to its `diagnostics`)
+*/
+function proxyHostElement(elm, cstr, warn = () => {}) {
 	const cmpMeta = cstr.cmpMeta;
 	cmpMeta.$watchers$ = cmpMeta.$watchers$ || cstr.watchers;
 	cmpMeta.$deserializers$ = cmpMeta.$deserializers$ || cstr.deserializers;
@@ -5108,7 +5134,9 @@ function proxyHostElement(elm, cstr) {
 		Object.entries(cmpMeta.$members$).forEach(([memberName, [memberFlags, metaAttributeName]]) => {
 			if (memberFlags & MEMBER_FLAGS.Prop) {
 				const attributeName = metaAttributeName || memberName;
-				const attrValue = elm.getAttribute(attributeName);
+				let attrValue = elm.getAttribute(attributeName);
+				const ssrProp = takeSsrProp(elm, attributeName, memberName, warn);
+				if (ssrProp) attrValue = null;
 				const propValue = elm[memberName];
 				let attrPropVal;
 				const { get: origGetter, set: origSetter } = Object.getOwnPropertyDescriptor(cstr.prototype, memberName) || {};
@@ -5119,12 +5147,18 @@ function proxyHostElement(elm, cstr) {
 					}
 					else attrPropVal = parsePropertyValue(attrValue, memberFlags);
 				}
+				if (ssrProp?.value !== void 0) attrPropVal = ssrProp.value;
 				if (propValue !== void 0) {
 					attrPropVal = propValue;
 					delete elm[memberName];
 				}
+				const setFromOutside = ssrProp?.value !== void 0 || propValue !== void 0;
+				if (setFromOutside && typeof attrPropVal === "object" && attrPropVal !== null && !cmpMeta.$serializers$?.[memberName]) warn(`<${cmpMeta.$tagName$}>'s "${memberName}" prop was given an object on the server, but has no @PropSerialize(), so the browser won't get it: the component will first render there without it. To keep it, use @Prop({ serialize: 'json' }), or a @PropSerialize() / @AttrDeserialize() pair for other formats.`);
 				const userSetter = !cstr.isProxied ? origSetter : void 0;
-				if (attrPropVal !== void 0 && !userSetter) hostRef?.$instanceValues$?.set(memberName, attrPropVal);
+				if (attrPropVal !== void 0 && !userSetter) {
+					hostRef?.$instanceValues$?.set(memberName, attrPropVal);
+					if (setFromOutside && cmpMeta.$serializers$?.[memberName]) applySerializers(hostRef, cmpMeta, memberName, attrPropVal, void 0);
+				}
 				const getterSetterDescriptor = {
 					get: function() {
 						return getValue(this, memberName);
@@ -5172,6 +5206,34 @@ function componentOnReady() {
 	return getHostRef(this)?.$onReadyPromise$;
 }
 function forceUpdate$1() {}
+/**
+* Read and remove an `ssrProp()` reference: a value a framework template passed to this prop,
+* which reached the server as an attribute pointing into the `ssrProp()` registry. Templates bind
+* it under the prop name, which HTML lower-cases (`chartData` -> `chartdata`), or dash-cased
+* (`chart-data`); complex props usually have no attribute name of their own.
+* @param elm the component's host element
+* @param attributeName the prop's attribute name
+* @param memberName the prop's name
+* @param warn report a problem with the render
+* @returns `undefined` if there's no reference, otherwise its value (`undefined` if it's gone)
+*/
+const takeSsrProp = (elm, attributeName, memberName, warn) => {
+	for (const name of /* @__PURE__ */ new Set([
+		attributeName,
+		memberName,
+		toDashCase(memberName)
+	])) {
+		const attr = elm.getAttribute(name);
+		if (!attr?.startsWith("__stencil_ssr_ref:")) continue;
+		elm.removeAttribute(name);
+		const id = attr.slice(18);
+		const registry = (typeof $stencilNativeGlobal !== "undefined" ? $stencilNativeGlobal : globalThis)[Symbol.for(SSR_PROPS_REGISTRY_KEY)];
+		const entry = registry?.get(id);
+		registry?.delete(id);
+		if (!entry) warn(`<${elm.tagName.toLowerCase()}>'s "${memberName}" was passed with ssrProp(), but its value isn't available here: it's only available to renderToString() in the same process, for a short time after the template ran.`);
+		return { value: entry?.value };
+	}
+};
 //#endregion
 //#region src/server/platform/ssr-app.ts
 /**
@@ -5253,7 +5315,13 @@ function ssrApp(win, opts, results, afterSsr, resolve, abortController) {
 						createdElements.add(elm);
 						elm.connectedCallback = patchedConnectedCallback;
 						registerHost(elm, Cstr.cmpMeta);
-						proxyHostElement(elm, Cstr);
+						proxyHostElement(elm, Cstr, (messageText) => results.diagnostics.push({
+							level: "warn",
+							type: "hydrate",
+							header: "SSR Warning",
+							messageText,
+							lines: []
+						}));
 					}
 				}
 			}

package/dist/runtime/server/runner.d.mts

@@ -59,6 +59,16 @@ interface SsrDocumentOptions {
    * Sets `document.referrer`
    */
   referrer?: string;
+  /**
+   * Render into one long-lived mock window, reset between renders, instead of creating a new one
+   * for every call. Skips evaluating the whole SSR platform (runtime and every component)
+   * on each render: most of the cost of rendering a small fragment, and a good part of a whole page.
+   *
+   * Applies to HTML string input (not a `Document`). One window per distinct `serializeShadowRoot` value,
+   * and renders sharing a window run one at a time.
+   * Defaults to `false`, except in the `ssr-wasm` output target, where it defaults to `true`.
+   */
+  reuseWindow?: boolean;
   /**
    * Removes every `<script>` element found in the `document`. Defaults to `false`.
    */
@@ -190,6 +200,12 @@ interface SsrFactoryOptions extends SerializeDocumentOptions {
   serializeToHtml: boolean;
   destroyWindow: boolean;
   destroyDocument: boolean;
+  /**
+   * A canonical key for `serializeShadowRoot`, set by the renderer. Renders with the same key
+   * render every component the same way, so they can share an SSR platform.
+   * @internal
+   */
+  serializeShadowRootKey?: string;
 }
 interface Diagnostic {
   absFilePath?: string | undefined;
@@ -300,6 +316,14 @@ declare function ssrDocument(doc: any | string, options?: SsrDocumentOptions): P
 declare const hydrateDocument: typeof ssrDocument;
 declare function serializeDocumentToString(doc: Document, opts: SsrFactoryOptions): string;
 //#endregion
+//#region src/server/runner/reusable-window.d.ts
+/**
+ * Drop every reusable window and render queue. For hosts where a render can be abandoned without
+ * ever settling (the `ssr-wasm` plugin, when a call ends with a render still waiting), so the
+ * next render doesn't queue behind it forever.
+ */
+declare function resetReusableWindows(): void;
+//#endregion
 //#region src/server/runner/window-initialize.d.ts
 /**
  * Restart the hydration ids used by fragment renders (`fullDocument: false`).
@@ -324,4 +348,18 @@ declare function transformTag<T extends string>(tag: T): T;
  */
 declare function setTagTransformer(transformer: TagTransformer): void;
 //#endregion
-export { createWindowFromHtml, hydrateDocument, renderToString, resetSsrDocData, serializeDocumentToString, setTagTransformer, ssrDocument, streamToString, transformTag };
+//#region src/server/runner/index.d.ts
+/**
+ * Render components under transformed tag names, to match tag transformation on the client.
+ *
+ * Components are registered under their transformed names when a window's SSR platform is set up,
+ * so this also discards the reusable windows (see the `reuseWindow` option): later renders set up
+ * new ones that use the new transformer.
+ *
+ * (A function declaration with its own name, so the runtime's `setTagTransformer` keeps its name in
+ * the bundle - the SSR build looks for it - and this is hoisted.)
+ * @param transformer the tag transformer
+ */
+declare function setTagTransformerForSsr(transformer: Parameters<typeof setTagTransformer>[0]): void;
+//#endregion
+export { createWindowFromHtml, hydrateDocument, renderToString, resetReusableWindows, resetSsrDocData, serializeDocumentToString, setTagTransformerForSsr as setTagTransformer, ssrDocument, streamToString, transformTag };