@stencil/core 5.0.0-alpha.1 → 5.0.0-alpha.11

package/dist/{index-BONzXKJt.d.ts → index-xAkMgLX_.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 {
@@ -486,6 +496,7 @@ declare namespace JSXBase {
     importance?: 'low' | 'auto' | 'high';
     height?: number | string;
     loading?: 'lazy' | 'auto' | 'eager';
+    referrerPolicy?: ReferrerPolicy;
     sizes?: string;
     src?: string;
     srcSet?: string;
@@ -801,7 +812,7 @@ declare namespace JSXBase {
     autofocus?: boolean | string;
     class?: string | {
       [className: string]: boolean;
-    };
+    } | SignalRef<string>;
     contentEditable?: boolean | string;
     contenteditable?: boolean | string;
     contextMenu?: string;
@@ -860,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;
@@ -1261,12 +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;
-  /** @deprecated in-favour of `setTagTransformer` and `transformTag` */
-  transformTagName?: (tagName: string) => string;
+  /** 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;
@@ -1281,6 +1293,7 @@ interface BuildFeatures {
   formAssociated: boolean;
   shadowDom: boolean;
   shadowDelegatesFocus: boolean;
+  shadowModeClosed: boolean;
   shadowSlotAssignmentManual: boolean;
   scoped: boolean;
   /**
@@ -1302,7 +1315,12 @@ interface BuildFeatures {
   vdomStyle: boolean;
   vdomText: boolean;
   vdomXlink: boolean;
+  vdomSignals: boolean;
   slotRelocation: boolean;
+  patchAll: boolean;
+  patchChildren: boolean;
+  patchClone: boolean;
+  patchInsert: boolean;
   slot: boolean;
   svg: boolean;
   element: boolean;
@@ -1311,10 +1329,6 @@ interface BuildFeatures {
   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;
@@ -1348,22 +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;
-  transformTagName?: boolean;
   additionalTagTransformers?: boolean | 'prod';
-  attachStyles?: boolean;
-  experimentalSlotFixes?: boolean;
-  experimentalScopedSlotChanges?: boolean;
-  addGlobalStyleToComponents?: boolean | 'client';
+  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;
@@ -1428,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
    */
@@ -1576,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;
@@ -1668,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;
@@ -1793,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
@@ -1804,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;
   /**
@@ -1890,4 +1912,31 @@ interface PlatformRuntime {
 }
 type ChildType = VNode | number | string;
 //#endregion
-export { ResolutionHandler as _, ComponentRuntimeMeta as a, HostRef as c, RenderNode as d, RuntimeRef as f, JSXBase as g, HTMLStencilElement as h, ComponentRuntimeHostListener as i, LazyBundlesRuntimeData as l, FunctionalComponent as m, ChildType as n, ComponentRuntimeMetaCompact as o, CustomElementsDefineOptions as p, ComponentConstructor as r, HostElement as s, BuildConditionals as t, PlatformRuntime as u, TagTransformer as v, VNode 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 `@stencil/core/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 };

package/dist/index.d.mts

@@ -44,13 +44,13 @@ export {
   getElement,
   getMode,
   getRenderingRef,
+  getShadowRoot,
   h,
   Host,
   Listen,
   Method,
   MixedInCtor,
   Mixin,
-  MixinFactory,
   Prop,
   readTask,
   render,

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { A as Event, D as AttrDeserialize, E as AttachInternals, F as State, I as Watch, L as resolveVar, M as Method, N as Prop, O as Component, P as PropSerialize, R as Build, S as setPlatformHelpers, _ as h, a as Mixin, b as readTask, c as forceUpdate, f as getElement, g as Host, i as render, j as Listen, k as Element, l as getRenderingRef, m as setMode, n as setTagTransformer, o as Fragment, p as getMode, r as transformTag, v as getAssetPath, w as setErrorHandler, x as writeTask, y as setAssetPath } from "./client-B1nuvCd2.mjs";
-export { AttachInternals, AttrDeserialize, Build, Component, Element, Event, Fragment, Host, Listen, Method, Mixin, Prop, PropSerialize, State, Watch, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, h, readTask, render, resolveVar, setAssetPath, setErrorHandler, setMode, setPlatformHelpers, setTagTransformer, transformTag, writeTask };
+import { B as Event, C as setAssetPath, E as setPlatformHelpers, G as State, H as Method, I as AttachInternals, J as Build, K as Watch, L as AttrDeserialize, N as setErrorHandler, R as Component, S as getAssetPath, T as writeTask, U as Prop, V as Listen, W as PropSerialize, a as transformTag, b as getElement, c as Fragment, d as setMode, g as getRenderingRef, h as forceUpdate, i as setTagTransformer, m as h, o as render, p as Host, q as resolveVar, s as Mixin, u as getMode, w as readTask, x as getShadowRoot, z as Element } from "./client-aTQ7xHxx.mjs";
+export { AttachInternals, AttrDeserialize, Build, Component, Element, Event, Fragment, Host, Listen, Method, Mixin, Prop, PropSerialize, State, Watch, forceUpdate, getAssetPath, getElement, getMode, getRenderingRef, getShadowRoot, h, readTask, render, resolveVar, setAssetPath, setErrorHandler, setMode, setPlatformHelpers, setTagTransformer, transformTag, writeTask };

package/dist/jsx-runtime.d.mts

@@ -0,0 +1,18 @@
+import type { VNode, JSXBase, JSX as LocalJSX } from './declarations/stencil-public-runtime';
+
+export { Fragment } from './declarations/stencil-public-runtime';
+export function jsx(type: any, props: any, key?: string): VNode;
+export function jsxs(type: any, props: any, key?: string): VNode;
+export function jsxDEV(type: any, props: any, key?: string): VNode;
+
+export namespace JSX {
+  type BaseElements = LocalJSX.IntrinsicElements & JSXBase.IntrinsicElements;
+
+  export type IntrinsicElements = {
+    [K in keyof BaseElements]: BaseElements[K] & { children?: any };
+  } & {
+    [tagName: string]: any;
+  };
+
+  export type Element = VNode;
+}

package/dist/jsx-runtime.mjs

@@ -0,0 +1,2 @@
+import { c as Fragment, n as jsxDEV, r as jsxs, t as jsx } from "./client-aTQ7xHxx.mjs";
+export { Fragment, jsx, jsxDEV, jsxs };

package/dist/{node-SxQIOCZE.mjs → node--akYC-sG.mjs}

@@ -1,25 +1,25 @@
-import { n as __require } from "./chunk-CjcI7cDX.mjs";
-import "./client-B1nuvCd2.mjs";
-import { _ as isString, c as flatOne, p as isFunction, y as noop } from "./serialize-BkYHk7Mi.mjs";
-import { bt as isGlob, dt as TASK_CANCELED_MSG, ft as buildError, ht as catchError, rt as normalizePath, vt as shouldIgnoreError } from "./validation-CaCgjw-f.mjs";
+import { n as __require } from "./chunk-z9aeyW2b.mjs";
+import "./client-aTQ7xHxx.mjs";
+import { h as noop, i as flatOne, l as isFunction, p as isString } from "./regular-expression-CFVJOTUh.mjs";
+import { St as isGlob, _t as catchError, bt as shouldIgnoreError, it as normalizePath, mt as buildError, pt as TASK_CANCELED_MSG } from "./validation-ByxKj8bC.mjs";
+import fs from "node:fs";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import path$1 from "path";
-import fs from "graceful-fs";
+import * as cp from "child_process";
 import chalk from "chalk";
 import { createHash } from "node:crypto";
 import * as os from "node:os";
 import { cpus, freemem, platform, release, tmpdir, totalmem } from "node:os";
 import * as parcelWatcher from "@parcel/watcher";
-import { glob } from "glob";
-import { promisify } from "util";
+import { glob } from "tinyglobby";
+import { copyFile, mkdir, readdir, stat } from "node:fs/promises";
 import semverLte from "semver/functions/lte.js";
 import major from "semver/functions/major.js";
 import satisfies from "semver/functions/satisfies.js";
 import { cpus as cpus$1, tmpdir as tmpdir$1 } from "os";
 import semverLt from "semver/functions/lt.js";
 import { EventEmitter } from "events";
-import * as cp from "child_process";
 //#region src/compiler/events.ts
 const buildEvents = () => {
 	const evCallbacks = [];
@@ -106,7 +106,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`.
@@ -115,8 +115,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 = [
@@ -734,12 +733,6 @@ function setupNodeProcess(c) {
 	});
 }
 //#endregion
-//#region src/sys/node/node-fs-promisify.ts
-const copyFile = promisify(fs.copyFile);
-const mkdir = promisify(fs.mkdir);
-const readdir = promisify(fs.readdir);
-const stat = promisify(fs.stat);
-//#endregion
 //#region src/sys/node/node-copy-tasks.ts
 /**
 * Copy a file with retry logic for transient Windows errors (EBUSY, EPERM, EACCES).
@@ -879,8 +872,12 @@ function shouldIgnore({ src, ignore = [] }) {
 	const filePath = src.trim().toLowerCase();
 	return ignore.some((ignoreFile) => filePath.endsWith(ignoreFile));
 }
-function asyncGlob(pattern, opts) {
-	return glob(pattern, opts);
+function asyncGlob(pattern, opts = {}) {
+	const { nodir, ...rest } = opts;
+	return glob(pattern, {
+		...rest,
+		onlyFiles: nodir ?? true
+	});
 }
 //#endregion
 //#region src/sys/node/node-lazy-require.ts
@@ -889,6 +886,8 @@ function asyncGlob(pattern, opts) {
 * returning diagnostic errors if requirements aren't met.
 */
 var NodeLazyRequire = class {
+	nodeResolveModule;
+	lazyDependencies;
 	ensured = /* @__PURE__ */ new Set();
 	/**
 	* Create a NodeLazyRequire instance
@@ -1131,6 +1130,7 @@ const INDENT = `   `;
 * thread so that messages may be passed to it.
 */
 var NodeWorkerMain = class extends EventEmitter {
+	id;
 	/**
 	* A handle for the OS process that is running our worker code
 	*/
@@ -1237,6 +1237,7 @@ var NodeWorkerMain = class extends EventEmitter {
 * node.js workers ({@link NodeWorkerMain} instances)
 */
 var NodeWorkerController = class extends EventEmitter {
+	forkModulePath;
 	workerIds = 0;
 	stencilId = 0;
 	isEnding = false;
@@ -1494,17 +1495,6 @@ function createNodeSys(c = {}) {
 		encodeToBase64(str) {
 			return Buffer.from(str).toString("base64");
 		},
-		async ensureDependencies() {
-			console.warn(`ensureDependencies will be removed in a future version of Stencil.`);
-			console.warn(`To get the stencilPath, please use getCompilerExecutingPath().`);
-			return {
-				stencilPath: sys.getCompilerExecutingPath(),
-				diagnostics: []
-			};
-		},
-		async ensureResources() {
-			console.warn(`ensureResources is a no-op, and will be removed in a future version of Stencil`);
-		},
 		exit: async (exitCode) => {
 			await runInterruptsCallbacks();
 			process.exitCode = exitCode;