@stencil/core 5.0.0-alpha.1 → 5.0.0-alpha.11

package/dist/runtime/index.d.ts

@@ -1,16 +1,19 @@
-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-BONzXKJt.js";
-import { n as jsxs, r as Fragment, t as jsx } from "../jsx-runtime-DBzBJLKk.js";
+import { S as VNode, _ as FunctionalComponent, a as ComponentConstructor, b as ResolutionHandler, c as ComponentRuntimeMeta, d as HostRef, f as LazyBundlesRuntimeData, g as CustomElementsDefineOptions, h as RuntimeRef, i as ChildType, l as ComponentRuntimeMetaCompact, m as RenderNode, o as ComponentConstructorChangeHandlers, p as PlatformRuntime, s as ComponentRuntimeHostListener, u as HostElement, v as HTMLStencilElement, x as TagTransformer, y as JSXBase } from "../index-xAkMgLX_.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/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
@@ -21,14 +24,29 @@ 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) => {
   emit: (detail: any) => CustomEvent<any>;
 };
 //#endregion
+//#region src/runtime/fragment.d.ts
+declare const Fragment: FunctionalComponent;
+//#endregion
 //#region src/runtime/host-listener.d.ts
-declare const addHostEventListeners: (elm: HostElement, hostRef: HostRef, listeners?: ComponentRuntimeHostListener[], attachParentListeners?: boolean) => void;
+declare const addHostEventListeners: (elm: HostElement, hostRef: HostRef, listeners?: ComponentRuntimeHostListener[]) => void;
 //#endregion
 //#region src/runtime/mixin.d.ts
 type Ctor<T = {}> = new (...args: any[]) => T;
@@ -47,6 +65,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.
@@ -105,6 +147,10 @@ declare const proxyComponent: (Cstr: ComponentConstructor, cmpMeta: ComponentRun
 /**
  * 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';
@@ -151,32 +197,15 @@ declare const forceUpdate: (ref: any) => boolean;
 declare const h: (nodeName: any, vnodeData: any, ...children: ChildType[]) => VNode;
 declare const Host: {};
 //#endregion
-//#region src/runtime/vdom/vdom-annotations.d.ts
+//#region src/runtime/vdom/jsx-runtime.d.ts
+declare function jsx(type: any, props: any, key?: string): VNode;
 /**
- * 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.
+ * @alias
  */
-declare const insertVdomAnnotations: (doc: Document, staticComponents: string[]) => void;
-//#endregion
-//#region src/runtime/vdom/vdom-render.d.ts
+declare const jsxs: typeof jsx;
 /**
- * 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 { Fragment, type HTMLStencilElement, HYDRATED_STYLE_ID, Host, type JSXBase, Mixin, addHostEventListeners, bootstrapLazy, connectedCallback, createEvent, defineCustomElement, disconnectedCallback, forceModeUpdate, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, 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, getRegistry, getRenderingRef, getShadowRoot, getValue, h, jsx, jsxDEV, jsxs, normalizeWatchers, parsePropertyValue, postUpdateComponent, proxyComponent, proxyCustomElement, render, setAssetPath, setMode, setNonce, setPlatformOptions, setRegistry, setTagTransformer, setValue, transformTag };