@stencil/core 4.43.2 → 5.0.0-next.0

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

@@ -0,0 +1,1277 @@
+//#region src/declarations/stencil-public-runtime.d.ts
+interface UserBuildConditionals {
+  isDev: boolean;
+  isBrowser: boolean;
+  isServer: boolean;
+  isTesting: boolean;
+}
+type ResolutionHandler = (elm: HTMLElement) => string | undefined | null;
+type ErrorHandler = (err: any, element?: HTMLElement) => void;
+type TagTransformer = (tag: string) => string;
+interface ComponentInterface {
+  connectedCallback?(): void;
+  disconnectedCallback?(): void;
+  componentWillRender?(): Promise<void> | void;
+  componentDidRender?(): void;
+  /**
+   * The component is about to load and it has not
+   * rendered yet.
+   *
+   * This is the best place to make any data updates
+   * before the first render.
+   *
+   * componentWillLoad will only be called once.
+   */
+  componentWillLoad?(): Promise<void> | void;
+  /**
+   * The component has loaded and has already rendered.
+   *
+   * Updating data in this method will cause the
+   * component to re-render.
+   *
+   * componentDidLoad will only be called once.
+   */
+  componentDidLoad?(): void;
+  /**
+   * A `@Prop` or `@State` property changed and a rerender is about to be requested.
+   *
+   * Called multiple times throughout the life of
+   * the component as its properties change.
+   *
+   * componentShouldUpdate is not called on the first render.
+   */
+  componentShouldUpdate?(newVal: any, oldVal: any, propName: string): boolean | void;
+  /**
+   * The component is about to update and re-render.
+   *
+   * Called multiple times throughout the life of
+   * the component as it updates.
+   *
+   * componentWillUpdate is not called on the first render.
+   */
+  componentWillUpdate?(): Promise<void> | void;
+  /**
+   * The component has just re-rendered.
+   *
+   * Called multiple times throughout the life of
+   * the component as it updates.
+   *
+   * componentWillUpdate is not called on the
+   * first render.
+   */
+  componentDidUpdate?(): void;
+  render?(): any;
+  [memberName: string]: any;
+}
+/**
+ * Utilities for working with functional Stencil components. An object
+ * conforming to this interface is passed by the Stencil runtime as the third
+ * argument to a functional component, allowing component authors to work with
+ * features like children.
+ *
+ * The children of a functional component will be passed as the second
+ * argument, so a functional component which uses these utils to transform its
+ * children might look like the following:
+ *
+ * ```ts
+ * export const AddClass: FunctionalComponent = (_, children, utils) => (
+ *  utils.map(children, child => ({
+ *    ...child,
+ *    vattrs: {
+ *      ...child.vattrs,
+ *      class: `${child.vattrs.class} add-class`
+ *    }
+ *  }))
+ * );
+ * ```
+ *
+ * For more see the Stencil documentation, here:
+ * https://stenciljs.com/docs/functional-components
+ */
+interface FunctionalUtilities {
+  /**
+   * Utility for reading the children of a functional component at runtime.
+   * Since the Stencil runtime uses a different interface for children it is
+   * not recommended to read the children directly, and is preferable to use
+   * this utility to, for instance, perform a side effect for each child.
+   */
+  forEach: (children: VNode[], cb: (vnode: ChildNode$1, index: number, array: ChildNode$1[]) => void) => void;
+  /**
+   * Utility for transforming the children of a functional component. Given an
+   * array of children and a callback this will return a list of the results of
+   * passing each child to the supplied callback.
+   */
+  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;
+}
+/**
+ * A Child VDOM node
+ *
+ * This has most of the same properties as {@link VNode} but friendlier names
+ * (i.e. `vtag` instead of `$tag$`, `vchildren` instead of `$children$`) in
+ * order to provide a friendlier public interface for users of the
+ * {@link FunctionalUtilities}).
+ */
+interface ChildNode$1 {
+  vtag?: string | number | Function;
+  vkey?: string | number;
+  vtext?: string;
+  vchildren?: VNode[];
+  vattrs?: any;
+  vname?: string;
+}
+/**
+ * A virtual DOM node
+ */
+interface VNode {
+  $flags$: number;
+  $tag$: string | number | Function;
+  $elm$: any;
+  $text$: string;
+  $children$: VNode[];
+  $attrs$?: any;
+  $name$?: string;
+  $key$?: string | number;
+}
+interface CustomElementsDefineOptions {
+  exclude?: string[];
+  syncQueue?: boolean;
+  /** @deprecated in-favour of `setTagTransformer` and `transformTag` */
+  transformTagName?: (tagName: string) => string;
+  jmp?: (c: Function) => any;
+  raf?: (c: FrameRequestCallback) => number;
+  ael?: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
+  rel?: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
+  ce?: (eventName: string, opts?: any) => CustomEvent;
+}
+//#endregion
+//#region src/declarations/stencil-public-compiler.d.ts
+interface HydrateDocumentOptions {
+  /**
+   * Build ID that will be added to `<html data-stencil-build="BUILD_ID">`. By default
+   * a random ID will be generated
+   */
+  buildId?: string;
+  /**
+   * Sets the `href` attribute on the `<link rel="canonical">`
+   * tag within the `<head>`. If the value is not defined it will
+   * ensure a canonical link tag is no included in the `<head>`.
+   */
+  canonicalUrl?: string;
+  /**
+   * Include the HTML comments and attributes used by the client-side
+   * JavaScript to read the structure of the HTML and rebuild each
+   * component. Defaults to `true`.
+   */
+  clientHydrateAnnotations?: boolean;
+  /**
+   * Constrain `setTimeout()` to 1ms, but still async. Also
+   * only allows `setInterval()` to fire once, also constrained to 1ms.
+   * Defaults to `true`.
+   */
+  constrainTimeouts?: boolean;
+  /**
+   * Sets `document.cookie`
+   */
+  cookie?: string;
+  /**
+   * Sets the `dir` attribute on the top level `<html>`.
+   */
+  direction?: string;
+  /**
+   * Component tag names listed here will not be prerendered, nor will
+   * hydrated on the client-side. Components listed here will be ignored
+   * as custom elements and treated no differently than a `<div>`.
+   */
+  excludeComponents?: string[];
+  /**
+   * Sets the `lang` attribute on the top level `<html>`.
+   */
+  language?: string;
+  /**
+   * Maximum number of components to hydrate on one page. Defaults to `300`.
+   */
+  maxHydrateCount?: number;
+  /**
+   * Sets `document.referrer`
+   */
+  referrer?: string;
+  /**
+   * Removes every `<script>` element found in the `document`. Defaults to `false`.
+   */
+  removeScripts?: boolean;
+  /**
+   * Removes CSS not used by elements within the `document`. Defaults to `true`.
+   */
+  removeUnusedStyles?: boolean;
+  /**
+   * The url the runtime uses for the resources, such as the assets directory.
+   */
+  resourcesUrl?: string;
+  /**
+   * Prints out runtime console logs to the NodeJS process. Defaults to `false`.
+   */
+  runtimeLogging?: boolean;
+  /**
+   * Component tags listed here will only be prerendered or server-side-rendered
+   * and will not be client-side hydrated. This is useful for components that
+   * are not dynamic and do not need to be defined as a custom element within the
+   * browser. For example, a header or footer component would be a good example that
+   * may not require any client-side JavaScript.
+   */
+  staticComponents?: string[];
+  /**
+   * The amount of milliseconds to wait for a page to finish rendering until
+   * a timeout error is thrown. Defaults to `15000`.
+   */
+  timeout?: number;
+  /**
+   * Sets `document.title`.
+   */
+  title?: string;
+  /**
+   * Sets `location.href`
+   */
+  url?: string;
+  /**
+   * Sets `navigator.userAgent`
+   */
+  userAgent?: string;
+  /**
+   * Configure how Stencil serializes the components shadow root.
+   * - If set to `declarative-shadow-dom` the component will be rendered within a Declarative Shadow DOM.
+   * - If set to `scoped` Stencil will render the contents of the shadow root as a `scoped: true` component
+   *   and the shadow DOM will be created during client-side hydration.
+   * - Alternatively you can mix and match the two by providing an object with `declarative-shadow-dom` and `scoped` keys,
+   * the value arrays containing the tag names of the components that should be rendered in that mode.
+   *
+   * Examples:
+   * - `{ 'declarative-shadow-dom': ['my-component-1', 'another-component'], default: 'scoped' }`
+   * Render all components as `scoped` apart from `my-component-1` and `another-component`
+   * -  `{ 'scoped': ['an-option-component'], default: 'declarative-shadow-dom' }`
+   * Render all components within `declarative-shadow-dom` apart from `an-option-component`
+   * - `'scoped'` Render all components as `scoped`
+   * - `false` disables shadow root serialization
+   *
+   * *NOTE* `true` has been deprecated in favor of `declarative-shadow-dom` and `scoped`
+   * @default 'declarative-shadow-dom'
+   */
+  serializeShadowRoot?: 'declarative-shadow-dom' | 'scoped' | {
+    'declarative-shadow-dom'?: string[];
+    scoped?: string[];
+    default: 'declarative-shadow-dom' | 'scoped';
+  } | boolean;
+}
+interface SerializeDocumentOptions extends HydrateDocumentOptions {
+  /**
+   * Runs after the `document` has been hydrated.
+   */
+  afterHydrate?(document: any): any | Promise<any>;
+  /**
+   * Sets an approximate line width the HTML should attempt to stay within.
+   * Note that this is "approximate", in that HTML may often not be able
+   * to be split at an exact line width. Additionally, new lines created
+   * is where HTML naturally already has whitespace, such as before an
+   * attribute or spaces between words. Defaults to `100`.
+   */
+  approximateLineWidth?: number;
+  /**
+   * Runs before the `document` has been hydrated.
+   */
+  beforeHydrate?(document: any): any | Promise<any>;
+  /**
+   * Format the HTML in a nicely indented format.
+   * Defaults to `false`.
+   */
+  prettyHtml?: boolean;
+  /**
+   * Remove quotes from attribute values when possible.
+   * Defaults to `true`.
+   */
+  removeAttributeQuotes?: boolean;
+  /**
+   * Remove the `=""` from standardized `boolean` attributes,
+   * such as `hidden` or `checked`. Defaults to `true`.
+   */
+  removeBooleanAttributeQuotes?: boolean;
+  /**
+   * Remove these standardized attributes when their value is empty:
+   * `class`, `dir`, `id`, `lang`, and `name`, `title`. Defaults to `true`.
+   */
+  removeEmptyAttributes?: boolean;
+  /**
+   * Remove HTML comments. Defaults to `true`.
+   */
+  removeHtmlComments?: boolean;
+  /**
+   * The `fullDocument` flag determines the format of the rendered output. Set it to true to
+   * generate a complete HTML document, or false to render only the component.
+   * @default true
+   */
+  fullDocument?: boolean;
+  /**
+   * Style modes to render the component in.
+   * @see https://stenciljs.com/docs/styling#style-modes
+   */
+  modes?: ResolutionHandler[];
+}
+interface HydrateFactoryOptions extends SerializeDocumentOptions {
+  serializeToHtml: boolean;
+  destroyWindow: boolean;
+  destroyDocument: boolean;
+}
+interface Diagnostic {
+  absFilePath?: string | undefined;
+  code?: string;
+  columnNumber?: number | undefined;
+  debugText?: string;
+  header?: string;
+  language?: string;
+  level: 'error' | 'warn' | 'info' | 'log' | 'debug';
+  lineNumber?: number | undefined;
+  lines: PrintLine[];
+  messageText: string;
+  relFilePath?: string | undefined;
+  type: string;
+}
+//#endregion
+//#region src/declarations/stencil-private.d.ts
+interface PrintLine {
+  lineIndex: number;
+  lineNumber: number;
+  text: string;
+  errorCharStart: number;
+  errorLength?: number;
+}
+interface BuildFeatures {
+  style: boolean;
+  mode: boolean;
+  formAssociated: boolean;
+  shadowDom: boolean;
+  shadowDelegatesFocus: boolean;
+  shadowSlotAssignmentManual: boolean;
+  scoped: boolean;
+  /**
+   * Every component has a render function
+   */
+  allRenderFn: boolean;
+  /**
+   * At least one component has a render function
+   */
+  hasRenderFn: boolean;
+  vdomRender: boolean;
+  vdomAttribute: boolean;
+  vdomClass: boolean;
+  vdomFunctional: boolean;
+  vdomKey: boolean;
+  vdomListener: boolean;
+  vdomPropOrAttr: boolean;
+  vdomRef: boolean;
+  vdomStyle: boolean;
+  vdomText: boolean;
+  vdomXlink: boolean;
+  slotRelocation: boolean;
+  slot: boolean;
+  svg: boolean;
+  element: boolean;
+  event: boolean;
+  hostListener: boolean;
+  hostListenerTargetWindow: boolean;
+  hostListenerTargetDocument: boolean;
+  hostListenerTargetBody: boolean;
+  /**
+   * @deprecated Prevented from new apps, but left in for older collections
+   */
+  hostListenerTargetParent: boolean;
+  hostListenerTarget: boolean;
+  method: boolean;
+  prop: boolean;
+  propChangeCallback: boolean;
+  propMutable: boolean;
+  state: boolean;
+  member: boolean;
+  updatable: boolean;
+  propBoolean: boolean;
+  propNumber: boolean;
+  propString: boolean;
+  serializer: boolean;
+  deserializer: boolean;
+  lifecycle: boolean;
+  asyncLoading: boolean;
+  observeAttribute: boolean;
+  reflect: boolean;
+  taskQueue: boolean;
+}
+interface BuildConditionals extends Partial<BuildFeatures> {
+  hotModuleReplacement?: boolean;
+  isDebug?: boolean;
+  isTesting?: boolean;
+  isDev?: boolean;
+  devTools?: boolean;
+  invisiblePrehydration?: boolean;
+  hydrateServerSide?: boolean;
+  hydrateClientSide?: boolean;
+  lifecycleDOMEvents?: boolean;
+  cssAnnotations?: boolean;
+  lazyLoad?: boolean;
+  profile?: boolean;
+  constructableCSS?: boolean;
+  appendChildSlotFix?: boolean;
+  slotChildNodesFix?: boolean;
+  scopedSlotTextContentFix?: boolean;
+  cloneNodeFix?: boolean;
+  hydratedAttribute?: boolean;
+  hydratedClass?: boolean;
+  hydratedSelectorName?: string;
+  initializeNextTick?: boolean;
+  shadowDomShim?: boolean;
+  asyncQueue?: boolean;
+  transformTagName?: boolean;
+  additionalTagTransformers?: boolean | 'prod';
+  attachStyles?: boolean;
+  experimentalSlotFixes?: boolean;
+  experimentalScopedSlotChanges?: boolean;
+  addGlobalStyleToComponents?: boolean;
+}
+interface ComponentConstructor {
+  is?: string;
+  properties?: ComponentConstructorProperties;
+  watchers?: ComponentConstructorChangeHandlers;
+  events?: ComponentConstructorEvent[];
+  listeners?: ComponentConstructorListener[];
+  style?: string;
+  styleId?: string;
+  encapsulation?: ComponentConstructorEncapsulation;
+  observedAttributes?: string[];
+  cmpMeta?: ComponentRuntimeMeta;
+  isProxied?: boolean;
+  isStyleRegistered?: boolean;
+  serializers?: ComponentConstructorChangeHandlers;
+  deserializers?: ComponentConstructorChangeHandlers;
+}
+/**
+ * A mapping from class member names to a list of methods which are watching
+ * them.
+ */
+interface ComponentConstructorChangeHandlers {
+  [propName: string]: {
+    [methodName: string]: number;
+  }[];
+}
+interface ComponentNativeConstructor extends ComponentConstructor {
+  cmpMeta: ComponentRuntimeMeta;
+}
+type ComponentConstructorEncapsulation = 'shadow' | 'scoped' | 'none';
+interface ComponentConstructorProperties {
+  [propName: string]: ComponentConstructorProperty;
+}
+interface ComponentConstructorProperty {
+  attribute?: string;
+  elementRef?: boolean;
+  method?: boolean;
+  mutable?: boolean;
+  reflect?: boolean;
+  state?: boolean;
+  type?: ComponentConstructorPropertyType;
+  watchCallbacks?: string[];
+}
+type ComponentConstructorPropertyType = StringConstructor | BooleanConstructor | NumberConstructor | 'string' | 'boolean' | 'number';
+interface ComponentConstructorEvent {
+  name: string;
+  method: string;
+  bubbles: boolean;
+  cancelable: boolean;
+  composed: boolean;
+}
+interface ComponentConstructorListener {
+  name: string;
+  method: string;
+  capture?: boolean;
+  passive?: boolean;
+}
+/**
+ * An interface extending `HTMLElement` which describes the fields added onto
+ * host HTML elements by the Stencil runtime.
+ */
+interface HostElement extends HTMLElement {
+  connectedCallback?: () => void;
+  attributeChangedCallback?: (attribName: string, oldVal: string, newVal: string, namespace: string) => void;
+  disconnectedCallback?: () => void;
+  host?: Element;
+  forceUpdate?: () => void;
+  __stencil__getHostRef?: () => HostRef;
+  /**
+   * Unique stencil id for this element
+   */
+  ['s-id']?: string;
+  /**
+   * Content Reference:
+   * Reference to the HTML Comment that's placed inside of the
+   * host element's original content. This comment is used to
+   * always represent where host element's light dom is.
+   */
+  ['s-cr']?: RenderNode;
+  /**
+   * Lifecycle ready
+   */
+  ['s-lr']?: boolean;
+  /**
+   * A reference to the `ElementInternals` object for the current host
+   *
+   * This is used for maintaining a reference to the object between HMR
+   * refreshes in the lazy build.
+   *
+   * "stencil-element-internals"
+   */
+  ['s-ei']?: ElementInternals;
+  /**
+   * On Render Callbacks:
+   * Array of callbacks to fire off after it has rendered.
+   */
+  ['s-rc']?: (() => void)[];
+  /**
+   * Scope Id
+   * The scope id of this component when using scoped css encapsulation
+   * or using shadow dom but the browser doesn't support it
+   */
+  ['s-sc']?: string;
+  /**
+   * Scope Ids
+   * All the possible scope ids of this component when using scoped css encapsulation
+   * or using shadow dom but the browser doesn't support it
+   */
+  ['s-scs']?: string[];
+  /**
+   * Hot Module Replacement, dev mode only
+   *
+   * This function should be defined by the HMR-supporting runtime and should
+   * do the work of actually updating the component in-place.
+   */
+  ['s-hmr']?: (versionId: string) => void;
+  /**
+   * A list of nested nested hydration promises that
+   * must be resolved for the top, ancestor component to be fully hydrated
+   */
+  ['s-p']?: Promise<void>[];
+  componentOnReady?: () => Promise<this>;
+}
+interface HydrateResults {
+  buildId: string;
+  diagnostics: Diagnostic[];
+  url: string;
+  host: string | null;
+  hostname: string | null;
+  href: string | null;
+  port: string | null;
+  pathname: string | null;
+  search: string | null;
+  hash: string | null;
+  html: string | null;
+  components: HydrateComponent[];
+  anchors: HydrateAnchorElement[];
+  imgs: HydrateImgElement[];
+  scripts: HydrateScriptElement[];
+  styles: HydrateStyleElement[];
+  staticData: HydrateStaticData[];
+  title: string | null;
+  hydratedCount: number;
+  httpStatus: number | null;
+}
+interface HydrateComponent {
+  tag: string;
+  mode: string;
+  count: number;
+  depth: number;
+}
+interface HydrateElement {
+  [attrName: string]: string | undefined;
+}
+interface HydrateAnchorElement extends HydrateElement {
+  href?: string;
+  target?: string;
+}
+interface HydrateImgElement extends HydrateElement {
+  src?: string;
+}
+interface HydrateScriptElement extends HydrateElement {
+  src?: string;
+  type?: string;
+}
+interface HydrateStyleElement extends HydrateElement {
+  id?: string;
+  href?: string;
+  content?: string;
+}
+interface HydrateStaticData {
+  id: string;
+  type: string;
+  content: string;
+}
+/**
+ * Generic node that represents all of the
+ * different types of nodes we'd see when rendering
+ */
+interface RenderNode extends HostElement {
+  /**
+   * Shadow root's host
+   */
+  host?: Element;
+  /**
+   * On Ref Function:
+   * Callback function to be called when the slotted node ref is ready.
+   */
+  ['s-rf']?: (elm: Element) => unknown;
+  /**
+   * Is initially hidden
+   * Whether this node was originally rendered with the `hidden` attribute.
+   *
+   * Used to reset the `hidden` state of a node during slot relocation.
+   */
+  ['s-ih']?: boolean;
+  /**
+   * Is Content Reference Node:
+   * This node is a content reference node.
+   */
+  ['s-cn']?: boolean;
+  /**
+   * Is a `slot` node when `shadow: false` (or `scoped: true`).
+   *
+   * This is a node (either empty text-node or `<slot-fb>` element)
+   * that represents where a `<slot>` is located in the original JSX.
+   */
+  ['s-sr']?: boolean;
+  /**
+   * Slot name of either the slot itself or the slotted node
+   */
+  ['s-sn']?: string;
+  /**
+   * Host element tag name:
+   * The tag name of the host element that this
+   * node was created in.
+   */
+  ['s-hn']?: string;
+  /**
+   * Slot host tag name:
+   * This is the tag name of the element where this node
+   * has been moved to during slot relocation.
+   *
+   * This allows us to check if the node has been moved and prevent
+   * us from thinking a node _should_ be moved when it may already be in
+   * its final destination.
+   *
+   * This value is set to `undefined` whenever the node is put back into its original location.
+   */
+  ['s-sh']?: string;
+  /**
+   * Original Location Reference:
+   * A reference pointing to the comment
+   * which represents the original location
+   * before it was moved to its slot.
+   */
+  ['s-ol']?: RenderNode;
+  /**
+   * Node reference:
+   * This is a reference from an original location node
+   * back to the node that's been moved around.
+   */
+  ['s-nr']?: PatchedSlotNode | RenderNode;
+  /**
+   * Original Order:
+   * During SSR; a number representing the order of a slotted node
+   */
+  ['s-oo']?: number;
+  /**
+   * Scope Id
+   */
+  ['s-si']?: string;
+  /**
+   * Host Id (hydrate only)
+   */
+  ['s-host-id']?: number;
+  /**
+   * Node Id (hydrate only)
+   */
+  ['s-node-id']?: number;
+  /**
+   * Used to know the components encapsulation.
+   * empty "" for shadow, "c" from scoped
+   */
+  ['s-en']?: '' | /*shadow*/'c';
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * returns the internal `childNodes` of the component
+   */
+  readonly __childNodes?: NodeListOf<ChildNode>;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * returns the internal `children` of the component
+   */
+  readonly __children?: HTMLCollectionOf<Element>;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * returns the internal `firstChild` of the component
+   */
+  readonly __firstChild?: ChildNode;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * returns the internal `lastChild` of the component
+   */
+  readonly __lastChild?: ChildNode;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * returns the internal `textContent` of the component
+   */
+  __textContent?: string;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * gives access to the original `append` method
+   */
+  __append?: (...nodes: (Node | string)[]) => void;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * gives access to the original `prepend` method
+   */
+  __prepend?: (...nodes: (Node | string)[]) => void;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` 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,
+   * 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,
+   * gives access to the original `removeChild` method
+   */
+  __removeChild?: <T extends Node>(child: T) => T;
+}
+interface PatchedSlotNode extends Node {
+  /**
+   * Slot name
+   */
+  ['s-sn']?: string;
+  /**
+   * Original Location Reference:
+   * A reference pointing to the comment
+   * which represents the original location
+   * before it was moved to its slot.
+   */
+  ['s-ol']?: RenderNode;
+  /**
+   * Slot host tag name:
+   * This is the tag name of the element where this node
+   * has been moved to during slot relocation.
+   *
+   * This allows us to check if the node has been moved and prevent
+   * us from thinking a node _should_ be moved when it may already be in
+   * its final destination.
+   *
+   * This value is set to `undefined` whenever the node is put back into its original location.
+   */
+  ['s-sh']?: string;
+  /**
+   * Is a `slot` node when `shadow: false` (or `scoped: true`).
+   *
+   * This is a node (either empty text-node or `<slot-fb>` element)
+   * that represents where a `<slot>` is located in the original JSX.
+   */
+  ['s-sr']?: boolean;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * returns the actual `parentNode` of the component
+   */
+  __parentNode?: RenderNode;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * returns the actual `nextSibling` of the component
+   */
+  __nextSibling?: RenderNode;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * returns the actual `previousSibling` of the component
+   */
+  __previousSibling?: RenderNode;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` flag enabled,
+   * returns the actual `nextElementSibling` of the component
+   */
+  __nextElementSibling?: RenderNode;
+  /**
+   * On a `scoped: true` component
+   * with `experimentalSlotFixes` 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 */{
+  [memberName: string]: ComponentRuntimeMember;
+}?, /** listeners */ComponentRuntimeHostListener[]?, /** watchers */ComponentConstructorChangeHandlers?, /** serializers */ComponentConstructorChangeHandlers?, /** deserializers */ComponentConstructorChangeHandlers?];
+/**
+ * Runtime metadata for a Stencil component
+ */
+interface ComponentRuntimeMeta {
+  /**
+   * This number is used to hold a series of bitflags for various features we
+   * support on components. The flags which this value is intended to store are
+   * documented in the `CMP_FLAGS` enum.
+   */
+  $flags$: number;
+  /**
+   * Just what it says on the tin - the tag name for the component, as set in
+   * the `@Component` decorator.
+   */
+  $tagName$: string;
+  /**
+   * A map of the component's members, which could include fields decorated
+   * with `@Prop`, `@State`, etc as well as methods.
+   */
+  $members$?: ComponentRuntimeMembers;
+  /**
+   * Information about listeners on the component.
+   */
+  $listeners$?: ComponentRuntimeHostListener[];
+  /**
+   * Tuples containing information about `@Prop` fields on the component which
+   * are set to be reflected (i.e. kept in sync) as HTML attributes when
+   * updated.
+   */
+  $attrsToReflect$?: ComponentRuntimeReflectingAttr[];
+  /**
+   * Information about which class members have watchers attached on the component.
+   */
+  $watchers$?: ComponentConstructorChangeHandlers;
+  /**
+   * A bundle ID used for lazy loading.
+   */
+  $lazyBundleId$?: string;
+  /**
+   * Information about which class members have prop > attribute serializers attached on the component.
+   */
+  $serializers$?: ComponentConstructorChangeHandlers;
+  /**
+   * Information about which class members have attribute > prop deserializers attached on the component.
+   */
+  $deserializers$?: ComponentConstructorChangeHandlers;
+}
+/**
+ * A mapping of the names of members on the component to some runtime-specific
+ * information about them.
+ */
+interface ComponentRuntimeMembers {
+  [memberName: string]: ComponentRuntimeMember;
+}
+/**
+ * A tuple with information about a class member that's relevant at runtime.
+ * The fields are:
+ *
+ * 1. A number used to hold bitflags for component members. The bit flags which
+ * this is intended to store are documented in the `MEMBER_FLAGS` enum.
+ * 2. The attribute name to observe.
+ */
+type ComponentRuntimeMember = [number, string?];
+/**
+ * A tuple holding information about a host listener which is relevant at
+ * runtime. The field are:
+ *
+ * 1. A number used to hold bitflags for listeners. The bit flags which this is
+ * intended to store are documented in the `LISTENER_FLAGS` enum.
+ * 2. The event name.
+ * 3. The method name.
+ */
+type ComponentRuntimeHostListener = [number, string, string];
+/**
+ * A tuple containing information about props which are "reflected" at runtime,
+ * meaning that HTML attributes on the component instance are kept in sync with
+ * the prop value.
+ *
+ * The fields are:
+ *
+ * 1. the prop name
+ * 2. the prop attribute.
+ */
+type ComponentRuntimeReflectingAttr = [string, string | undefined];
+/**
+ * A runtime component reference, consistent of either a host element _or_ an
+ * empty object. This is used in particular in a few different places as the
+ * keys in a `WeakMap` which maps {@link HostElement} instances to their
+ * associated {@link HostRef} instance.
+ */
+type RuntimeRef = HostElement | {
+  __stencil__getHostRef?: () => HostRef;
+};
+/**
+ * Interface used to track an Element, it's virtual Node (`VNode`), and other data
+ */
+interface HostRef {
+  $ancestorComponent$?: HostElement;
+  $flags$: number;
+  $cmpMeta$: ComponentRuntimeMeta;
+  $hostElement$: HostElement;
+  $instanceValues$?: Map<string, any>;
+  $serializerValues$?: Map<string, string>;
+  $lazyInstance$?: ComponentInterface;
+  /**
+   * A list of callback functions called immediately after a lazy component module has been fetched.
+   */
+  $fetchedCbList$?: ((elm: HostElement) => void)[];
+  /**
+   * A promise that gets resolved if `BUILD.asyncLoading` is enabled and after the `componentDidLoad`
+   * and before the `componentDidUpdate` lifecycle events are triggered.
+   */
+  $onReadyPromise$?: Promise<HostElement>;
+  /**
+   * A callback which resolves {@link HostRef.$onReadyPromise$}
+   * @param elm host element
+   */
+  $onReadyResolve$?: (elm: HostElement) => void;
+  /**
+   * A promise which resolves with the host component once it has finished rendering
+   * for the first time. This is primarily used to wait for the first `update` to be
+   * called on a component.
+   */
+  $onInstancePromise$?: Promise<HostElement>;
+  /**
+   * A callback which resolves {@link HostRef.$onInstancePromise$}
+   * @param elm host element
+   */
+  $onInstanceResolve$?: (elm: HostElement) => void;
+  /**
+   * A promise which resolves when the component has finished rendering for the first time.
+   * It is called after {@link HostRef.$onInstancePromise$} resolves.
+   */
+  $onRenderResolve$?: () => void;
+  $vnode$?: VNode;
+  $queuedListeners$?: [string, any][];
+  $rmListeners$?: (() => void)[];
+  $modeName$?: string;
+  $renderCount$?: number;
+  /**
+   * Defer connectedCallback until after first render for components with slot relocation.
+   */
+  $deferredConnectedCallback$?: boolean;
+}
+interface PlatformRuntime {
+  /**
+   * This number is used to hold a series of bitflags for various features we
+   * support within the runtime. The flags which this value is intended to store are
+   * documented in the {@link PLATFORM_FLAGS} enum.
+   */
+  $flags$: number;
+  /**
+   * Holds a map of nodes to be hydrated.
+   */
+  $orgLocNodes$?: Map<string, RenderNode>;
+  /**
+   * Holds the resource url for given platform environment.
+   */
+  $resourcesUrl$: string;
+  /**
+   * The nonce value to be applied to all script/style tags at runtime.
+   * If `null`, the nonce attribute will not be applied.
+   */
+  $nonce$?: string | null;
+  /**
+   * A utility function that executes a given function and returns the result.
+   * @param c The callback function to execute
+   */
+  jmp: (c: Function) => any;
+  /**
+   * A wrapper for {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/requestAnimationFrame `requestAnimationFrame`}
+   */
+  raf: (c: FrameRequestCallback) => number;
+  /**
+   * A wrapper for {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener `addEventListener`}
+   */
+  ael: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
+  /**
+   * A wrapper for {@link https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/removeEventListener `removeEventListener`}
+   */
+  rel: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
+  /**
+   * A wrapper for creating a {@link https://developer.mozilla.org/docs/Web/API/CustomEvent `CustomEvent`}
+   */
+  ce: (eventName: string, opts?: any) => CustomEvent;
+}
+type StyleMap = Map<string, CSSStyleSheet | string>;
+type ChildType = VNode | number | string;
+//#endregion
+//#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;
+//#endregion
+//#region src/app-data/index.d.ts
+/**
+ * A collection of default build flags for a Stencil project.
+ *
+ * This collection can be found throughout the Stencil codebase, often imported from the `virtual:app-data` module like so:
+ * ```ts
+ * import { BUILD } from 'virtual:app-data';
+ * ```
+ * and is used to determine if a portion of the output of a Stencil _project_'s compilation step can be eliminated.
+ *
+ * e.g. When `BUILD.allRenderFn` evaluates to `false`, the compiler will eliminate conditional statements like:
+ * ```ts
+ * if (BUILD.allRenderFn) {
+ *   // some code that will be eliminated if BUILD.allRenderFn is false
+ * }
+ * ```
+ *
+ * `virtual:app-data`, the module that `BUILD` is imported from, is an alias for the `@stencil/core/runtime/app-data`, and is
+ * partially referenced by {@link STENCIL_APP_DATA_ID}. The `src/compiler/bundle/app-data-plugin.ts` references
+ * `STENCIL_APP_DATA_ID` uses it to replace these defaults with {@link BuildConditionals} that are derived from a
+ * Stencil project's contents (i.e. metadata from the components). This replacement happens at a Stencil project's
+ * compile time. Such code can be found at `src/compiler/app-core/app-data.ts`.
+ */
+declare const BUILD: BuildConditionals;
+declare const Env: {};
+declare const NAMESPACE: string;
+//#endregion
+//#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
+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
+declare const bootstrapLazy: (lazyBundles: LazyBundlesRuntimeData, options?: CustomElementsDefineOptions) => void;
+//#endregion
+//#region src/runtime/connected-callback.d.ts
+declare const connectedCallback: (elm: HostElement) => void;
+//#endregion
+//#region src/runtime/disconnected-callback.d.ts
+declare const disconnectedCallback: (elm: HostElement) => Promise<void>;
+//#endregion
+//#region src/runtime/element.d.ts
+declare const getElement: (ref: any) => HostElement;
+//#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;
+//#endregion
+//#region src/runtime/mixin.d.ts
+type Ctor<T = {}> = new (...args: any[]) => T;
+declare function Mixin(...mixins: ((base: Ctor) => Ctor)[]): Ctor<{}>;
+//#endregion
+//#region src/runtime/mode.d.ts
+declare const setMode: (handler: ResolutionHandler) => number;
+declare const getMode: (ref: RuntimeRef) => string;
+//#endregion
+//#region src/runtime/nonce.d.ts
+/**
+ * Assigns the given value to the nonce property on the runtime platform object.
+ * During runtime, this value is used to set the nonce attribute on all dynamically created script and style tags.
+ * @param nonce The value to be assigned to the platform nonce property.
+ * @returns void
+ */
+declare const setNonce: (nonce: string) => string;
+//#endregion
+//#region src/runtime/parse-property-value.d.ts
+/**
+ * Parse a new property value for a given property type.
+ *
+ * While the prop value can reasonably be expected to be of `any` type as far as TypeScript's type checker is concerned,
+ * it is not safe to assume that the string returned by evaluating `typeof propValue` matches:
+ *   1. `any`, the type given to `propValue` in the function signature
+ *   2. the type stored from `propType`.
+ *
+ * This function provides the capability to parse/coerce a property's value to potentially any other JavaScript type.
+ *
+ * Property values represented in TSX preserve their type information. In the example below, the number 0 is passed to
+ * a component. This `propValue` will preserve its type information (`typeof propValue === 'number'`). Note that is
+ * based on the type of the value being passed in, not the type declared of the class member decorated with `@Prop`.
+ * ```tsx
+ * <my-cmp prop-val={0}></my-cmp>
+ * ```
+ *
+ * HTML prop values on the other hand, will always a string
+ *
+ * @param propValue the new value to coerce to some type
+ * @param propType the type of the prop, expressed as a binary number
+ * @param isFormAssociated whether the component is form-associated (optional)
+ * @returns the parsed/coerced value
+ */
+declare const parsePropertyValue: (propValue: unknown, propType: number, isFormAssociated?: boolean) => any;
+//#endregion
+//#region src/runtime/proxy-component.d.ts
+/**
+ * Attach a series of runtime constructs to a compiled Stencil component
+ * constructor, including getters and setters for the `@Prop` and `@State`
+ * decorators, callbacks for when attributes change, and so on.
+ *
+ * On a lazy loaded component, this is wired up to both the class instance
+ * and the element separately. A `hostRef` keeps the 2 in sync.
+ *
+ * On a traditional component, this is wired up to the element only.
+ *
+ * @param Cstr the constructor for a component that we need to process
+ * @param cmpMeta metadata collected previously about the component
+ * @param flags a number used to store a series of bit flags
+ * @returns a reference to the same constructor passed in (but now mutated)
+ */
+declare const proxyComponent: (Cstr: ComponentConstructor, cmpMeta: ComponentRuntimeMeta, flags: number) => ComponentConstructor;
+//#endregion
+//#region src/runtime/set-value.d.ts
+declare const getValue: (ref: RuntimeRef, propName: string) => any;
+declare const setValue: (ref: RuntimeRef, propName: string, newVal: any, cmpMeta: ComponentRuntimeMeta) => 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 postUpdateComponent: (hostRef: HostRef) => void;
+declare const forceUpdate: (ref: any) => boolean;
+//#endregion
+//#region src/runtime/vdom/h.d.ts
+declare const Host: {};
+//#endregion
+//#region src/runtime/vdom/jsx-dev-runtime.d.ts
+/**
+ * JSX development runtime function for creating elements with debug info.
+ * Called by TypeScript's jsx transform in development mode.
+ *
+ * @param type - The element type (string tag name or functional component)
+ * @param props - The element props (includes children, key, etc.)
+ * @param key - The element's key (passed separately in dev mode)
+ * @param isStaticChildren - Whether children are static (optimization hint)
+ * @param source - Source location information for debugging
+ * @param self - The component instance (for debugging)
+ * @returns A virtual DOM node
+ */
+declare function jsxDEV(type: any, props: any, key?: string | number, _isStaticChildren?: boolean, _source?: any, _self?: any): VNode;
+//#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
+ */
+declare function jsxs(type: any, props: any, key?: string): VNode;
+//#endregion
+//#region src/runtime/vdom/vdom-annotations.d.ts
+/**
+ * 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
+ */
+declare const renderVdom: (hostRef: HostRef, renderFnResults: VNode | VNode[], isInitialLoad?: boolean) => void;
+//#endregion
+//#region src/server/platform/index.d.ts
+declare const cmpModules: Map<string, {
+  [exportName: string]: ComponentConstructor;
+}>;
+declare const loadModule: (cmpMeta: ComponentRuntimeMeta, _hostRef: HostRef, _hmrVersionId?: string) => ComponentConstructor | null;
+declare const isMemberInElement: (elm: any, memberName: string) => boolean;
+declare const registerComponents: (Cstrs: ComponentNativeConstructor[]) => void;
+declare const win: Window & typeof globalThis;
+declare const readTask: (cb: Function) => void;
+declare const writeTask: (cb: Function) => void;
+declare const nextTick: (cb: () => void) => Promise<void>;
+declare const consoleError: ErrorHandler;
+declare const consoleDevError: (..._: any[]) => void;
+declare const consoleDevWarn: (..._: any[]) => void;
+declare const consoleDevInfo: (..._: any[]) => void;
+declare const setErrorHandler: (handler: ErrorHandler) => ErrorHandler;
+declare const plt: PlatformRuntime;
+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;
+declare const supportsShadow: boolean;
+declare const supportsListenerOptions = false;
+declare const supportsConstructableStylesheets = false;
+declare const supportsMutableAdoptedStyleSheets = false;
+declare const getHostRef: (ref: RuntimeRef) => HostRef;
+declare const registerInstance: (lazyInstance: any, hostRef: HostRef) => HostRef;
+declare const registerHost: (elm: HostElement, cmpMeta: ComponentRuntimeMeta) => HostRef;
+declare const Build: UserBuildConditionals;
+declare const styles: StyleMap;
+declare const modeResolutionChain: ResolutionHandler[];
+/**
+ * Checks to see any components are rendered with `scoped`
+ * @param opts - SSR options
+ */
+declare const setScopedSSR: (opts: HydrateFactoryOptions) => 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, jsxDEV, 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 };