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

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

@@ -20,6 +20,11 @@ interface ComponentCompilerPropertyComplexType {
    * annotation in the original source file.
    */
   references: ComponentCompilerTypeReferences;
+  /**
+   * @internal TypeScript AST node used for semantic type analysis during compilation.
+   * Not serialized, only used internally for improved type renaming logic.
+   */
+  _astNode?: any;
 }
 /**
  * A record of `ComponentCompilerTypeReference` entities.
@@ -90,6 +95,11 @@ interface ComponentCompilerMethodComplexType {
   parameters: JsonDocMethodParameter[];
   references: ComponentCompilerTypeReferences;
   return: string;
+  /**
+   * @internal TypeScript AST method node used for semantic type analysis during compilation.
+   * Not serialized, only used internally for improved type renaming logic.
+   */
+  _astNode?: any;
 }
 //#endregion
 //#region src/declarations/stencil-public-docs.d.ts

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

@@ -55,6 +55,28 @@ interface ComponentOptions {
    * Array of relative links to folders of assets required by the component.
    */
   assetsDirs?: string[];
+  /**
+   * Relative URL to an external stylesheet providing document-level styles for this component.
+   * Unlike `styleUrl`, these styles are not scoped to shadow/scoped DOM - they are collected
+   * at build time and injected wherever `@import "stencil-globals"` appears in a global stylesheet.
+   *
+   * Useful for
+   * - pre-first-js-render styles (combatting cumulative layout shift)
+   * - host element and slotted content style
+   * - 'css-only' CEs - those that don't use a JS runtime at all
+   *
+   * @example
+   * ```tsx
+   * @Component({ tag: 'my-button', globalStyleUrl: './my-button.global.css' })
+   * ```
+   */
+  globalStyleUrl?: string;
+  /**
+   * Inline CSS string providing document-level styles for this component.
+   * Collected at build time and injected wherever `@import "stencil-globals"` appears.
+   * @see globalStyleUrl
+   */
+  globalStyle?: string;
 }
 /**
  * Shadow DOM encapsulation options for the `encapsulation` property.
@@ -83,7 +105,7 @@ interface ShadowEncapsulation {
 }
 /**
  * Patch types for non-shadow DOM components that use slots.
- * - `'all'`: Apply all slot-related patches (equivalent to `experimentalSlotFixes`)
+ * - `'all'`: Apply all slot-related patches (equivalent to `lightDomPatches: true`)
  * - `'children'`: Patch child node accessors (children, firstChild, lastChild, etc.)
  * - `'clone'`: Patch `cloneNode()` to handle slotted content
  * - `'insert'`: Patch `appendChild()`, `insertBefore()`, etc. for slot relocation
@@ -535,15 +557,16 @@ declare function setTagTransformer(transformer: TagTransformer): void;
  * @returns the transformed tag e.g. `new-my-tag`
  */
 declare function transformTag(tag: string): string;
+type MixinFactory = (base: MixedInCtor) => MixedInCtor;
 /**
- * @deprecated - Use `MixedInCtor` instead:
+ * 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 MixinFactory = (base: MixedInCtor) => MixedInCtor;
 type MixedInCtor<T = {}> = new (...args: any[]) => T;
 /**
  * Compose multiple mixin classes into a single constructor.
@@ -684,13 +707,21 @@ interface QueueApi {
   clear?: () => void;
   flush?: (cb?: () => void) => 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;
+}
 /**
  * Host
  */
 interface HostAttributes {
   class?: string | {
     [className: string]: boolean;
-  };
+  } | SignalRef<string>;
   style?: {
     [key: string]: string | undefined;
   };
@@ -738,7 +769,7 @@ interface FunctionalUtilities {
   map: (children: VNode[], cb: (vnode: ChildNode, index: number, array: ChildNode[]) => ChildNode) => 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
@@ -749,7 +780,7 @@ interface FunctionalComponent<T = {}> {
  * {@link FunctionalUtilities}).
  */
 interface ChildNode {
-  vtag?: string | number | Function;
+  vtag?: string | number | Function | symbol | null;
   vkey?: string | number;
   vtext?: string;
   vchildren?: VNode[];
@@ -762,11 +793,11 @@ interface ChildNode {
  *
  * For further information: https://stenciljs.com/docs/host-element
  */
-declare const Host: FunctionalComponent<HostAttributes>;
+declare const Host: (props: HostAttributes) => VNode;
 /**
  * Fragment
  */
-declare const Fragment: FunctionalComponent<{}>;
+declare const Fragment: (props: {}) => VNode;
 /**
  * The "h" namespace is used to import JSX types for elements and attributes.
  * It is imported in order to avoid conflicting global JSX issues.
@@ -782,6 +813,7 @@ declare namespace h {
   function h(sel: any, data: VNodeData | null, children: VNode): VNode;
   function h(sel: any, data: VNodeData | null, ...children: (VNode | string | number)[]): VNode;
   namespace JSX {
+    type Element = VNode;
     interface IntrinsicElements extends LocalJSX.IntrinsicElements, JSXBase.IntrinsicElements {
       [tagName: string]: any;
     }
@@ -818,13 +850,15 @@ declare function jsxs(type: any, props: any, key?: string): VNode;
  */
 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;
 }
 interface VNodeData {
   class?: {
@@ -1471,7 +1505,7 @@ declare namespace JSXBase {
     autofocus?: boolean | string;
     class?: string | {
       [className: string]: boolean;
-    };
+    } | SignalRef<string>;
     contentEditable?: boolean | string;
     contenteditable?: boolean | string;
     contextMenu?: string;
@@ -1530,7 +1564,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;
@@ -1931,10 +1965,13 @@ declare namespace JSXBase {
 interface JSXAttributes<T = Element> {
   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;
@@ -1942,4 +1979,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, MixinFactory, ModeStyles, NoneEncapsulation, Prop, PropDecorator, PropOptions, PropSerialize, PropSerializeDecorator, QueueApi, RafCallback, ResolutionHandler, ResolveVarFunction, ScopedEncapsulation, ShadowEncapsulation, ShadowRootOptions, 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, 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 };

package/dist/{index-D61XZw0f.d.ts → index-BuveMLxy.d.ts}

@@ -96,6 +96,14 @@ interface ComponentInterface {
   render?(): any;
   [memberName: string]: any;
 }
+/**
+ * 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
@@ -137,7 +145,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
@@ -148,7 +156,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[];
@@ -160,13 +168,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 {
@@ -802,7 +812,7 @@ declare namespace JSXBase {
     autofocus?: boolean | string;
     class?: string | {
       [className: string]: boolean;
-    };
+    } | SignalRef<string>;
     contentEditable?: boolean | string;
     contenteditable?: boolean | string;
     contextMenu?: string;
@@ -861,7 +871,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;
@@ -1262,10 +1272,13 @@ declare namespace JSXBase {
 interface JSXAttributes<T = Element$1> {
   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;
@@ -1302,6 +1315,7 @@ interface BuildFeatures {
   vdomStyle: boolean;
   vdomText: boolean;
   vdomXlink: boolean;
+  vdomSignals: boolean;
   slotRelocation: boolean;
   patchAll: boolean;
   patchChildren: boolean;
@@ -1348,20 +1362,27 @@ interface BuildConditionals extends Partial<BuildFeatures> {
   lazyLoad?: boolean;
   profile?: boolean;
   constructableCSS?: boolean;
-  appendChildSlotFix?: boolean;
-  slotChildNodesFix?: boolean;
-  scopedSlotTextContentFix?: boolean;
-  cloneNodeFix?: boolean;
+  /** True when `compat.lightDomPatches === true` - enables `applyLightDomPatches` shortcut. */
+  lightDomPatches?: boolean;
+  /** Patch `childNodes`/`children` getters on light-dom slotted components. */
+  slotChildNodes?: boolean;
+  /** Patch `cloneNode()` on light-dom slotted components. */
+  slotCloneNode?: boolean;
+  /** Patch `appendChild`/`insertBefore`/`removeChild` on light-dom slotted components. */
+  slotDomMutations?: boolean;
+  /** Patch `textContent` on light-dom slotted components. */
+  slotTextContent?: boolean;
   hydratedAttribute?: boolean;
   hydratedClass?: boolean;
   hydratedSelectorName?: string;
+  /** True when a global-style input contains `@import "stencil-hydrate"` - suppresses dynamic style injection in the loader. */
+  staticHydrationStyles?: boolean;
   initializeNextTick?: boolean;
-  shadowDomShim?: boolean;
   asyncQueue?: boolean;
   additionalTagTransformers?: boolean | 'prod';
-  attachStyles?: boolean;
-  experimentalSlotFixes?: boolean;
-  experimentalScopedSlotChanges?: boolean;
+  signalBacking?: boolean;
+  /** True when JSX signal bypass is active - text nodes and attributes backed by Signal objects update the DOM directly. Auto-enabled when `signalBacking: true`. */
+  vdomSignals?: boolean;
 }
 interface ComponentConstructor {
   is?: string;
@@ -1426,7 +1447,7 @@ interface HostElement extends HTMLElement {
   disconnectedCallback?: () => void;
   host?: Element;
   forceUpdate?: () => void;
-  __stencil__getHostRef?: () => HostRef;
+  __s_ghr?: () => HostRef;
   /**
    * Unique stencil id for this element
    */
@@ -1574,61 +1595,61 @@ interface RenderNode extends HostElement {
   ['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;
@@ -1666,31 +1687,31 @@ 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;
@@ -1791,7 +1812,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
@@ -1802,6 +1823,9 @@ interface HostRef {
   $cmpMeta$: ComponentRuntimeMeta;
   $hostElement$: HostElement;
   $instanceValues$?: Map<string, any>;
+  $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;
   /**
@@ -1888,4 +1912,31 @@ interface PlatformRuntime {
 }
 type ChildType = VNode | number | string;
 //#endregion
-export { JSXBase as _, ComponentRuntimeHostListener as a, VNode as b, HostElement as c, PlatformRuntime as d, RenderNode as f, HTMLStencilElement as g, FunctionalComponent as h, ComponentConstructorChangeHandlers as i, HostRef as l, CustomElementsDefineOptions as m, ChildType as n, ComponentRuntimeMeta as o, RuntimeRef as p, ComponentConstructor as r, ComponentRuntimeMetaCompact as s, BuildConditionals as t, LazyBundlesRuntimeData as u, ResolutionHandler as v, TagTransformer as y };
+//#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
+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 };