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

package/dist/declarations/stencil-public-compiler.js

@@ -29,7 +29,7 @@ const LOG_LEVELS = [
 /**
 * The collection of valid export behaviors.
 * Used to generate a type for typed configs as well as output target validation
-* for the `dist-custom-elements` output target.
+* for the `standalone` output target.
 *
 * Adding a value to this const array will automatically add it as a valid option on the
 * output target configuration for `customElementsExportBehavior`.
@@ -38,8 +38,7 @@ const LOG_LEVELS = [
 * - `auto-define-custom-elements`: Enables the auto-definition of a component and its children (recursively) in the custom elements registry. This
 * functionality allows consumers to bypass the explicit call to define a component, its children, its children's
 * children, etc. Users of this flag should be aware that enabling this functionality may increase bundle size.
-* - `bundle`: A `defineCustomElements` function will be exported from the distribution directory. This behavior was added to allow easy migration
-* from `dist-custom-elements-bundle` to `dist-custom-elements`.
+* - `bundle`: A `defineCustomElements` function will be exported from the distribution directory.
 * - `single-export-module`: All components will be re-exported from the specified directory's root `index.js` file.
 */
 const CustomElementsExportBehaviorOptions = [

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
@@ -331,6 +353,7 @@ declare const Listen: ListenDecorator;
  * and object properties to their string literal values. This allows variables to be
  * used in `@Listen` and `@Event` decorators instead of hardcoded strings.
  *
+ *
  * @example
  * ```ts
  * const MY_EVENT = 'myEvent';
@@ -534,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.
@@ -683,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;
   };
@@ -737,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
@@ -748,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[];
@@ -761,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.
@@ -781,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;
     }
@@ -817,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?: {
@@ -1154,6 +1189,7 @@ declare namespace JSXBase {
     importance?: 'low' | 'auto' | 'high';
     height?: number | string;
     loading?: 'lazy' | 'auto' | 'eager';
+    referrerPolicy?: ReferrerPolicy;
     sizes?: string;
     src?: string;
     srcSet?: string;
@@ -1469,7 +1505,7 @@ declare namespace JSXBase {
     autofocus?: boolean | string;
     class?: string | {
       [className: string]: boolean;
-    };
+    } | SignalRef<string>;
     contentEditable?: boolean | string;
     contenteditable?: boolean | string;
     contextMenu?: string;
@@ -1528,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;
@@ -1929,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;
@@ -1940,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 };