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

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 };