@stencil/core 5.0.0-beta.2 → 5.0.0-beta.20

package/dist/app-data/index.d.ts

@@ -1,2 +1,2 @@
-import { n as Env, r as NAMESPACE, t as BUILD } from "../index-BXAcVN2j.js";
+import { n as Env, r as NAMESPACE, t as BUILD } from "../index-BHciXst1.js";
 export { BUILD, Env, NAMESPACE };

package/dist/{client-BRu0GtRn.mjs → client-CVXS3JZ-.mjs}

@@ -1,5 +1,5 @@
 import { B as HOST_FLAGS, C as CMP_FLAGS, G as NODE_TYPES, Z as SVG_NS, o as isComplexType, s as isDef, x as queryNonceMetaTagContent } from "./helpers-Cpp3qc3u.mjs";
-import { effect } from "@preact/signals-core";
+import * as SignalsCore from "@preact/signals-core";
 //#region src/app-data/index.ts
 /**
 * A collection of default build flags for a Stencil project.
@@ -104,41 +104,6 @@ const BUILD = {
 	asyncQueue: false
 };
 //#endregion
-//#region src/client/client-build.ts
-const Build = {
-	isDev: BUILD.isDev,
-	isBrowser: true,
-	isServer: false,
-	isTesting: BUILD.isTesting
-};
-//#endregion
-//#region src/client/client-host-ref.ts
-/**
-* Given a {@link d.RuntimeRef} retrieve the corresponding {@link d.HostRef}
-*
-* @param ref the runtime ref of interest
-* @returns the Host reference (if found) or undefined
-*/
-const getHostRef = (ref) => {
-	if (ref.__s_ghr) return ref.__s_ghr();
-};
-const isMemberInElement = (elm, memberName) => memberName in elm;
-//#endregion
-//#region src/client/client-log.ts
-let customError;
-const consoleError = (e, el) => (customError || console.error)(e, el);
-const STENCIL_DEV_MODE = BUILD.isTesting ? ["STENCIL:"] : ["%cstencil", "color: white;background:#4c47ff;font-weight: bold; font-size:10px; padding:2px 6px; border-radius: 5px"];
-const consoleDevError = (...m) => console.error(...STENCIL_DEV_MODE, ...m);
-const consoleDevWarn = (...m) => console.warn(...STENCIL_DEV_MODE, ...m);
-const setErrorHandler = (handler) => customError = handler;
-//#endregion
-//#region src/client/client-load-module.ts
-/*!__STENCIL_STATIC_IMPORT_SWITCH__*/
-//#endregion
-//#region src/client/client-style.ts
-const styles = /*@__PURE__*/ new Map();
-const modeResolutionChain = [];
-//#endregion
 //#region src/runtime/runtime-constants.ts
 /**
 * Bit flags for recording various properties of VDom nodes
@@ -191,6 +156,54 @@ const HYDRATED_CSS = "{visibility:hidden}.hydrated{visibility:inherit}";
 */
 const SLOT_FB_CSS = "slot-fb{display:contents}slot-fb[hidden]{display:none}";
 const XLINK_NS = "http://www.w3.org/1999/xlink";
+/**
+* `Build` values fixed per platform. Shared by each runtime's `Build` export and the compiler's
+* `Build.*` folding (`compiler/bundle/build-flags-plugin.ts`), so the two can't disagree.
+*/
+const CLIENT_BUILD_FLAGS = {
+	isBrowser: true,
+	isServer: false
+};
+const SERVER_BUILD_FLAGS = {
+	isBrowser: false,
+	isServer: true,
+	isDev: false,
+	isTesting: false
+};
+//#endregion
+//#region src/client/client-build.ts
+const Build = {
+	...CLIENT_BUILD_FLAGS,
+	isDev: BUILD.isDev,
+	isTesting: BUILD.isTesting
+};
+//#endregion
+//#region src/client/client-host-ref.ts
+/**
+* Given a {@link d.RuntimeRef} retrieve the corresponding {@link d.HostRef}
+*
+* @param ref the runtime ref of interest
+* @returns the Host reference (if found) or undefined
+*/
+const getHostRef = (ref) => {
+	if (ref.__s_ghr) return ref.__s_ghr();
+};
+const isMemberInElement = (elm, memberName) => memberName in elm;
+//#endregion
+//#region src/client/client-log.ts
+let customError;
+const consoleError = (e, el) => (customError || console.error)(e, el);
+const STENCIL_DEV_MODE = BUILD.isTesting ? ["STENCIL:"] : ["%cstencil", "color: white;background:#4c47ff;font-weight: bold; font-size:10px; padding:2px 6px; border-radius: 5px"];
+const consoleDevError = (...m) => console.error(...STENCIL_DEV_MODE, ...m);
+const consoleDevWarn = (...m) => console.warn(...STENCIL_DEV_MODE, ...m);
+const setErrorHandler = (handler) => customError = handler;
+//#endregion
+//#region src/client/client-load-module.ts
+/*!__STENCIL_STATIC_IMPORT_SWITCH__*/
+//#endregion
+//#region src/client/client-style.ts
+const styles = /*@__PURE__*/ new Map();
+const modeResolver = [];
 //#endregion
 //#region src/client/client-window.ts
 const win = typeof window !== "undefined" ? window : {};
@@ -223,7 +236,7 @@ let queuePending = false;
 const queueDomReads = [];
 const queueDomWrites = [];
 const queueDomWritesLow = [];
-const scheduleFlush = () => win.document?.hidden ? nextTick(flush) : plt.raf(flush);
+const scheduleFlush = () => win.document?.hidden ? setTimeout(flush, 16) : plt.raf(flush);
 const queueTask = (queue, write) => (cb) => {
 	queue.push(cb);
 	if (!queuePending) {
@@ -722,6 +735,10 @@ const attachStyles = (hostRef) => {
 */
 const getScopeId = (cmp, mode) => "sc-" + (BUILD.mode && mode && cmp.$flags$ & CMP_FLAGS.hasMode ? cmp.$tagName$ + "-" + mode : cmp.$tagName$);
 //#endregion
+//#region src/runtime/signals-core.ts
+const getCore = () => globalThis[Symbol.for("stencil.preact-signals-core")] ??= SignalsCore;
+const effect = (fn, options) => getCore().effect(fn, options);
+//#endregion
 //#region src/runtime/event-emitter.ts
 /**
 * Helper function to create & dispatch a custom Event on a provided target
@@ -736,6 +753,11 @@ const emitEvent = (elm, name, opts) => {
 	return ev;
 };
 const getRegistry = () => customElements;
+/**
+* @param elm a defined component host
+* @returns the registry the host's class was defined in, else the active registry
+*/
+const getHostRegistry = (elm) => elm.constructor._registry ?? getRegistry();
 //#endregion
 //#region src/runtime/vdom/set-accessor.ts
 /**
@@ -859,10 +881,10 @@ const setAccessor = (elm, memberName, oldValue, newValue, isSvg, flags, initialR
 		const isComplex = isComplexType(newValue);
 		if (!BUILD.lazyLoad) {
 			const isStandardAttr = ln.startsWith("aria-") || ln.startsWith("data-");
-			if (!isProp && !isStandardAttr && elm.tagName?.includes("-") && elm.tagName !== "SLOT-FB" && typeof customElements !== "undefined" && !customElements.get(elm.tagName.toLowerCase())) {
+			if (!isProp && !isStandardAttr && elm.tagName?.includes("-") && elm.tagName !== "SLOT-FB" && !customElements.get(elm.tagName.toLowerCase())) {
 				if (!elm["s-pp"]) elm["s-pp"] = /* @__PURE__ */ new Map();
 				elm["s-pp"].set(memberName, newValue);
-				return;
+				if (isComplex || /[A-Z]/.test(memberName)) return;
 			}
 		}
 		if ((isProp || isComplex && newValue !== null) && !isSvg) try {
@@ -980,6 +1002,7 @@ function sortedAttrNames(attrNames) {
 let scopeId;
 let contentRef;
 let hostTagName;
+let hostRegistry;
 let useNativeShadowDom = false;
 let checkSlotFallbackVisibility = false;
 let checkSlotRelocate = false;
@@ -996,16 +1019,33 @@ const signalNodeDisposers = /* @__PURE__ */ new WeakMap();
 const disposeSignalVNode = (vnode) => {
 	const elm = vnode.$elm$;
 	if (elm) {
-		const dispose = signalNodeDisposers.get(elm);
-		if (dispose) {
-			dispose();
-			signalNodeDisposers.delete(elm);
-		}
+		disposeTextSignal(elm);
 		disposeAllSignalAttrs(elm);
 	}
 	vnode.$children$?.forEach(disposeSignalVNode);
 };
 /**
+* Tear down a text node's signal subscription, if it has one.
+* @param textNode the text node to unsubscribe
+*/
+const disposeTextSignal = (textNode) => {
+	const dispose = signalNodeDisposers.get(textNode);
+	if (dispose) {
+		dispose();
+		signalNodeDisposers.delete(textNode);
+	}
+};
+/**
+* Subscribe a text node to a signal, keeping its `data` in sync on every change.
+* @param textNode the text node to keep in sync
+* @param textSig the signal to subscribe to
+*/
+const wireTextSignal = (textNode, textSig) => {
+	signalNodeDisposers.set(textNode, effect(() => {
+		textNode.data = String(textSig.value);
+	}));
+};
+/**
 * Create a DOM Node corresponding to one of the children of a given VNode.
 *
 * @param oldParentVNode the parent VNode from the previous render
@@ -1027,13 +1067,7 @@ const createElm = (oldParentVNode, newParentVNode, childIndex) => {
 	if (BUILD.isDev && newVNode.$elm$) consoleDevError(`The JSX ${newVNode.$text$ !== null ? `"${newVNode.$text$}" text` : `"${String(newVNode.$tag$)}" element`} node should not be shared within the same renderer. The renderer caches element lookups in order to improve performance. However, a side effect from this is that the exact same JSX node should not be reused. For more information please see https://stenciljs.com/docs/templating-jsx#avoid-shared-jsx-nodes`);
 	if (BUILD.vdomText && newVNode.$text$ != null) {
 		elm = newVNode.$elm$ = win.document.createTextNode(newVNode.$text$);
-		if (BUILD.vdomSignals && newVNode.$signal$) {
-			const textSig = newVNode.$signal$;
-			const textNode = elm;
-			signalNodeDisposers.set(textNode, effect(() => {
-				textNode.data = String(textSig.value);
-			}));
-		}
+		if (BUILD.vdomSignals && newVNode.$signal$) wireTextSignal(elm, newVNode.$signal$);
 	} else if (BUILD.slotRelocation && newVNode.$flags$ & VNODE_FLAGS.isSlotReference) {
 		elm = newVNode.$elm$ = BUILD.isDebug || BUILD.hydrateServerSide ? slotReferenceDebugNode(newVNode) : win.document.createTextNode("");
 		if (typeof newVNode.$attrs$?.slot === "string") elm["s-sa"] = newVNode.$attrs$.slot;
@@ -1042,8 +1076,7 @@ const createElm = (oldParentVNode, newParentVNode, childIndex) => {
 		if (BUILD.svg && !isSvgMode) isSvgMode = newVNode.$tag$ === "svg";
 		if (!win.document) throw new Error("No DOM environment available for rendering.");
 		const tag = !useNativeShadowDom && BUILD.slotRelocation && newVNode.$flags$ & VNODE_FLAGS.isSlotFallback ? "slot-fb" : newVNode.$tag$;
-		const _reg = getRegistry();
-		const registryOpts = _reg !== win.customElements && tag.includes("-") ? { customElementRegistry: _reg } : void 0;
+		const registryOpts = hostRegistry !== win.customElements && tag.includes("-") ? { customElementRegistry: hostRegistry } : void 0;
 		elm = newVNode.$elm$ = BUILD.svg && isSvgMode ? win.document.createElementNS(SVG_NS, tag) : win.document.createElement(tag, registryOpts);
 		if (BUILD.svg && isSvgMode && newVNode.$tag$ === "foreignObject") isSvgMode = false;
 		if (BUILD.vdomAttribute) updateElement(null, newVNode, isSvgMode);
@@ -1301,7 +1334,7 @@ const updateChildren = (parentElm, oldCh, newVNode, newCh, isInitialRender = fal
 		}
 		if (BUILD.vdomKey && idxInOld >= 0) {
 			elmToMove = oldCh[idxInOld];
-			if (elmToMove.$tag$ !== newStartVnode.$tag$) node = createElm(oldCh && oldCh[newStartIdx], newVNode, idxInOld);
+			if (elmToMove.$tag$ !== newStartVnode.$tag$) node = createElm(oldCh && oldCh[newStartIdx], newVNode, newStartIdx);
 			else {
 				patch(elmToMove, newStartVnode, isInitialRender);
 				oldCh[idxInOld] = void 0;
@@ -1394,7 +1427,17 @@ const patch = (oldVNode, newVNode, isInitialRender = false) => {
 		else if (BUILD.hydrateClientSide && isInitialRender && BUILD.updatable && oldChildren !== null && newChildren === null) newVNode.$children$ = oldChildren;
 		if (BUILD.svg && isSvgMode && tag === "svg") isSvgMode = false;
 	} else if (BUILD.vdomText && BUILD.slotRelocation && (defaultHolder = elm["s-cr"])) defaultHolder.parentNode.textContent = text;
-	else if (BUILD.vdomText && oldVNode.$text$ !== text) elm.data = text;
+	else if (BUILD.vdomText) {
+		if (BUILD.vdomSignals && newVNode.$signal$) {
+			if (newVNode.$signal$ !== oldVNode.$signal$) {
+				disposeTextSignal(elm);
+				wireTextSignal(elm, newVNode.$signal$);
+			}
+		} else {
+			if (BUILD.vdomSignals && oldVNode.$signal$) disposeTextSignal(elm);
+			if (oldVNode.$text$ !== text) elm.data = text;
+		}
+	}
 };
 /**
 * Component-global information about nodes which are either currently being
@@ -1582,6 +1625,7 @@ const renderVdom = (hostRef, renderFnResults, isInitialLoad = false) => {
 	const oldVNode = hostRef.$vnode$ || newVNode(null, null);
 	const rootVnode = isHost(renderFnResults) ? renderFnResults : h(null, null, renderFnResults);
 	hostTagName = hostElm.tagName;
+	hostRegistry = getHostRegistry(hostElm);
 	if (BUILD.isDev && Array.isArray(renderFnResults) && renderFnResults.some(isHost)) throw new Error(`The <Host> must be the single root component.
 Looks like the render() function of "${hostTagName.toLowerCase()}" is returning an array that contains the <Host>.
 
@@ -2097,9 +2141,7 @@ const h = (nodeName, vnodeData, ...children) => {
 			if (classData && !(BUILD.vdomSignals && isSignalLike(classData))) vnodeData.class = typeof classData !== "object" ? classData : Object.keys(classData).filter((k) => classData[k]).join(" ");
 		}
 	}
-	if (BUILD.isDev && vNodeChildren.some(isHost)) consoleDevError(`The <Host> must be the single root component. Make sure:
-- You are NOT using hostData() and <Host> in the same component.
-- <Host> is used once, and it's the single root component of the render() function.`);
+	if (BUILD.isDev && vNodeChildren.some(isHost)) consoleDevError(`The <Host> must be used once, and be the single root component of the render() function.`);
 	if (BUILD.vdomFunctional && typeof nodeName === "function") return nodeName(vnodeData === null ? {} : vnodeData, vNodeChildren, vdomFnUtils);
 	const vnode = newVNode(nodeName, null);
 	vnode.$attrs$ = vnodeData;
@@ -2203,7 +2245,10 @@ const validateInputProperties = (inputElm) => {
 };
 //#endregion
 //#region src/runtime/mode.ts
-const setMode = (handler) => modeResolutionChain.push(handler);
+const setMode = (handler) => {
+	modeResolver.length = 0;
+	modeResolver.push(handler);
+};
 const getMode = (ref) => getHostRef(ref)?.$modeName$;
 //#endregion
 //#region src/runtime/mixin.ts
@@ -2365,4 +2410,4 @@ function hasKeys(obj) {
 	return false;
 }
 //#endregion
-export { setErrorHandler as C, HYDRATED_CSS as S, getAssetPath as _, transformTag as a, writeTask as b, Mixin as c, Host as d, h as f, getShadowRoot as g, getElement as h, setTagTransformer as i, getMode as l, getRenderingRef as m, jsxDEV as n, render as o, forceUpdate as p, jsxs as r, ReactiveControllerHost as s, jsx as t, setMode as u, setAssetPath as v, Build as w, setPlatformHelpers as x, readTask as y };
+export { Build as C, SERVER_BUILD_FLAGS as E, setErrorHandler as S, HYDRATED_CSS as T, getAssetPath as _, transformTag as a, writeTask as b, Mixin as c, Host as d, h as f, getShadowRoot as g, getElement as h, setTagTransformer as i, getMode as l, getRenderingRef as m, jsxDEV as n, render as o, forceUpdate as p, jsxs as r, ReactiveControllerHost as s, jsx as t, setMode as u, setAssetPath as v, CLIENT_BUILD_FLAGS as w, setPlatformHelpers as x, readTask as y };

package/dist/compiler/browser.d.ts

@@ -1,11 +1,77 @@
 import ts from "typescript";
 import "rolldown";
 //#region src/declarations/stencil-public-docs.d.ts
+/**
+ * A descriptor for a single JSDoc tag found in a block comment
+ */
+interface JsonDocsTag {
+  /**
+   * The tag name (immediately following the '@')
+   */
+  name: string;
+  /**
+   * The description that immediately follows the tag name
+   */
+  text?: string;
+}
 interface JsonDocMethodParameter {
   name: string;
   type: string;
   docs: string;
 }
+/**
+ * A descriptor for a Custom State defined via @AttachInternals({ states: {...} })
+ *
+ * Custom states are exposed via the ElementInternals.states CustomStateSet
+ * and can be targeted with the CSS `:state()` pseudo-class.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/CustomStateSet
+ */
+interface JsonDocsCustomState {
+  /**
+   * The name of the custom state (without dashes)
+   */
+  name: string;
+  /**
+   * The initial/default value of the state
+   */
+  initialValue: boolean;
+  /**
+   * A textual description of the custom state
+   */
+  docs: string;
+}
+/**
+ * Represents a parsed block comment in a CSS, Sass, etc. file for a custom property.
+ */
+interface StyleDoc {
+  /**
+   * The name of the CSS property
+   */
+  name: string;
+  /**
+   * The user-defined description of the CSS property
+   */
+  docs: string;
+  /**
+   * The JSDoc-style annotation (e.g. `@prop`) that was used in the block comment to detect the comment.
+   * Used to inform Stencil where the start of a new property's description starts (and where the previous description
+   * ends).
+   */
+  annotation: 'prop';
+  /**
+   * The Stencil style-mode that is associated with this property.
+   */
+  mode: string | undefined;
+  /**
+   * The CSS `syntax` descriptor, if this property was registered via a native `@property` at-rule.
+   */
+  syntax?: string;
+  /**
+   * The `initial-value` descriptor, if this property was registered via a native `@property` at-rule.
+   */
+  default?: string;
+}
 //#endregion
 //#region src/declarations/stencil-public-runtime.d.ts
 type ListenTargetOptions = 'body' | 'document' | 'window';
@@ -25,7 +91,7 @@ interface CompilerSystem {
   name: 'node' | 'in-memory';
   version: string;
   events?: BuildEvents;
-  details?: SystemDetails;
+  details: SystemDetails;
   /**
    * Add a callback which will be ran when destroy() is called.
    */
@@ -38,14 +104,15 @@ interface CompilerSystem {
    * SYNC! Always returns a boolean, does not throw.
    */
   accessSync(p: string): boolean;
-  applyGlobalPatch?(fromDir: string): Promise<void>;
   applyPrerenderGlobalPatch?(opts: {
     devServerHostUrl: string;
     window: any;
   }): void;
-  cacheStorage?: CacheStorage;
-  checkVersion?: (logger: Logger, currentVersion: string) => Promise<() => void>;
-  copy?(copyTasks: Required<CopyTask>[], srcDir: string): Promise<CopyResults>;
+  /**
+   * Check npm for a newer Stencil version. Resolves a function that logs the result.
+   */
+  checkVersion(logger: Logger, currentVersion: string): Promise<() => void>;
+  copy(copyTasks: Required<CopyTask>[], srcDir: string): Promise<CopyResults>;
   /**
    * Always returns a boolean if the files were copied or not. Does not throw.
    */
@@ -70,7 +137,7 @@ interface CompilerSystem {
   /**
    * Each platform has a different way to dynamically import modules.
    */
-  dynamicImport?(p: string): Promise<any>;
+  dynamicImport(p: string): Promise<any>;
   /**
    * Creates the worker controller for the current system.
    *
@@ -84,20 +151,14 @@ interface CompilerSystem {
    * process.exit()
    */
   exit(exitCode: number): Promise<void>;
-  /**
-   * Optionally provide a fetch() function rather than using the built-in fetch().
-   * First arg is a url string or Request object (RequestInfo).
-   * Second arg is the RequestInit. Returns the Response object
-   */
-  fetch?(input: string | any, init?: any): Promise<any>;
   /**
    * Generates a sha1 digest encoded as HEX
    */
-  generateContentHash?(content: string | any, length?: number): Promise<string>;
+  generateContentHash(content: string | any, length?: number): Promise<string>;
   /**
    * Generates a sha1 digest encoded as HEX from a file path
    */
-  generateFileHash?(filePath: string | any, length?: number): Promise<string>;
+  generateFileHash(filePath: string | any, length?: number): Promise<string>;
   /**
    * Get the current directory.
    */
@@ -106,7 +167,6 @@ interface CompilerSystem {
    * The compiler's executing path.
    */
   getCompilerExecutingPath(): string;
-  getEnvironmentVar?(key: string): string;
   /**
    * Gets the absolute file path when for a dependency module.
    */
@@ -145,11 +205,7 @@ interface CompilerSystem {
    * Normalize file system path.
    */
   normalizePath(p: string): string;
-  onProcessInterrupt?(cb: () => void): void;
-  parseYarnLockFile?: (content: string) => {
-    type: 'success' | 'merge' | 'conflict';
-    object: any;
-  };
+  onProcessInterrupt(cb: () => void): void;
   platformPath: PlatformPath;
   /**
    * All return paths are full normalized paths, not just the basenames. Always returns an array, does not throw.
@@ -185,6 +241,9 @@ interface CompilerSystem {
    * Rename old path to new path. Does not throw.
    */
   rename(oldPath: string, newPath: string): Promise<CompilerSystemRenameResults>;
+  /**
+   * Assigned by the compiler. Used by plugins (e.g. `@stencil/sass`) to resolve `~` imports.
+   */
   resolveModuleId?(opts: ResolveModuleIdOptions): Promise<ResolveModuleIdResults>;
   resolvePath(p: string): string;
   /**
@@ -367,6 +426,7 @@ interface CompilerBuildResults {
   buildId: number;
   componentGraph?: BuildResultsComponentGraph;
   components: ComponentCompilerMeta[];
+  cssOnlyComponents: ComponentCompilerMeta[];
   diagnostics: Diagnostic[];
   dirsAdded: string[];
   dirsDeleted: string[];
@@ -383,6 +443,15 @@ interface CompilerBuildResults {
   namespace: string;
   fsNamespace: string;
   outputs: BuildOutput[];
+  /**
+   * Absolute paths to every global stylesheet, in cascade order: each `global-style` output
+   * target's compiled CSS in the order those targets are declared in `config.outputTargets` - or,
+   * with none configured, the generated `{fsNamespace}.css` holding Stencil's auto-placed CSS (when
+   * emitted). Unlike `outputs`, which groups files by type and sorts them alphabetically, this
+   * preserves author-intended order for consumers like the dev-server's auto-generated component
+   * preview.
+   */
+  globalStyleFiles: string[];
   rootDir: string;
   srcDir: string;
   timestamp: string;
@@ -398,6 +467,7 @@ interface HotModuleReplacement {
   componentsUpdated?: string[];
   excludeHmr?: string[];
   externalStylesUpdated?: string[];
+  globalStylesUpdated?: HmrGlobalStyleUpdate[];
   imagesUpdated?: string[];
   indexHtmlUpdated?: boolean;
   inlineStylesUpdated?: HmrStyleUpdate[];
@@ -412,6 +482,15 @@ interface HmrStyleUpdate {
   styleTag: string;
   styleText: string;
 }
+/**
+ * A live-reload update for a `global-style` output target's CSS. Applied on
+ * the client by matching `fileName` against the `<link>` that loads it and
+ * inserting/updating an adjacent `<style>` override
+ */
+interface HmrGlobalStyleUpdate {
+  fileName: string;
+  styleText: string;
+}
 type BuildOnEventRemove = () => boolean;
 interface BuildEvents extends BuildOnEvents, BuildEmitEvents {
   unsubscribeAll(): void;
@@ -689,10 +768,6 @@ interface Diagnostic {
   relFilePath?: string | undefined;
   type: string;
 }
-interface CacheStorage {
-  get(key: string): Promise<any>;
-  set(key: string, value: any): Promise<void>;
-}
 interface LazyRequire {
   ensure(fromDir: string, moduleIds: string[]): Promise<Diagnostic[]>;
   require(fromDir: string, moduleId: string): any;
@@ -839,6 +914,12 @@ interface TranspileOptions {
    * that the specified flags take effect for this component at runtime.
    */
   buildOverrides?: BuildOverrides;
+  /**
+   * When `true`, a `.css`/`.scss` transpile also collects CSS custom-property docs
+   * onto {@link TranspileResults.styleDocs}. Off by default, since it costs an extra parse
+   * of the style text.
+   */
+  docs?: boolean;
 }
 /**
  * Keys of {@link BuildConditionals} that can be meaningfully overridden at
@@ -864,6 +945,7 @@ interface TranspileResults {
   inputFilePath: string;
   map: any;
   outputFilePath: string;
+  styleDocs?: StyleDoc[];
 }
 //#endregion
 //#region src/declarations/stencil-private.d.ts
@@ -1070,7 +1152,7 @@ interface ComponentCompilerMeta extends ComponentCompilerFeatures {
    * Custom states to initialize on the ElementInternals.states CustomStateSet.
    * These are defined via @AttachInternals({ states: {...} }).
    */
-  attachInternalsCustomStates: ComponentCompilerCustomState[];
+  attachInternalsCustomStates: JsonDocsCustomState[];
   componentClassName: string;
   /**
    * A list of web component tag names that are either:
@@ -1140,7 +1222,7 @@ interface ComponentCompilerMeta extends ComponentCompilerFeatures {
   sourceFilePath: string;
   sourceMapPath: string;
   states: ComponentCompilerState[];
-  styleDocs: CompilerStyleDoc[];
+  styleDocs: StyleDoc[];
   styles: StyleCompiler[];
   globalStyles: ComponentGlobalStyle[];
   tagName: string;
@@ -1324,20 +1406,6 @@ interface ComponentCompilerState {
  * Custom states are exposed via the ElementInternals.states CustomStateSet
  * and can be targeted with the CSS :state() pseudo-class.
  */
-interface ComponentCompilerCustomState {
-  /**
-   * The name of the custom state (without dashes)
-   */
-  name: string;
-  /**
-   * The initial value of the state
-   */
-  initialValue: boolean;
-  /**
-   * Optional JSDoc description for the state
-   */
-  docs: string;
-}
 /**
  * Representation of JSDoc that is pulled off a node in the AST
  */
@@ -1349,44 +1417,7 @@ interface CompilerJsDoc {
   /**
    * Tags included in the JSDoc
    */
-  tags: CompilerJsDocTagInfo[];
-}
-/**
- * Representation of a tag that exists in a JSDoc
- */
-interface CompilerJsDocTagInfo {
-  /**
-   * The name of the tag - e.g. `@deprecated`
-   */
-  name: string;
-  /**
-   * Additional text that is associated with the tag - e.g. `@deprecated use v2 of this API`
-   */
-  text?: string;
-}
-/**
- * The (internal) representation of a CSS block comment in a CSS, Sass, etc. file. This data structure is used during
- * the initial compilation phases of Stencil, as a piece of {@link ComponentCompilerMeta}.
- */
-interface CompilerStyleDoc {
-  /**
-   * The name of the CSS property
-   */
-  name: string;
-  /**
-   * The user-defined description of the CSS property
-   */
-  docs: string;
-  /**
-   * The JSDoc-style annotation (e.g. `@prop`) that was used in the block comment to detect the comment.
-   * Used to inform Stencil where the start of a new property's description starts (and where the previous description
-   * ends).
-   */
-  annotation: 'prop';
-  /**
-   * The Stencil style-mode that is associated with this property.
-   */
-  mode: string;
+  tags: JsonDocsTag[];
 }
 interface CompilerAssetDir {
   absolutePath?: string;
@@ -1526,7 +1557,7 @@ declare const transpileSync: (code: string, opts?: TranspileOptions) => Transpil
  * @param cmp the metadata for the component that a type definition string is generated for
  * @param typeImportData locally/imported/globally used type names, which may be used to prevent naming collisions
  * @param areTypesInternal `true` if types being generated are for a project's internal purposes, `false` otherwise
- * @param signalBacking `true` if the component is using signal backing for its props; includes the signals map on the element interface
+ * @param signalBacking `true` if the component is using signal backing for its props; includes the signals map on the element interface and unions JSX prop types with `ReadonlySignal<T>`
  * @returns the generated types string alongside additional metadata
  */
 declare const generateComponentTypes: (cmp: ComponentCompilerMeta, typeImportData: TypesImportData, areTypesInternal: boolean, signalBacking?: boolean) => TypesModule;