@stencil/core 5.0.0-alpha.9 → 5.0.0-beta.0

package/dist/declarations/stencil-public-runtime.d.ts

@@ -102,6 +102,16 @@ interface ShadowEncapsulation {
    * declarative slotting behavior.
    */
   slotAssignment?: 'manual' | 'named';
+  /**
+   * When set to `true`, the shadow root is preserved when the host element is deep-cloned via
+   * `Node.cloneNode(true)`. Without this, cloning a shadow host produces an empty shell.
+   */
+  clonable?: boolean;
+  /**
+   * When set to `true`, marks the shadow root as serializable so it is included when the host
+   * element is serialized via `Element.getHTML({ serializableShadowRoots: true })`.
+   */
+  serializable?: boolean;
 }
 /**
  * Patch types for non-shadow DOM components that use slots.
@@ -484,7 +494,7 @@ declare function setNonce(nonce: string): void;
  * @param ref the ref to get the Stencil element for
  * @returns a reference to the element
  */
-declare function getElement(ref: any): HTMLStencilElement;
+declare function getElement<T extends HTMLElement = HTMLStencilElement>(ref: any): T;
 /**
  * Get the shadow root for a Stencil component's host element.
  * This works for both open and closed shadow DOM modes.
@@ -639,6 +649,17 @@ interface ComponentDidUpdate {
    */
   componentDidUpdate(): void;
 }
+/**
+ * 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;
@@ -664,14 +685,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.
    *
@@ -694,6 +719,54 @@ 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>;
+}
+/**
+ * A mixin factory (for use with `Mixin()`) that adds `ReactiveController` support to a component,
+ * forwarding each Stencil lifecycle method to every registered controller's matching `hostX` hook.
+ *
+ * ```ts
+ * import { Mixin, ReactiveControllerHost } from '@stencil/core';
+ * import { MouseController } from './mouse-controller';
+ *
+ * class MyComponent extends Mixin(ReactiveControllerHost) {
+ *   private mouse = new MouseController(this);
+ *   render() { return <Host>{this.mouse.pos.x}, {this.mouse.pos.y}</Host>; }
+ * }
+ * ```
+ *
+ * @param Base the class to extend.
+ * @returns a class extending `Base` with reactive-controller support.
+ */
+declare function ReactiveControllerHost<B extends MixedInCtor>(Base: B): MixedInCtor<InstanceType<B> & ReactiveControllerHostInterface>;
 interface EventEmitter<T = any> {
   emit: (data?: T) => CustomEvent<T>;
 }
@@ -1127,6 +1200,7 @@ declare namespace JSXBase {
     onClose?: (event: Event) => void;
     open?: boolean;
     returnValue?: string;
+    closedby?: 'any' | 'closerequest' | 'none';
   }
   interface EmbedHTMLAttributes<T> extends HTMLAttributes<T> {
     height?: number | string;
@@ -1164,6 +1238,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';
@@ -1186,6 +1262,8 @@ 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';
@@ -1285,6 +1363,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;
@@ -1408,6 +1488,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;
@@ -1523,7 +1605,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;
@@ -1979,4 +2064,4 @@ interface CustomElementsDefineOptions {
   ce?: (eventName: string, opts?: any) => CustomEvent;
 }
 //#endregion
-export { AttachInternals, AttachInternalsDecorator, AttachInternalsOptions, AttrDeserialize, AttrDeserializeDecorator, Build, ChildNode, Component, ComponentDecorator, ComponentDidLoad, ComponentDidUpdate, ComponentInterface, ComponentOptions, ComponentWillLoad, ComponentWillUpdate, CustomElementsDefineOptions, Element, ElementDecorator, EncapsulationOptions, Env, ErrorHandler, Event, EventDecorator, EventEmitter, EventOptions, Fragment, FunctionalComponent, FunctionalUtilities, HTMLStencilElement, Host, HostAttributes, LocalJSX as JSX, JSXAttributes, JSXBase, Listen, ListenDecorator, ListenOptions, ListenTargetOptions, Method, MethodDecorator, MethodOptions, MixedInCtor, Mixin, ModeStyles, NoneEncapsulation, Prop, PropDecorator, PropOptions, PropSerialize, PropSerializeDecorator, QueueApi, RafCallback, ResolutionHandler, ResolveVarFunction, ScopedEncapsulation, ShadowEncapsulation, ShadowRootOptions, SignalRef, SlotPatch, State, StateDecorator, TagTransformer, UserBuildConditionals, VNode, VNodeData, Watch, WatchDecorator, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, getShadowRoot, h, jsx, jsxs, readTask, render, resolveVar, setAssetPath, setErrorHandler, setMode, setNonce, setPlatformHelpers, setTagTransformer, transformTag, writeTask };
+export { AttachInternals, AttachInternalsDecorator, AttachInternalsOptions, AttrDeserialize, AttrDeserializeDecorator, Build, ChildNode, Component, ComponentDecorator, ComponentDidLoad, ComponentDidUpdate, ComponentInterface, ComponentOptions, ComponentShouldUpdateChanges, ComponentWillLoad, ComponentWillUpdate, CustomElementsDefineOptions, Element, ElementDecorator, EncapsulationOptions, Env, ErrorHandler, Event, EventDecorator, EventEmitter, EventOptions, Fragment, FunctionalComponent, FunctionalUtilities, HTMLStencilElement, Host, HostAttributes, LocalJSX as JSX, JSXAttributes, JSXBase, Listen, ListenDecorator, ListenOptions, ListenTargetOptions, Method, MethodDecorator, MethodOptions, MixedInCtor, Mixin, ModeStyles, NoneEncapsulation, Prop, PropDecorator, PropOptions, PropSerialize, PropSerializeDecorator, QueueApi, RafCallback, ReactiveController, ReactiveControllerHost, ReactiveControllerHostInterface, ResolutionHandler, ResolveVarFunction, ScopedEncapsulation, ShadowEncapsulation, ShadowRootOptions, SignalRef, SlotPatch, State, StateDecorator, TagTransformer, UserBuildConditionals, VNode, VNodeData, Watch, WatchDecorator, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, getShadowRoot, h, jsx, jsxs, readTask, render, resolveVar, setAssetPath, setErrorHandler, setMode, setNonce, setPlatformHelpers, setTagTransformer, transformTag, writeTask };

package/dist/fragment-Di1hWOC8.mjs

@@ -0,0 +1,4 @@
+//#region src/runtime/fragment.ts
+const Fragment = (_, children) => children;
+//#endregion
+export { Fragment as t };

package/dist/{regular-expression-CFVJOTUh.mjs → helpers-Cpp3qc3u.mjs}

@@ -40,8 +40,20 @@ const HOST_FLAGS = {
 	isWatchReady: 128,
 	isListenReady: 256,
 	needsRerender: 512,
-	devOnRender: 1024,
-	devOnDidLoad: 2048
+	/**
+	* Set once this component's real (lazy-loaded) `connectedCallback` has fired for
+	* the first time. Lets a descendant skip creating/awaiting a connect-promise for
+	* an ancestor that's already connected. See {@link HostRef.$onFirstConnectResolve$}.
+	*/
+	hasFiredConnected: 1024,
+	/**
+	* Set when a lazy component's dynamic `import()` fails to resolve a
+	* constructor. Distinct from `hasInitializedComponent` being unset, which
+	* is true while an initialization attempt is merely queued/in-flight.
+	*/
+	hasFailedLoad: 2048,
+	devOnRender: 4096,
+	devOnDidLoad: 8192
 };
 const CF_scopedCssEncapsulation = 2;
 /**
@@ -126,7 +138,17 @@ const CMP_FLAGS = {
 	* e.g. `encapsulation: { type: 'none', patches: ['all'] }`
 	* Equivalent to the global `experimentalSlotFixes` config option.
 	*/
-	patchAll: 32768
+	patchAll: 32768,
+	/**
+	* Determines if `clonable` is enabled for a component that uses the shadow DOM.
+	* e.g. `encapsulation: { type: 'shadow', clonable: true }` is set on the `@Component()` decorator
+	*/
+	shadowClonable: 65536,
+	/**
+	* Determines if `serializable` is enabled for a component that uses the shadow DOM.
+	* e.g. `encapsulation: { type: 'shadow', serializable: true }` is set on the `@Component()` decorator
+	*/
+	shadowSerializable: 1 << 17
 };
 /**
 * Default style mode id
@@ -221,6 +243,10 @@ const DOCS_VSCODE = "docs-vscode";
 */
 const DOCS_CUSTOM_ELEMENTS_MANIFEST = "docs-custom-elements-manifest";
 /**
+* Constant for the 'docs-agent-skill' output target
+*/
+const DOCS_AGENT_SKILL = "docs-agent-skill";
+/**
 * Constant for the 'stats' output target
 */
 const STATS = "stats";
@@ -256,6 +282,7 @@ const VALID_CONFIG_OUTPUT_TARGETS = [
 	DOCS_VSCODE,
 	DOCS_CUSTOM,
 	DOCS_CUSTOM_ELEMENTS_MANIFEST,
+	DOCS_AGENT_SKILL,
 	COPY,
 	CUSTOM,
 	STATS
@@ -494,15 +521,4 @@ const isObject = (val) => val != null && typeof val === "object" && Array.isArra
 const isString = (v) => typeof v === "string";
 const isIterable = (v) => isDefined(v) && isFunction(v[Symbol.iterator]);
 //#endregion
-//#region src/utils/regular-expression.ts
-/**
-* Utility function that will escape all regular expression special characters in a string.
-*
-* @param text The string potentially containing special characters.
-* @returns The string with all special characters escaped.
-*/
-const escapeRegExpSpecialCharacters = (text) => {
-	return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-};
-//#endregion
-export { VALID_CONFIG_OUTPUT_TARGETS as $, DEFAULT_STYLE_MODE as A, HOST_FLAGS as B, ASSETS as C, COLLECTION_MANIFEST_FILE_NAME as D, COLLECTION_APP_DATA_FILE_NAME as E, DOCS_README as F, NODE_TYPES as G, LISTENER_FLAGS as H, DOCS_VSCODE as I, STANDALONE as J, SSR as K, EVENT_FLAGS as L, DOCS_CUSTOM as M, DOCS_CUSTOM_ELEMENTS_MANIFEST as N, COPY as O, DOCS_JSON as P, TYPES as Q, GENERATED_DTS as R, queryNonceMetaTagContent as S, COLLECTION as T, LOADER_BUNDLE as U, HTML_NS as V, MEMBER_FLAGS as W, STYLE_EXT as X, STATS as Y, SVG_NS as Z, sortBy as _, fromEntries as a, toTitleCase as b, isDef as c, isNumber as d, WATCH_FLAGS as et, isObject as f, pluck as g, noop as h, flatOne as i, DIST_LAZY as j, CUSTOM as k, isFunction as l, mergeIntoWith as m, dashToPascalCase as n, XLINK_NS as nt, isBoolean as o, isString as p, SSR_WASM as q, escapeWithPattern as r, isComplexType as s, escapeRegExpSpecialCharacters as t, WWW as tt, isIterable as u, toCamelCase as v, CMP_FLAGS as w, unique as x, toDashCase as y, GLOBAL_STYLE as z };
+export { VALID_CONFIG_OUTPUT_TARGETS as $, DIST_LAZY as A, HOST_FLAGS as B, CMP_FLAGS as C, COPY as D, COLLECTION_MANIFEST_FILE_NAME as E, DOCS_README as F, NODE_TYPES as G, LISTENER_FLAGS as H, DOCS_VSCODE as I, STANDALONE as J, SSR as K, EVENT_FLAGS as L, DOCS_CUSTOM as M, DOCS_CUSTOM_ELEMENTS_MANIFEST as N, CUSTOM as O, DOCS_JSON as P, TYPES as Q, GENERATED_DTS as R, ASSETS as S, COLLECTION_APP_DATA_FILE_NAME as T, LOADER_BUNDLE as U, HTML_NS as V, MEMBER_FLAGS as W, STYLE_EXT as X, STATS as Y, SVG_NS as Z, toCamelCase as _, isBoolean as a, unique as b, isFunction as c, isObject as d, WATCH_FLAGS as et, isString as f, sortBy as g, pluck as h, fromEntries as i, DOCS_AGENT_SKILL as j, DEFAULT_STYLE_MODE as k, isIterable as l, noop as m, escapeWithPattern as n, XLINK_NS as nt, isComplexType as o, mergeIntoWith as p, SSR_WASM as q, flatOne as r, isDef as s, dashToPascalCase as t, WWW as tt, isNumber as u, toDashCase as v, COLLECTION as w, queryNonceMetaTagContent as x, toTitleCase as y, GLOBAL_STYLE as z };

package/dist/index-BOrz3rbJ.d.mts

@@ -0,0 +1,100 @@
+import { Gn as FunctionalComponent, Qn as VNode, Wn as ErrorHandler, Xn as TagTransformer, Yn as ResolutionHandler, Zn as UserBuildConditionals, a as HostElement, l as PropsType, qn as RafCallback, t as ChildType, u as RuntimeRef } from "./index-RrQfiPWK.mjs";
+//#region src/client/client-build.d.ts
+declare const Build: UserBuildConditionals;
+//#endregion
+//#region src/client/client-log.d.ts
+declare const setErrorHandler: (handler: ErrorHandler) => ErrorHandler;
+//#endregion
+//#region src/client/client-task-queue.d.ts
+declare const readTask: (cb: RafCallback) => void;
+declare const writeTask: (cb: RafCallback) => void;
+//#endregion
+//#region src/client/client-window.d.ts
+declare const setPlatformHelpers: (helpers: {
+  jmp?: (c: any) => any;
+  raf?: (c: any) => number;
+  ael?: (el: any, eventName: string, listener: any, options: any) => void;
+  rel?: (el: any, eventName: string, listener: any, options: any) => void;
+  ce?: (eventName: string, opts?: any) => any;
+}) => 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/fragment.d.ts
+declare const Fragment: FunctionalComponent;
+//#endregion
+//#region src/runtime/mode.d.ts
+declare const setMode: (handler: ResolutionHandler) => number;
+declare const getMode: (ref: RuntimeRef) => string;
+//#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';
+ *
+ * const vnode = (
+ *   <div>
+ *     <h1>Hello, world!</h1>
+ *   </div>
+ * );
+ * render(vnode, document.body);
+ * ```
+ *
+ * @param vnode - The virtual DOM tree to render
+ * @param container - The container element to render the virtual DOM tree to
+ */
+declare function render(vnode: VNode, container: Element): void;
+//#endregion
+//#region src/runtime/tag-transform.d.ts
+/**
+ * Transforms a tag name using the current tag transformer
+ * @param tag - the tag to transform e.g. `my-tag`
+ * @returns the transformed tag e.g. `new-my-tag`
+ */
+declare function transformTag<T extends string>(tag: T): T;
+/**
+ * Sets the tag transformer to be used when rendering custom elements
+ * @param transformer the transformer function to use. Must return a string
+ */
+declare function setTagTransformer(transformer: TagTransformer): void;
+//#endregion
+//#region src/runtime/update-component.d.ts
+declare const getRenderingRef: () => any;
+declare const forceUpdate: (ref: any) => boolean;
+//#endregion
+//#region src/runtime/vdom/h.d.ts
+declare const h: (nodeName: any, vnodeData: PropsType, ...children: ChildType[]) => VNode;
+declare const Host: {};
+//#endregion
+//#region src/runtime/vdom/jsx-runtime.d.ts
+declare function jsx(type: any, props: any, key?: string): VNode;
+/**
+ * @alias
+ */
+declare const jsxs: typeof jsx;
+/**
+ * @alias
+ */
+declare const jsxDEV: typeof jsx;
+//#endregion
+export { readTask as _, h as a, Build as b, setTagTransformer as c, getMode as d, setMode as f, setPlatformHelpers as g, getShadowRoot as h, Host as i, transformTag as l, getElement as m, jsxDEV as n, forceUpdate as o, Fragment as p, jsxs as r, getRenderingRef as s, jsx as t, render as u, writeTask as v, setErrorHandler as y };

package/dist/{index-xAkMgLX_.d.ts → index-DnISpqrd.d.ts}

@@ -1,3 +1,5 @@
+import "rolldown";
+import "typescript";
 //#region src/declarations/stencil-public-runtime.d.ts
 interface ElementDecorator {
   (): PropertyDecorator;
@@ -41,6 +43,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;
@@ -66,14 +89,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.
    *
@@ -96,6 +123,36 @@ 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>;
+}
 /**
  * Minimal interface matched by signal objects (from @stencil/core/signals).
  * Used in JSX attribute types.
@@ -434,6 +491,7 @@ declare namespace JSXBase {
     onClose?: (event: Event) => void;
     open?: boolean;
     returnValue?: string;
+    closedby?: 'any' | 'closerequest' | 'none';
   }
   interface EmbedHTMLAttributes<T> extends HTMLAttributes<T> {
     height?: number | string;
@@ -471,6 +529,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';
@@ -493,6 +553,8 @@ 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';
@@ -592,6 +654,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 +779,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;
@@ -830,7 +896,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;
@@ -1295,6 +1364,8 @@ interface BuildFeatures {
   shadowDelegatesFocus: boolean;
   shadowModeClosed: boolean;
   shadowSlotAssignmentManual: boolean;
+  shadowClonable: boolean;
+  shadowSerializable: boolean;
   scoped: boolean;
   /**
    * Every component has a render function
@@ -1311,6 +1382,8 @@ interface BuildFeatures {
   vdomKey: boolean;
   vdomListener: boolean;
   vdomPropOrAttr: boolean;
+  /** True when at least one component uses the explicit `attr:`/`prop:` JSX prefix. */
+  vdomPropOrAttrPrefix: boolean;
   vdomRef: boolean;
   vdomStyle: boolean;
   vdomText: boolean;
@@ -1501,6 +1574,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>;
 }
 /**
@@ -1540,6 +1622,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
@@ -1592,7 +1679,7 @@ 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 `lightDomPatches` flag enabled,
@@ -1717,10 +1804,26 @@ interface PatchedSlotNode extends Node {
   __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
  */
@@ -1823,6 +1926,11 @@ 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;
@@ -1858,6 +1966,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)[];
@@ -1867,6 +1990,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 {
   /**
@@ -1911,6 +2039,18 @@ interface PlatformRuntime {
   ce: (eventName: string, opts?: any) => CustomEvent;
 }
 type ChildType = VNode | number | string;
+type PropsType = VNodeProdData | number | string | null;
+interface VNodeProdData {
+  key?: string | number;
+  class?: {
+    [className: string]: boolean;
+  } | string;
+  className?: {
+    [className: string]: boolean;
+  } | string;
+  style?: any;
+  [key: string]: any;
+}
 //#endregion
 //#region src/app-data/index.d.ts
 /**
@@ -1939,4 +2079,4 @@ declare const BUILD: BuildConditionals;
 declare const Env: {};
 declare const NAMESPACE: string;
 //#endregion
-export { VNode as S, FunctionalComponent as _, ComponentConstructor as a, ResolutionHandler as b, ComponentRuntimeMeta as c, HostRef as d, LazyBundlesRuntimeData as f, CustomElementsDefineOptions as g, RuntimeRef as h, ChildType as i, ComponentRuntimeMetaCompact as l, RenderNode as m, Env as n, ComponentConstructorChangeHandlers as o, PlatformRuntime as p, NAMESPACE as r, ComponentRuntimeHostListener as s, BUILD as t, HostElement as u, HTMLStencilElement as v, TagTransformer as x, JSXBase as y };
+export { ReactiveControllerHostInterface as C, VNode as E, MixedInCtor as S, TagTransformer as T, ComponentInterface as _, ComponentConstructor as a, HTMLStencilElement as b, ComponentRuntimeMeta as c, HostRef as d, LazyBundlesRuntimeData as f, RuntimeRef as g, RenderNode as h, ChildType as i, ComponentRuntimeMetaCompact as l, PropsType as m, Env as n, ComponentConstructorChangeHandlers as o, PlatformRuntime as p, NAMESPACE as r, ComponentRuntimeHostListener as s, BUILD as t, HostElement as u, CustomElementsDefineOptions as v, ResolutionHandler as w, JSXBase as x, FunctionalComponent as y };