@stencil/core 5.0.0-alpha.4 → 5.0.0-alpha.5

package/dist/runtime/client/index.js

@@ -379,7 +379,7 @@ const loadModule = (cmpMeta, hostRef, hmrVersionId) => {
 //#region src/client/client-style.ts
 const styles = /* @__PURE__ */ new Map();
 const modeResolutionChain = [];
-const setScopedSSR = (_opts) => {};
+const setScopedSsr = (_opts) => {};
 const needsScopedSSR = () => false;
 //#endregion
 //#region src/runtime/runtime-constants.ts
@@ -1427,7 +1427,8 @@ const addStyle = (styleContainerNode, cmpMeta, mode) => {
 				styleElm.textContent = style;
 				const nonce = plt.$nonce$ ?? queryNonceMetaTagContent(win.document);
 				if (nonce != null) styleElm.setAttribute("nonce", nonce);
-				if ((BUILD$1.hydrateServerSide || BUILD$1.hotModuleReplacement) && (cmpMeta.$flags$ & CMP_FLAGS.scopedCssEncapsulation || cmpMeta.$flags$ & CMP_FLAGS.shadowNeedsScopedCss || cmpMeta.$flags$ & CMP_FLAGS.shadowDomEncapsulation)) styleElm.setAttribute(HYDRATED_STYLE_ID, scopeId);
+				if (BUILD$1.hydrateServerSide && (cmpMeta.$flags$ & CMP_FLAGS.scopedCssEncapsulation || cmpMeta.$flags$ & CMP_FLAGS.shadowNeedsScopedCss || cmpMeta.$flags$ & CMP_FLAGS.shadowDomEncapsulation) || BUILD$1.hotModuleReplacement) styleElm.setAttribute(HYDRATED_STYLE_ID, scopeId);
+				if (BUILD$1.hotModuleReplacement && cmpMeta.$flags$ & CMP_FLAGS.hasSlotRelocation) styleElm.setAttribute("data-slot-fb", "");
 				/**
 				* attach styles at the end of the head tag if we render scoped components
 				*/
@@ -2538,6 +2539,46 @@ const computeMode = (elm) => modeResolutionChain.map((h) => h(elm)).find((m) =>
 const setMode = (handler) => modeResolutionChain.push(handler);
 const getMode = (ref) => getHostRef(ref)?.$modeName$;
 //#endregion
+//#region src/runtime/normalize-watchers.ts
+/**
+* Normalizes watcher metadata to the current `{ [methodName]: flags }[]` format.
+*
+* Prior to Stencil 4.39.x (PR #6484), the `@Watch()` compiler emitted watcher
+* handlers as a plain string array: `{ "min": ["minChanged"] }`. The new format
+* wraps each entry in an object that carries option flags (e.g. `immediate`):
+* `{ "min": [{ "minChanged": 0 }] }`.
+*
+* When a library (e.g. Ionic Framework) was compiled with an older Stencil compiler
+* but consumed by an app using a newer Stencil runtime, the runtime's
+* `Object.entries(watcher)` call receives a string and misinterprets its character
+* indices as method names, causing:
+*   `TypeError: instance[watchMethodName] is not a function`
+*
+* This helper should be used at `$watchers$` assignment sites that need to
+* accept both legacy and current compiler metadata so downstream code on those
+* paths can safely assume the new object format.
+*
+* @param raw The raw watcher map from compiled metadata (new or legacy format).
+* @returns A normalized watcher map in the `{ [methodName]: flags }[]` format, or `undefined` if `raw` is `undefined` or empty.
+*/
+const normalizeWatchers = (raw) => {
+	if (!raw) return void 0;
+	const keys = Object.keys(raw);
+	if (keys.length === 0) return void 0;
+	let hasLegacy = false;
+	for (const propName of keys) {
+		if (hasLegacy) break;
+		for (const h of raw[propName]) if (typeof h === "string") {
+			hasLegacy = true;
+			break;
+		}
+	}
+	if (!hasLegacy) return raw;
+	const out = {};
+	for (const propName of keys) out[propName] = raw[propName].map((h) => typeof h === "string" ? { [h]: 0 } : h);
+	return out;
+};
+//#endregion
 //#region src/runtime/parse-property-value.ts
 /**
 * Parse a new property value for a given property type.
@@ -3888,7 +3929,7 @@ const proxyComponent = (Cstr, cmpMeta, flags) => {
 	});
 	if (BUILD$1.member && cmpMeta.$members$ || BUILD$1.propChangeCallback) {
 		if (BUILD$1.propChangeCallback) {
-			if (Cstr.watchers && !cmpMeta.$watchers$) cmpMeta.$watchers$ = Cstr.watchers;
+			if (Cstr.watchers && !cmpMeta.$watchers$) cmpMeta.$watchers$ = normalizeWatchers(Cstr.watchers);
 			if (Cstr.deserializers && !cmpMeta.$deserializers$) cmpMeta.$deserializers$ = Cstr.deserializers;
 			if (Cstr.serializers && !cmpMeta.$serializers$) cmpMeta.$serializers$ = Cstr.serializers;
 		}
@@ -4038,7 +4079,7 @@ const initializeComponent = async (elm, hostRef, cmpMeta, hmrVersionId) => {
 				if (!Cstr) throw new Error(`Constructor for "${cmpMeta.$tagName$}#${hostRef.$modeName$}" was not found`);
 				if (BUILD$1.member && !Cstr.isProxied) {
 					if (BUILD$1.propChangeCallback) {
-						cmpMeta.$watchers$ = Cstr.watchers;
+						cmpMeta.$watchers$ = normalizeWatchers(Cstr.watchers);
 						cmpMeta.$serializers$ = Cstr.serializers;
 						cmpMeta.$deserializers$ = Cstr.deserializers;
 					}
@@ -4214,7 +4255,59 @@ const disconnectedCallback = async (elm) => {
 	if (elm.shadowRoot && rootAppliedStyles.has(elm.shadowRoot)) rootAppliedStyles.delete(elm.shadowRoot);
 };
 //#endregion
-//#region src/runtime/bootstrap-custom-element.ts
+//#region src/runtime/hmr-component.ts
+/**
+* Kick off hot-module-replacement for a component. In order to replace the
+* component in-place we:
+*
+* 1. get a reference to the {@link d.HostRef} for the element
+* 2. reset the element's runtime flags
+* 3. re-run the initialization logic for the element (via
+*    {@link initializeComponent})
+*
+* For standalone (non-lazy) builds, we instead re-import the component module
+* and patch the prototype of the registered constructor in-place, then
+* force a re-render of all existing instances in the DOM.
+*
+* @param hostElement the host element for the component which we want to start
+* doing HMR
+* @param cmpMeta runtime metadata for the component
+* @param hmrVersionId the current HMR version ID
+*/
+const hmrStart = (hostElement, cmpMeta, hmrVersionId) => {
+	if (BUILD$1.lazyLoad) {
+		const hostRef = getHostRef(hostElement);
+		if (!hostRef) return;
+		hostRef.$flags$ = HOST_FLAGS.hasConnected;
+		initializeComponent(hostElement, hostRef, cmpMeta, hmrVersionId);
+	} else hmrStandalone(hostElement, cmpMeta, hmrVersionId);
+};
+const hmrStandalone = async (hostElement, cmpMeta, hmrVersionId) => {
+	const modulePath = hostElement.constructor.__stencil_module__;
+	console.log(`[Stencil HMR] hmrStandalone <${cmpMeta.$tagName$}> modulePath:`, modulePath);
+	if (!modulePath) {
+		console.warn(`[Stencil HMR] No __stencil_module__ on <${cmpMeta.$tagName$}> constructor — was this built with devMode?`);
+		return;
+	}
+	try {
+		const newModule = await import(
+			/* @vite-ignore */
+			`${modulePath}?s-hmr=${hmrVersionId}`
+);
+		const NewClass = Object.values(newModule).find((v) => typeof v === "function" && v.is === cmpMeta.$tagName$) ?? newModule.default;
+		if (!NewClass) return;
+		const ctor = customElements.get(cmpMeta.$tagName$);
+		if (ctor) for (const key of Object.getOwnPropertyNames(NewClass.prototype)) {
+			if (key === "constructor") continue;
+			Object.defineProperty(ctor.prototype, key, Object.getOwnPropertyDescriptor(NewClass.prototype, key));
+		}
+		document.querySelectorAll(cmpMeta.$tagName$).forEach((el) => forceUpdate(el));
+	} catch (e) {
+		console.error(`[Stencil HMR] Failed to reload <${cmpMeta.$tagName$}>`, e);
+	}
+};
+//#endregion
+//#region src/runtime/bootstrap-standalone.ts
 const defineCustomElement = (Cstr, compactMeta) => {
 	customElements.define(transformTag(compactMeta[1]), proxyCustomElement(Cstr, compactMeta));
 };
@@ -4228,12 +4321,15 @@ const proxyCustomElement = (Cstr, compactMeta) => {
 		if (BUILD$1.member) cmpMeta.$members$ = compactMeta[2];
 		if (BUILD$1.hostListener) cmpMeta.$listeners$ = compactMeta[3];
 		if (BUILD$1.propChangeCallback) {
-			cmpMeta.$watchers$ = Cstr.$watchers$;
+			cmpMeta.$watchers$ = normalizeWatchers(Cstr.$watchers$);
 			cmpMeta.$deserializers$ = Cstr.$deserializers$;
 			cmpMeta.$serializers$ = Cstr.$serializers$;
 		}
 		if (BUILD$1.reflect) cmpMeta.$attrsToReflect$ = [];
 		if (BUILD$1.shadowDom && !supportsShadow && cmpMeta.$flags$ & CMP_FLAGS.shadowDomEncapsulation) cmpMeta.$flags$ |= CMP_FLAGS.needsShadowDomShim;
+		if (BUILD$1.hotModuleReplacement) Cstr.prototype["s-hmr"] = function(hmrVersionId) {
+			hmrStart(this, cmpMeta, hmrVersionId);
+		};
 		if (!(cmpMeta.$flags$ & CMP_FLAGS.shadowDomEncapsulation) && cmpMeta.$flags$ & CMP_FLAGS.hasSlot) if (BUILD$1.experimentalSlotFixes || BUILD$1.patchAll && cmpMeta.$flags$ & CMP_FLAGS.patchAll) patchPseudoShadowDom(Cstr.prototype);
 		else {
 			if (BUILD$1.slotChildNodesFix || BUILD$1.patchChildren && cmpMeta.$flags$ & CMP_FLAGS.patchChildren) patchChildSlotNodes(Cstr.prototype);
@@ -4314,29 +4410,7 @@ const forceModeUpdate = (elm) => {
 	}
 };
 //#endregion
-//#region src/runtime/hmr-component.ts
-/**
-* Kick off hot-module-replacement for a component. In order to replace the
-* component in-place we:
-*
-* 1. get a reference to the {@link d.HostRef} for the element
-* 2. reset the element's runtime flags
-* 3. re-run the initialization logic for the element (via
-*    {@link initializeComponent})
-*
-* @param hostElement the host element for the component which we want to start
-* doing HMR
-* @param cmpMeta runtime metadata for the component
-* @param hmrVersionId the current HMR version ID
-*/
-const hmrStart = (hostElement, cmpMeta, hmrVersionId) => {
-	const hostRef = getHostRef(hostElement);
-	if (!hostRef) return;
-	hostRef.$flags$ = HOST_FLAGS.hasConnected;
-	initializeComponent(hostElement, hostRef, cmpMeta, hmrVersionId);
-};
-//#endregion
-//#region src/runtime/bootstrap-lazy.ts
+//#region src/runtime/bootstrap-loader.ts
 const bootstrapLazy = (lazyBundles, options = {}) => {
 	if (BUILD$1.profile && performance.mark) performance.mark("st:app:start");
 	installDevTools();
@@ -4370,7 +4444,7 @@ const bootstrapLazy = (lazyBundles, options = {}) => {
 			if (BUILD$1.hostListener) cmpMeta.$listeners$ = compactMeta[3];
 			if (BUILD$1.reflect) cmpMeta.$attrsToReflect$ = [];
 			if (BUILD$1.propChangeCallback) {
-				cmpMeta.$watchers$ = compactMeta[4] ?? {};
+				cmpMeta.$watchers$ = normalizeWatchers(compactMeta[4]);
 				cmpMeta.$serializers$ = compactMeta[5] ?? {};
 				cmpMeta.$deserializers$ = compactMeta[6] ?? {};
 			}
@@ -4792,4 +4866,4 @@ const insertChildVNodeAnnotations = (doc, vnodeChild, cmpData, hostId, depth, in
 	}
 };
 //#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, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRenderingRef, getShadowRoot, getValue, h, insertVdomAnnotations, isMemberInElement, jsx, jsxs, loadModule, modeResolutionChain, needsScopedSSR, nextTick, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, render, renderVdom, resolveVar, setAssetPath, setErrorHandler, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setScopedSSR, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, supportsShadow, transformTag, 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, STENCIL_DEV_MODE, State, Watch, addHostEventListeners, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRenderingRef, getShadowRoot, getValue, h, insertVdomAnnotations, isMemberInElement, jsx, jsxs, loadModule, modeResolutionChain, needsScopedSSR, nextTick, normalizeWatchers, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, render, renderVdom, resolveVar, setAssetPath, setErrorHandler, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setScopedSsr, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, supportsShadow, transformTag, win, writeTask };

package/dist/runtime/index.d.ts

@@ -1,16 +1,16 @@
-import { _ as ResolutionHandler, a as ComponentRuntimeMeta, c as HostRef, d as RenderNode, f as RuntimeRef, g as JSXBase, h as HTMLStencilElement, i as ComponentRuntimeHostListener, l as LazyBundlesRuntimeData, n as ChildType, o as ComponentRuntimeMetaCompact, p as CustomElementsDefineOptions, r as ComponentConstructor, s as HostElement, u as PlatformRuntime, v as TagTransformer, y as VNode } from "../index-CyrGY82h.js";
-import { n as jsxs, r as Fragment, t as jsx } from "../jsx-runtime-DlDkTqps.js";
+import { _ as JSXBase, a as ComponentRuntimeHostListener, b as VNode, c as HostElement, d as PlatformRuntime, f as RenderNode, g as HTMLStencilElement, i as ComponentConstructorChangeHandlers, l as HostRef, m as CustomElementsDefineOptions, n as ChildType, o as ComponentRuntimeMeta, p as RuntimeRef, r as ComponentConstructor, s as ComponentRuntimeMetaCompact, u as LazyBundlesRuntimeData, v as ResolutionHandler, y as TagTransformer } from "../index-D61XZw0f.js";
+import { n as jsxs, r as Fragment, t as jsx } from "../jsx-runtime-B3vQbWIW.js";
 
 //#region src/runtime/asset-path.d.ts
 declare const getAssetPath: (path: string) => string;
 declare const setAssetPath: (path: string) => string;
 //#endregion
-//#region src/runtime/bootstrap-custom-element.d.ts
+//#region src/runtime/bootstrap-standalone.d.ts
 declare const defineCustomElement: (Cstr: any, compactMeta: ComponentRuntimeMetaCompact) => void;
 declare const proxyCustomElement: (Cstr: any, compactMeta: ComponentRuntimeMetaCompact) => any;
 declare const forceModeUpdate: (elm: RenderNode) => void;
 //#endregion
-//#region src/runtime/bootstrap-lazy.d.ts
+//#region src/runtime/bootstrap-loader.d.ts
 declare const bootstrapLazy: (lazyBundles: LazyBundlesRuntimeData, options?: CustomElementsDefineOptions) => void;
 //#endregion
 //#region src/runtime/connected-callback.d.ts
@@ -59,6 +59,30 @@ declare const getMode: (ref: RuntimeRef) => string;
  */
 declare const setNonce: (nonce: string) => string;
 //#endregion
+//#region src/runtime/normalize-watchers.d.ts
+/**
+ * Normalizes watcher metadata to the current `{ [methodName]: flags }[]` format.
+ *
+ * Prior to Stencil 4.39.x (PR #6484), the `@Watch()` compiler emitted watcher
+ * handlers as a plain string array: `{ "min": ["minChanged"] }`. The new format
+ * wraps each entry in an object that carries option flags (e.g. `immediate`):
+ * `{ "min": [{ "minChanged": 0 }] }`.
+ *
+ * When a library (e.g. Ionic Framework) was compiled with an older Stencil compiler
+ * but consumed by an app using a newer Stencil runtime, the runtime's
+ * `Object.entries(watcher)` call receives a string and misinterprets its character
+ * indices as method names, causing:
+ *   `TypeError: instance[watchMethodName] is not a function`
+ *
+ * This helper should be used at `$watchers$` assignment sites that need to
+ * accept both legacy and current compiler metadata so downstream code on those
+ * paths can safely assume the new object format.
+ *
+ * @param raw The raw watcher map from compiled metadata (new or legacy format).
+ * @returns A normalized watcher map in the `{ [methodName]: flags }[]` format, or `undefined` if `raw` is `undefined` or empty.
+ */
+declare const normalizeWatchers: (raw: ComponentConstructorChangeHandlers | undefined) => ComponentConstructorChangeHandlers | undefined;
+//#endregion
 //#region src/runtime/parse-property-value.d.ts
 /**
  * Parse a new property value for a given property type.
@@ -195,4 +219,4 @@ declare const insertVdomAnnotations: (doc: Document, staticComponents: string[])
  */
 declare const renderVdom: (hostRef: HostRef, renderFnResults: VNode | VNode[], isInitialLoad?: boolean) => void;
 //#endregion
-export { Fragment, type HTMLStencilElement, HYDRATED_STYLE_ID, Host, type JSXBase, Mixin, addHostEventListeners, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, getShadowRoot, getValue, h, insertVdomAnnotations, jsx, jsxs, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, render, renderVdom, setAssetPath, setMode, setNonce, setPlatformOptions, setTagTransformer, setValue, transformTag };
+export { Fragment, type HTMLStencilElement, HYDRATED_STYLE_ID, Host, type JSXBase, Mixin, addHostEventListeners, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, getShadowRoot, getValue, h, insertVdomAnnotations, jsx, jsxs, normalizeWatchers, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, render, renderVdom, setAssetPath, setMode, setNonce, setPlatformOptions, setTagTransformer, setValue, transformTag };

package/dist/runtime/index.js

@@ -1,2 +1,2 @@
-import { A as h, C as postUpdateComponent, D as getMode, E as parsePropertyValue, F as HYDRATED_STYLE_ID, M as getShadowRoot, N as getAssetPath, O as setMode, P as setAssetPath, S as getRenderingRef, T as createEvent, _ as connectedCallback, a as transformTag, b as setValue, c as setNonce, d as Fragment, f as bootstrapLazy, g as disconnectedCallback, h as proxyCustomElement, i as setTagTransformer, j as getElement, k as Host, l as Mixin, m as forceModeUpdate, n as jsx, o as render, p as defineCustomElement, r as jsxs, s as setPlatformOptions, t as insertVdomAnnotations, u as addHostEventListeners, v as proxyComponent, w as renderVdom, x as forceUpdate, y as getValue } from "../runtime-COEYYPyw.js";
-export { Fragment, HYDRATED_STYLE_ID, Host, Mixin, addHostEventListeners, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, getShadowRoot, getValue, h, insertVdomAnnotations, jsx, jsxs, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, render, renderVdom, setAssetPath, setMode, setNonce, setPlatformOptions, setTagTransformer, setValue, transformTag };
+import { A as Host, C as postUpdateComponent, D as normalizeWatchers, E as parsePropertyValue, F as setAssetPath, I as HYDRATED_STYLE_ID, M as getElement, N as getShadowRoot, O as getMode, P as getAssetPath, S as getRenderingRef, T as createEvent, _ as connectedCallback, a as transformTag, b as setValue, c as setNonce, d as Fragment, f as bootstrapLazy, g as disconnectedCallback, h as proxyCustomElement, i as setTagTransformer, j as h, k as setMode, l as Mixin, m as forceModeUpdate, n as jsx, o as render, p as defineCustomElement, r as jsxs, s as setPlatformOptions, t as insertVdomAnnotations, u as addHostEventListeners, v as proxyComponent, w as renderVdom, x as forceUpdate, y as getValue } from "../runtime-CKyUrF4i.js";
+export { Fragment, HYDRATED_STYLE_ID, Host, Mixin, addHostEventListeners, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, getShadowRoot, getValue, h, insertVdomAnnotations, jsx, jsxs, normalizeWatchers, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, render, renderVdom, setAssetPath, setMode, setNonce, setPlatformOptions, setTagTransformer, setValue, transformTag };

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

@@ -147,7 +147,7 @@ interface CustomElementsDefineOptions {
 }
 //#endregion
 //#region src/declarations/stencil-public-compiler.d.ts
-interface HydrateDocumentOptions {
+interface SsrDocumentOptions {
   /**
    * Build ID that will be added to `<html data-stencil-build="BUILD_ID">`. By default
    * a random ID will be generated
@@ -164,7 +164,7 @@ interface HydrateDocumentOptions {
    * JavaScript to read the structure of the HTML and rebuild each
    * component. Defaults to `true`.
    */
-  clientHydrateAnnotations?: boolean;
+  clientSsrAnnotations?: boolean;
   /**
    * Constrain `setTimeout()` to 1ms, but still async. Also
    * only allows `setInterval()` to fire once, also constrained to 1ms.
@@ -263,10 +263,14 @@ interface HydrateDocumentOptions {
     default: 'declarative-shadow-dom' | 'scoped';
   } | boolean;
 }
-interface SerializeDocumentOptions extends HydrateDocumentOptions {
+interface SerializeDocumentOptions extends SsrDocumentOptions {
   /**
    * Runs after the `document` has been hydrated.
    */
+  afterSsr?(document: any): any | Promise<any>;
+  /**
+   * @deprecated Use `afterSsr` instead.
+   */
   afterHydrate?(document: any): any | Promise<any>;
   /**
    * Sets an approximate line width the HTML should attempt to stay within.
@@ -279,6 +283,10 @@ interface SerializeDocumentOptions extends HydrateDocumentOptions {
   /**
    * Runs before the `document` has been hydrated.
    */
+  beforeSsr?(document: any): any | Promise<any>;
+  /**
+   * @deprecated Use `beforeSsr` instead.
+   */
   beforeHydrate?(document: any): any | Promise<any>;
   /**
    * Format the HTML in a nicely indented format.
@@ -316,7 +324,7 @@ interface SerializeDocumentOptions extends HydrateDocumentOptions {
    */
   modes?: ResolutionHandler[];
 }
-interface HydrateFactoryOptions extends SerializeDocumentOptions {
+interface SsrFactoryOptions extends SerializeDocumentOptions {
   serializeToHtml: boolean;
   destroyWindow: boolean;
   destroyDocument: boolean;
@@ -466,7 +474,7 @@ interface HostElement extends HTMLElement {
   ['s-p']?: Promise<void>[];
   componentOnReady?: () => Promise<this>;
 }
-interface HydrateResults {
+interface SsrResults {
   buildId: string;
   diagnostics: Diagnostic[];
   url: string;
@@ -478,42 +486,42 @@ interface HydrateResults {
   search: string | null;
   hash: string | null;
   html: string | null;
-  components: HydrateComponent[];
-  anchors: HydrateAnchorElement[];
-  imgs: HydrateImgElement[];
-  scripts: HydrateScriptElement[];
-  styles: HydrateStyleElement[];
-  staticData: HydrateStaticData[];
+  components: SsrComponent[];
+  anchors: SsrAnchorElement[];
+  imgs: SsrImgElement[];
+  scripts: SsrScriptElement[];
+  styles: SsrStyleElement[];
+  staticData: SsrStaticData[];
   title: string | null;
   hydratedCount: number;
   httpStatus: number | null;
 }
-interface HydrateComponent {
+interface SsrComponent {
   tag: string;
   mode: string;
   count: number;
   depth: number;
 }
-interface HydrateElement {
+interface SsrElement {
   [attrName: string]: string | undefined;
 }
-interface HydrateAnchorElement extends HydrateElement {
+interface SsrAnchorElement extends SsrElement {
   href?: string;
   target?: string;
 }
-interface HydrateImgElement extends HydrateElement {
+interface SsrImgElement extends SsrElement {
   src?: string;
 }
-interface HydrateScriptElement extends HydrateElement {
+interface SsrScriptElement extends SsrElement {
   src?: string;
   type?: string;
 }
-interface HydrateStyleElement extends HydrateElement {
+interface SsrStyleElement extends SsrElement {
   id?: string;
   href?: string;
   content?: string;
 }
-interface HydrateStaticData {
+interface SsrStaticData {
   id: string;
   type: string;
   content: string;
@@ -928,15 +936,26 @@ type ChildType = VNode | number | string;
 //#region src/server/platform/h-async.d.ts
 declare const hAsync: (nodeName: any, vnodeData: any, ...children: ChildType[]) => VNode | Promise<VNode>;
 //#endregion
-//#region src/server/platform/hydrate-app.d.ts
-declare function hydrateApp(win: Window & typeof globalThis, opts: HydrateFactoryOptions, results: HydrateResults, afterHydrate: (win: Window, opts: HydrateFactoryOptions, results: HydrateResults, resolve: (results: HydrateResults) => void) => void, resolve: (results: HydrateResults) => void): void;
+//#region src/server/platform/ssr-app.d.ts
+/**
+ * SSR a Document by patching the DOM APIs to wait for components to be connected and hydrated
+ * before allowing them to be added to the document.
+ * Once all components are hydrated, the `afterSsr` callback is called so that the caller can serialize
+ * the document to HTML and send it back to the client.
+ * @param win The window to use for SSR. This should be a patched window created by `patchDomImplementation`.
+ * @param opts The options to use for SSR. This is used to configure which components should be hydrated, how long to wait for hydration, etc.
+ * @param results The results object to store the hydration results.
+ * @param afterSsr The callback to be called after SSR is complete.
+ * @param resolve The resolve function to be called when SSR is complete.
+ */
+declare function ssrApp(win: Window & typeof globalThis, opts: SsrFactoryOptions, results: SsrResults, afterSsr: (win: Window, opts: SsrFactoryOptions, results: SsrResults, resolve: (results: SsrResults) => void) => void, resolve: (results: SsrResults) => void): void;
 //#endregion
-//#region src/runtime/bootstrap-custom-element.d.ts
+//#region src/runtime/bootstrap-standalone.d.ts
 declare const defineCustomElement: (Cstr: any, compactMeta: ComponentRuntimeMetaCompact) => void;
 declare const proxyCustomElement: (Cstr: any, compactMeta: ComponentRuntimeMetaCompact) => any;
 declare const forceModeUpdate: (elm: RenderNode) => void;
 //#endregion
-//#region src/runtime/bootstrap-lazy.d.ts
+//#region src/runtime/bootstrap-loader.d.ts
 declare const bootstrapLazy: (lazyBundles: LazyBundlesRuntimeData, options?: CustomElementsDefineOptions) => void;
 //#endregion
 //#region src/runtime/connected-callback.d.ts
@@ -947,6 +966,18 @@ declare const disconnectedCallback: (elm: HostElement) => Promise<void>;
 //#endregion
 //#region src/runtime/element.d.ts
 declare const getElement: (ref: any) => HostElement;
+/**
+ * Get the shadow root for a Stencil component's host element.
+ * This works for both open and closed shadow DOM modes.
+ *
+ * For closed shadow DOM, `element.shadowRoot` returns `null` by design,
+ * but Stencil stores the reference internally so components can still
+ * access their own shadow root.
+ *
+ * @param element The host element (from @Element() decorator)
+ * @returns The shadow root, or null if no shadow root exists
+ */
+declare const getShadowRoot: (element: HTMLElement) => ShadowRoot | null;
 //#endregion
 //#region src/runtime/event-emitter.d.ts
 declare const createEvent: (ref: RuntimeRef, name: string, flags: number) => {
@@ -1142,7 +1173,7 @@ declare const modeResolutionChain: ResolutionHandler[];
 declare const getAssetPath: (path: string) => string;
 /**
  * Sets the base URL for resolving asset paths in the server/hydrate context.
- * @param path - The base URL to use for resolving asset paths. This should typically be set to the same value as the `resourcesUrl` option passed to `hydrateDocument` to ensure that asset paths are resolved correctly in the server/hydrate context.
+ * @param path - The base URL to use for resolving asset paths. This should typically be set to the same value as the `resourcesUrl` option passed to `ssrDocument` to ensure that asset paths are resolved correctly in the server/hydrate context.
  * If not set, it defaults to './', which is a reasonable default for server-side rendering.
  * @returns void
  */
@@ -1151,7 +1182,7 @@ declare const setAssetPath: (path: string) => string;
  * Checks to see any components are rendered with `scoped`
  * @param opts - SSR options
  */
-declare const setScopedSSR: (opts: HydrateFactoryOptions) => void;
+declare const setScopedSsr: (opts: SsrFactoryOptions) => void;
 declare const needsScopedSSR: () => boolean;
 //#endregion
-export { BUILD, Build, Env, Fragment, Host, Mixin, NAMESPACE, addHostEventListeners, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRenderingRef, getValue, hAsync as h, hydrateApp, insertVdomAnnotations, isMemberInElement, jsx, jsxs, loadModule, modeResolutionChain, needsScopedSSR, nextTick, parsePropertyValue, plt, postUpdateComponent, proxyComponent, proxyCustomElement, readTask, registerComponents, registerHost, registerInstance, renderVdom, setAssetPath, setErrorHandler, setMode, setNonce, setPlatformHelpers, setScopedSSR, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, supportsShadow, transformTag, win, writeTask };
+export { BUILD, Build, Env, Fragment, Host, Mixin, NAMESPACE, addHostEventListeners, bootstrapLazy, cmpModules, connectedCallback, consoleDevError, consoleDevInfo, consoleDevWarn, consoleError, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getHostRef, getMode, getRenderingRef, getShadowRoot, getValue, hAsync as h, insertVdomAnnotations, isMemberInElement, jsx, jsxs, loadModule, modeResolutionChain, needsScopedSSR, nextTick, parsePropertyValue, plt, postUpdateComponent, proxyComponent, proxyCustomElement, readTask, registerComponents, registerHost, registerInstance, renderVdom, setAssetPath, setErrorHandler, setMode, setNonce, setPlatformHelpers, setScopedSsr, setTagTransformer, setValue, ssrApp, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, supportsShadow, transformTag, win, writeTask };