@stencil/core 5.0.0-alpha.3 → 5.0.0-alpha.31

package/dist/runtime/client/{index.d.ts → runtime.d.ts}

@@ -1,4 +1,6 @@
-import { BUILD, Env, NAMESPACE } from "@stencil/core/runtime/app-data";
+import { BUILD, Env, NAMESPACE } from "@stencil/core/app-data";
+import "rolldown";
+import "typescript";
 //#region src/declarations/stencil-public-runtime.d.ts
 interface ElementDecorator {
   (): PropertyDecorator;
@@ -49,6 +51,27 @@ interface HTMLStencilElement extends HTMLElement {
   componentOnReady(): Promise<this>;
 }
 type TagTransformer = (tag: string) => string;
+/**
+ * A constructor type that can be used as the base for mixin factories.
+ *
+ * ```ts
+ * import { MixedInCtor } from '@stencil/core';
+ *
+ * const AFactoryFn = <B extends MixedInCtor>(Base: B) => {class A extends Base { propA = A }; return A;}
+ * ```
+ */
+type MixedInCtor<T = {}> = new (...args: any[]) => T;
+/**
+ * A map of `@Prop`/`@State` property names to their new and previous
+ * values, passed to `componentShouldUpdate` once per render cycle.
+ *
+ * Pass `this` as `T` to type `changes` against your component's own
+ * members, e.g. `componentShouldUpdate(changes: ComponentShouldUpdateChanges<this>)`.
+ */
+type ComponentShouldUpdateChanges<T = any> = { [K in Extract<keyof T, string>]?: {
+  newVal: T[K];
+  oldVal: T[K];
+}; };
 interface ComponentInterface {
   connectedCallback?(): void;
   disconnectedCallback?(): void;
@@ -74,14 +97,18 @@ interface ComponentInterface {
    */
   componentDidLoad?(): void;
   /**
-   * A `@Prop` or `@State` property changed and a rerender is about to be requested.
+   * One or more `@Prop` or `@State` properties changed and a rerender is
+   * about to be requested. `changes` contains every property that changed
+   * since the last render, keyed by property name.
    *
-   * Called multiple times throughout the life of
-   * the component as its properties change.
+   * Called once per render cycle, batching all properties that changed
+   * synchronously since the last render.
+   *
+   * Return `false` to prevent the pending render.
    *
    * componentShouldUpdate is not called on the first render.
    */
-  componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+  componentShouldUpdate?(changes: ComponentShouldUpdateChanges<this>): boolean | void;
   /**
    * The component is about to update and re-render.
    *
@@ -104,9 +131,47 @@ interface ComponentInterface {
   render?(): any;
   [memberName: string]: any;
 }
+/**
+ * A reusable behavior that hooks into a `ReactiveControllerHost`'s lifecycle. Modeled after Lit's
+ * `ReactiveController` pattern: implement the hooks you need, then register an instance with a host
+ * via `host.addController(this)`.
+ */
+interface ReactiveController {
+  hostConnected?(): void;
+  hostDisconnected?(): void;
+  hostWillLoad?(): Promise<void> | void;
+  hostDidLoad?(): void;
+  hostWillRender?(): Promise<void> | void;
+  hostDidRender?(): void;
+  hostWillUpdate?(): Promise<void> | void;
+  hostDidUpdate?(): void;
+}
+/**
+ * The shape added to a component by mixing in `ReactiveControllerHost` (see below).
+ */
+interface ReactiveControllerHostInterface extends ComponentInterface, HTMLElement {
+  readonly controllers: ReadonlySet<ReactiveController>;
+  addController(controller: ReactiveController): void;
+  removeController(controller: ReactiveController): void;
+  requestUpdate(): void;
+  /**
+   * Resolves once the next pending render commits. Matches the shape of Lit's
+   * `ReactiveControllerHost.updateComplete`, for interop with controllers written against Lit's API
+   * (e.g. `@lit/context`).
+   */
+  readonly updateComplete: Promise<boolean>;
+}
 interface RafCallback {
   (timeStamp: number): void;
 }
+/**
+ * Minimal interface matched by signal objects (from @stencil/core/signals).
+ * Used in JSX attribute types.
+ */
+interface SignalRef<T = any> {
+  readonly value: T;
+  peek(): T;
+}
 /**
  * Utilities for working with functional Stencil components. An object
  * conforming to this interface is passed by the Stencil runtime as the third
@@ -148,7 +213,7 @@ interface FunctionalUtilities {
   map: (children: VNode[], cb: (vnode: ChildNode$1, index: number, array: ChildNode$1[]) => ChildNode$1) => VNode[];
 }
 interface FunctionalComponent<T = {}> {
-  (props: T, children: VNode[], utils: FunctionalUtilities): VNode | VNode[] | null;
+  (props: T, children: VNode[], utils: FunctionalUtilities): VNode | null;
 }
 /**
  * A Child VDOM node
@@ -159,7 +224,7 @@ interface FunctionalComponent<T = {}> {
  * {@link FunctionalUtilities}).
  */
 interface ChildNode$1 {
-  vtag?: string | number | Function;
+  vtag?: string | number | Function | symbol | null;
   vkey?: string | number;
   vtext?: string;
   vchildren?: VNode[];
@@ -171,13 +236,15 @@ interface ChildNode$1 {
  */
 interface VNode {
   $flags$: number;
-  $tag$: string | number | Function;
+  $tag$: string | number | Function | symbol | null;
   $elm$: any;
   $text$: string;
   $children$: VNode[];
   $attrs$?: any;
   $name$?: string;
   $key$?: string | number;
+  /** Signal reference for vdom bypass: signal text nodes store the signal here. */
+  $signal$?: any;
 }
 declare namespace JSXBase {
   interface IntrinsicElements {
@@ -435,6 +502,7 @@ declare namespace JSXBase {
     onClose?: (event: Event$1) => void;
     open?: boolean;
     returnValue?: string;
+    closedby?: 'any' | 'closerequest' | 'none';
   }
   interface EmbedHTMLAttributes<T> extends HTMLAttributes<T> {
     height?: number | string;
@@ -472,6 +540,8 @@ declare namespace JSXBase {
     allowtransparency?: string | boolean;
     frameBorder?: number | string;
     frameborder?: number | string;
+    fetchPriority?: 'high' | 'low' | 'auto';
+    fetchpriority?: 'high' | 'low' | 'auto';
     importance?: 'low' | 'auto' | 'high';
     height?: number | string;
     loading?: 'lazy' | 'auto' | 'eager';
@@ -494,9 +564,12 @@ declare namespace JSXBase {
     crossOrigin?: string;
     crossorigin?: string;
     decoding?: 'async' | 'auto' | 'sync';
+    fetchPriority?: 'high' | 'low' | 'auto';
+    fetchpriority?: 'high' | 'low' | 'auto';
     importance?: 'low' | 'auto' | 'high';
     height?: number | string;
     loading?: 'lazy' | 'auto' | 'eager';
+    referrerPolicy?: ReferrerPolicy;
     sizes?: string;
     src?: string;
     srcSet?: string;
@@ -592,6 +665,8 @@ declare namespace JSXBase {
   }
   interface LinkHTMLAttributes<T> extends HTMLAttributes<T> {
     as?: string;
+    fetchPriority?: 'high' | 'low' | 'auto';
+    fetchpriority?: 'high' | 'low' | 'auto';
     href?: string;
     hrefLang?: string;
     hreflang?: string;
@@ -715,6 +790,8 @@ declare namespace JSXBase {
     crossOrigin?: string;
     crossorigin?: string;
     defer?: boolean;
+    fetchPriority?: 'high' | 'low' | 'auto';
+    fetchpriority?: 'high' | 'low' | 'auto';
     importance?: 'low' | 'auto' | 'high';
     integrity?: string;
     nonce?: string;
@@ -812,7 +889,7 @@ declare namespace JSXBase {
     autofocus?: boolean | string;
     class?: string | {
       [className: string]: boolean;
-    };
+    } | SignalRef<string>;
     contentEditable?: boolean | string;
     contenteditable?: boolean | string;
     contextMenu?: string;
@@ -830,7 +907,10 @@ declare namespace JSXBase {
     tabIndex?: number;
     tabindex?: number | string;
     title?: string;
+    translate?: 'yes' | 'no' | (string & {});
     popover?: string | null;
+    focusgroup?: string;
+    focusgroupstart?: boolean;
     inputMode?: string;
     inputmode?: string;
     enterKeyHint?: string;
@@ -871,7 +951,7 @@ declare namespace JSXBase {
   interface SVGAttributes<T = SVGElement> extends DOMAttributes<T> {
     class?: string | {
       [className: string]: boolean;
-    };
+    } | SignalRef<string>;
     color?: string;
     height?: number | string;
     id?: string;
@@ -1272,10 +1352,13 @@ declare namespace JSXBase {
 interface JSXAttributes<T = Element$2> {
   key?: string | number;
   ref?: (elm?: T) => void;
+  children?: any;
 }
 interface CustomElementsDefineOptions {
   exclude?: string[];
   syncQueue?: boolean;
+  /** Scoped custom element registry to define components in. Defaults to the global registry. */
+  registry?: CustomElementRegistry;
   jmp?: (c: Function) => any;
   raf?: (c: FrameRequestCallback) => number;
   ael?: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
@@ -1284,7 +1367,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
@@ -1301,7 +1384,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.
@@ -1400,10 +1483,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.
@@ -1416,6 +1503,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.
@@ -1453,7 +1544,7 @@ interface SerializeDocumentOptions extends HydrateDocumentOptions {
    */
   modes?: ResolutionHandler[];
 }
-interface HydrateFactoryOptions extends SerializeDocumentOptions {
+interface SsrFactoryOptions extends SerializeDocumentOptions {
   serializeToHtml: boolean;
   destroyWindow: boolean;
   destroyDocument: boolean;
@@ -1523,7 +1614,7 @@ interface HostElement extends HTMLElement {
   disconnectedCallback?: () => void;
   host?: Element;
   forceUpdate?: () => void;
-  __stencil__getHostRef?: () => HostRef;
+  __s_ghr?: () => HostRef;
   /**
    * Unique stencil id for this element
    */
@@ -1577,6 +1668,15 @@ interface HostElement extends HTMLElement {
    * must be resolved for the top, ancestor component to be fully hydrated
    */
   ['s-p']?: Promise<void>[];
+  /**
+   * Pending Connects:
+   * A list of {@link HostRef.$onFirstConnectPromise$} promises for descendants that
+   * were already registered with this component (their nearest Stencil ancestor) by
+   * the time this component's own initial `componentWillLoad` was scheduled. Awaited
+   * so this component's `componentWillLoad` can't fire before those descendants'
+   * real `connectedCallback`s have.
+   */
+  ['s-pc']?: Promise<void>[];
   componentOnReady?: () => Promise<this>;
 }
 /**
@@ -1616,6 +1716,11 @@ interface RenderNode extends HostElement {
    * Slot name of either the slot itself or the slotted node
    */
   ['s-sn']?: string;
+  /**
+   * `slot` attribute of a `<slot>` reference rendered as a text node (no fallback content),
+   * since text nodes can't carry real DOM attributes.
+   */
+  ['s-sa']?: string;
   /**
    * Host element tag name:
    * The tag name of the host element that this
@@ -1668,64 +1773,64 @@ interface RenderNode extends HostElement {
    * Used to know the components encapsulation.
    * empty "" for shadow, "c" from scoped
    */
-  ['s-en']?: '' | /*shadow*/'c';
+  ['s-en']?: '' | /*shadow*/ 'c';
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `childNodes` of the component
    */
   readonly __childNodes?: NodeListOf<ChildNode>;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `children` of the component
    */
   readonly __children?: HTMLCollectionOf<Element>;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `firstChild` of the component
    */
   readonly __firstChild?: ChildNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `lastChild` of the component
    */
   readonly __lastChild?: ChildNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the internal `textContent` of the component
    */
   __textContent?: string;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `append` method
    */
   __append?: (...nodes: (Node | string)[]) => void;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `prepend` method
    */
   __prepend?: (...nodes: (Node | string)[]) => void;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `appendChild` method
    */
   __appendChild?: <T extends Node>(newChild: T) => T;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `insertBefore` method
    */
   __insertBefore?: <T extends Node>(node: T, child: Node | null) => T;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * gives access to the original `removeChild` method
    */
   __removeChild?: <T extends Node>(child: T) => T;
@@ -1763,40 +1868,56 @@ interface PatchedSlotNode extends Node {
   ['s-sr']?: boolean;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `parentNode` of the component
    */
   __parentNode?: RenderNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `nextSibling` of the component
    */
   __nextSibling?: RenderNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `previousSibling` of the component
    */
   __previousSibling?: RenderNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `nextElementSibling` of the component
    */
   __nextElementSibling?: RenderNode;
   /**
    * On a `scoped: true` component
-   * with `experimentalSlotFixes` flag enabled,
+   * with `lightDomPatches` flag enabled,
    * returns the actual `nextElementSibling` of the component
    */
   __previousElementSibling?: RenderNode;
 }
 type LazyBundlesRuntimeData = LazyBundleRuntimeData[];
-type LazyBundleRuntimeData = [/** bundleIds */string, ComponentRuntimeMetaCompact[]];
-type ComponentRuntimeMetaCompact = [/** flags */number, /** tagname */string, /** members */{
+type LazyBundleRuntimeData = [
+/** bundleIds */
+string, ComponentRuntimeMetaCompact[]];
+type ComponentRuntimeMetaCompact = [
+/** flags */
+number,
+/** tagname */
+string,
+/** members */
+{
   [memberName: string]: ComponentRuntimeMember;
-}?, /** listeners */ComponentRuntimeHostListener[]?, /** watchers */ComponentConstructorChangeHandlers?, /** serializers */ComponentConstructorChangeHandlers?, /** deserializers */ComponentConstructorChangeHandlers?];
+}?,
+/** listeners */
+ComponentRuntimeHostListener[]?,
+/** watchers */
+ComponentConstructorChangeHandlers?,
+/** serializers */
+ComponentConstructorChangeHandlers?,
+/** deserializers */
+ComponentConstructorChangeHandlers?];
 /**
  * Runtime metadata for a Stencil component
  */
@@ -1888,7 +2009,7 @@ type ComponentRuntimeReflectingAttr = [string, string | undefined];
  * associated {@link HostRef} instance.
  */
 type RuntimeRef = HostElement | {
-  __stencil__getHostRef?: () => HostRef;
+  __s_ghr?: () => HostRef;
 };
 /**
  * Interface used to track an Element, it's virtual Node (`VNode`), and other data
@@ -1899,6 +2020,14 @@ interface HostRef {
   $cmpMeta$: ComponentRuntimeMeta;
   $hostElement$: HostElement;
   $instanceValues$?: Map<string, any>;
+  /**
+   * Prop/state changes accumulated since the last render, flushed to
+   * `componentShouldUpdate` once per render cycle.
+   */
+  $queuedPropChanges$?: ComponentShouldUpdateChanges;
+  $signalValues$?: Map<string, import('@preact/signals-core').Signal<any>>;
+  /** Dispose function that tears down all signal effects for this component. */
+  $signalCleanup$?: () => void;
   $serializerValues$?: Map<string, string>;
   $lazyInstance$?: ComponentInterface;
   /**
@@ -1931,6 +2060,21 @@ interface HostRef {
    * It is called after {@link HostRef.$onInstancePromise$} resolves.
    */
   $onRenderResolve$?: () => void;
+  /**
+   * A promise that resolves once this component's real `connectedCallback` has fired
+   * for the first time. Created lazily - either by a descendant that needs to wait for
+   * this component's connection before firing its own real `connectedCallback`
+   * ({@link HOST_FLAGS.hasFiredConnected}), or by this component registering itself
+   * with its nearest Stencil ancestor's `s-pc` list. This is what lets a component's
+   * real `connectedCallback` (and, transitively, a pending ancestor's initial
+   * `componentWillLoad`) stay ordered correctly regardless of which of an
+   * ancestor/descendant pair's lazy module happens to resolve first.
+   */
+  $onFirstConnectPromise$?: Promise<void>;
+  /**
+   * A callback which resolves {@link HostRef.$onFirstConnectPromise$}
+   */
+  $onFirstConnectResolve$?: () => void;
   $vnode$?: VNode;
   $queuedListeners$?: [string, any][];
   $rmListeners$?: (() => void)[];
@@ -1940,6 +2084,11 @@ interface HostRef {
    * Defer connectedCallback until after first render for components with slot relocation.
    */
   $deferredConnectedCallback$?: boolean;
+  /**
+   * The number of times this host's lazy component load has failed and been retried.
+   * Used to give up retrying after {@link MAX_LAZY_LOAD_RETRIES} failed attempts.
+   */
+  $loadRetryCount$?: number;
 }
 interface PlatformRuntime {
   /**
@@ -2109,6 +2258,7 @@ declare const isMemberInElement: (elm: any, memberName: string) => boolean;
 declare const cmpModules: Map<string, {
   [exportName: string]: ComponentConstructor;
 }>;
+declare const setLazyLoadBasePath: (url: string) => void;
 declare const loadModule: (cmpMeta: ComponentRuntimeMeta, hostRef: HostRef, hmrVersionId?: string) => Promise<ComponentConstructor | undefined> | ComponentConstructor | undefined;
 //#endregion
 //#region src/client/client-log.d.ts
@@ -2122,7 +2272,7 @@ declare const setErrorHandler: (handler: ErrorHandler) => ErrorHandler;
 //#region src/client/client-style.d.ts
 declare const styles: StyleMap;
 declare const modeResolutionChain: ResolutionHandler[];
-declare const setScopedSSR: (_opts: HydrateFactoryOptions) => void;
+declare const setScopedSsr: (_opts: SsrFactoryOptions) => void;
 declare const needsScopedSSR: () => boolean;
 //#endregion
 //#region src/client/client-task-queue.d.ts
@@ -2144,7 +2294,6 @@ declare const setPlatformHelpers: (helpers: {
   rel?: (el: any, eventName: string, listener: any, options: any) => void;
   ce?: (eventName: string, opts?: any) => any;
 }) => void;
-declare const supportsShadow: boolean;
 declare const supportsListenerOptions: boolean;
 declare const promiseResolve: (v?: any) => Promise<any>;
 declare const supportsConstructableStylesheets: boolean;
@@ -2154,12 +2303,16 @@ declare const supportsMutableAdoptedStyleSheets: boolean;
 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/registry.d.ts
+declare const setRegistry: (registry: CustomElementRegistry) => void;
+declare const getRegistry: () => CustomElementRegistry;
+//#endregion
+//#region src/runtime/bootstrap-loader.d.ts
 declare const bootstrapLazy: (lazyBundles: LazyBundlesRuntimeData, options?: CustomElementsDefineOptions) => void;
 //#endregion
 //#region src/runtime/connected-callback.d.ts
@@ -2211,6 +2364,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.
@@ -2265,10 +2442,17 @@ declare const setPlatformOptions: (opts: SetPlatformOptions) => PlatformRuntime
  */
 declare const proxyComponent: (Cstr: ComponentConstructor, cmpMeta: ComponentRuntimeMeta, flags: number) => ComponentConstructor;
 //#endregion
+//#region src/runtime/reactive-controller.d.ts
+declare const ReactiveControllerHost: <B extends MixedInCtor<ComponentInterface & HTMLElement>>(Base: B) => B & MixedInCtor<ReactiveControllerHostInterface>;
+//#endregion
 //#region src/runtime/render.d.ts
 /**
  * Method to render a virtual DOM tree to a container element.
  *
+ * Supports efficient re-renders: calling `render()` again on the same container
+ * will diff the new VNode tree against the previous one and only update what changed,
+ * preserving existing DOM elements and their state.
+ *
  * @example
  * ```tsx
  * import { render } from '@stencil/core';
@@ -2316,53 +2500,14 @@ declare const h: (nodeName: any, vnodeData: any, ...children: ChildType[]) => VN
 declare const Host: {};
 //#endregion
 //#region src/runtime/vdom/jsx-runtime.d.ts
-/**
- * JSX runtime function for creating elements in production mode.
- * Called by TypeScript's jsx transform for elements without static children.
- *
- * @param type - The element type (string tag name or functional component)
- * @param props - The element props (includes children)
- * @param key - Optional key for the element
- * @returns A virtual DOM node
- */
 declare function jsx(type: any, props: any, key?: string): VNode;
 /**
- * JSX runtime function for creating elements with static children.
- * Called by TypeScript's jsx transform as an optimization when children are static.
- *
- * @param type - The element type (string tag name or functional component)
- * @param props - The element props (includes children)
- * @param key - Optional key for the element
- * @returns A virtual DOM node
+ * @alias
  */
-declare function jsxs(type: any, props: any, key?: string): VNode;
-//#endregion
-//#region src/runtime/vdom/vdom-annotations.d.ts
+declare const jsxs: typeof jsx;
 /**
- * Updates the DOM generated on the server with annotations such as node attributes and
- * comment nodes to facilitate future client-side hydration. These annotations are used for things
- * like moving elements back to their original hosts if using Shadow DOM on the client, and for quickly
- * reconstructing the vNode representations of the DOM.
- *
- * @param doc The DOM generated by the server.
- * @param staticComponents Any components that should be considered static and do not need client-side hydration.
- */
-declare const insertVdomAnnotations: (doc: Document, staticComponents: string[]) => void;
-//#endregion
-//#region src/runtime/vdom/vdom-render.d.ts
-/**
- * The main entry point for Stencil's virtual DOM-based rendering engine
- *
- * Given a {@link d.HostRef} container and some virtual DOM nodes, this
- * function will handle creating a virtual DOM tree with a single root, patching
- * the current virtual DOM tree onto an old one (if any), dealing with slot
- * relocation, and reflecting attributes.
- *
- * @param hostRef data needed to root and render the virtual DOM tree, such as
- * the DOM node into which it should be rendered.
- * @param renderFnResults the virtual DOM nodes to be rendered
- * @param isInitialLoad whether or not this is the first call after page load
+ * @alias
  */
-declare const renderVdom: (hostRef: HostRef, renderFnResults: VNode | VNode[], isInitialLoad?: boolean) => void;
+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, 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, 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, isMemberInElement, jsx, jsxDEV, jsxs, loadModule, modeResolutionChain, needsScopedSSR, nextTick, normalizeWatchers, parsePropertyValue, plt, postUpdateComponent, promiseResolve, proxyComponent, proxyCustomElement, readTask, registerHost, registerInstance, render, resolveVar, setAssetPath, setErrorHandler, setLazyLoadBasePath, setMode, setNonce, setPlatformHelpers, setPlatformOptions, setRegistry, setScopedSsr, setTagTransformer, setValue, styles, supportsConstructableStylesheets, supportsListenerOptions, supportsMutableAdoptedStyleSheets, transformTag, win, writeTask };