@stencil/core 5.0.0-beta.14 → 5.0.0-beta.15

package/dist/{client-CAQvc3hT.mjs → client-BUal4Vkx.mjs}

@@ -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 modeResolver = [];
-//#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 : {};
@@ -2122,9 +2135,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;
@@ -2393,4 +2404,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

@@ -91,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.
    */
@@ -104,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.
    */
@@ -136,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.
    *
@@ -150,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.
    */
@@ -172,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.
    */
@@ -211,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.
@@ -251,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;
   /**
@@ -775,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;

package/dist/compiler/browser.js

@@ -1844,7 +1844,7 @@ const validateComponentTag = (tag) => {
 };
 //#endregion
 //#region src/version.ts
-const version = "5.0.0-beta.14";
+const version = "5.0.0-beta.15";
 //#endregion
 //#region src/compiler/events.ts
 const buildEvents = () => {
@@ -2358,15 +2358,6 @@ const createSystem = (c) => {
 		}
 		return results;
 	};
-	/**
-	* `self` is the global namespace object used within a web worker.
-	* `window` is the browser's global namespace object (I reorganized this to check the reference on that second)
-	* `global` is Node's global namespace object. https://nodejs.org/api/globals.html#globals_global
-	*
-	* loading in this order should allow workers, which are most common, then browser,
-	* then Node to grab the reference to fetch correctly.
-	*/
-	const fetch = typeof self !== "undefined" ? self?.fetch : typeof window !== "undefined" ? window?.fetch : typeof global !== "undefined" ? global?.fetch : void 0;
 	const writeFile = async (p, data) => writeFileSync(p, data);
 	const tmpDirSync = () => "/.tmp";
 	const tick = Promise.resolve();
@@ -2377,6 +2368,7 @@ const createSystem = (c) => {
 		if (typeof hashLength === "number") hashHex = hashHex.slice(0, hashLength);
 		return hashHex;
 	};
+	const generateFileHash = async (filePath, hashLength) => generateContentHash(readFileSync(filePath), hashLength);
 	const copy = async (copyTasks, srcDir) => {
 		const results = {
 			diagnostics: [],
@@ -2386,9 +2378,6 @@ const createSystem = (c) => {
 		logger.info("todo, copy task", copyTasks.length, srcDir);
 		return results;
 	};
-	const getEnvironmentVar = (key) => {
-		return process$1?.env[key];
-	};
 	const getLocalModulePath = (opts) => join$1(opts.rootDir, "node_modules", opts.moduleId, opts.path);
 	const getRemoteModuleUrl = (opts) => {
 		const npmBaseUrl = "https://cdn.jsdelivr.net/npm/";
@@ -2404,13 +2393,14 @@ const createSystem = (c) => {
 		access,
 		accessSync,
 		addDestroy,
+		checkVersion: async () => noop,
 		copyFile,
 		createDir,
 		createDirSync,
 		homeDir,
 		isTTY,
-		getEnvironmentVar,
 		destroy,
+		dynamicImport: (p) => import(p),
 		encodeToBase64,
 		exit: async (exitCode) => logger.warn(`exit ${exitCode}`),
 		getCurrentDirectory,
@@ -2421,6 +2411,7 @@ const createSystem = (c) => {
 		isSymbolicLink,
 		nextTick,
 		normalizePath: normalize,
+		onProcessInterrupt: noop,
 		platformPath: path,
 		readDir,
 		readDirSync,
@@ -2430,7 +2421,6 @@ const createSystem = (c) => {
 		realpathSync,
 		removeDestroy,
 		rename,
-		fetch,
 		resolvePath,
 		removeDir,
 		removeDirSync,
@@ -2445,6 +2435,7 @@ const createSystem = (c) => {
 		writeFile,
 		writeFileSync,
 		generateContentHash,
+		generateFileHash,
 		createWorkerController: null,
 		details: {
 			cpuModel: "",
@@ -4928,12 +4919,10 @@ const optimizeCss = async (inputOpts) => {
 const CREATE_EVENT = "__stencil_createEvent";
 const DEFINE_CUSTOM_ELEMENT = "__stencil_defineCustomElement";
 const GET_ELEMENT = "__stencil_getElement";
-const HOST = "__stencil_Host";
 const HTML_ELEMENT = "HTMLElement";
 const PROXY_CUSTOM_ELEMENT = "__stencil_proxyCustomElement";
 const REGISTER_INSTANCE = "__stencil_registerInstance";
 const REGISTER_HOST = "__stencil_registerHost";
-const H = "__stencil_h";
 const TRANSFORM_TAG = "__stencil_transformTag";
 const GET_REGISTRY = "__stencil_getRegistry";
 const INJECT_SIDE_EFFECT_STYLE = "__stencil_injectSideEffectStyle";
@@ -4941,9 +4930,7 @@ const RUNTIME_APIS = {
 	createEvent: `createEvent as ${CREATE_EVENT}`,
 	defineCustomElement: `defineCustomElement as ${DEFINE_CUSTOM_ELEMENT}`,
 	getElement: `getElement as ${GET_ELEMENT}`,
-	h: `h as ${H}`,
 	legacyH: `h`,
-	Host: `Host as ${HOST}`,
 	HTMLElement: HTML_ELEMENT,
 	proxyCustomElement: `proxyCustomElement as ${PROXY_CUSTOM_ELEMENT}`,
 	registerHost: `registerHost as ${REGISTER_HOST}`,
@@ -10906,31 +10893,6 @@ const createIdentifierFromStyleIdentifier = (styleIdentifier, externalStyleIds)
 	return ts$1.factory.createBinaryExpression(createIdentifierFromStyleIdentifier(styleIdentifier, [id]), ts$1.SyntaxKind.PlusToken, createIdentifierFromStyleIdentifier(styleIdentifier, externalStyleIds.slice(1)));
 };
 //#endregion
-//#region src/compiler/transformers/host-data-transform.ts
-const transformHostData = (classElements, moduleFile) => {
-	if (classElements.some((e) => ts$1.isMethodDeclaration(e) && e.name.escapedText === "hostData")) {
-		const renderIndex = classElements.findIndex((e) => ts$1.isMethodDeclaration(e) && e.name.escapedText === "render");
-		if (renderIndex >= 0) {
-			const renderMethod = classElements[renderIndex];
-			classElements[renderIndex] = ts$1.factory.updateMethodDeclaration(renderMethod, retrieveModifierLike(renderMethod), renderMethod.asteriskToken, ts$1.factory.createIdentifier(INTERNAL_RENDER), renderMethod.questionToken, renderMethod.typeParameters, renderMethod.parameters, renderMethod.type, renderMethod.body);
-		}
-		classElements.push(syntheticRender(moduleFile, renderIndex >= 0));
-	}
-};
-const syntheticRender = (moduleFile, hasRender) => {
-	addCoreRuntimeApi(moduleFile, RUNTIME_APIS.Host);
-	addCoreRuntimeApi(moduleFile, RUNTIME_APIS.h);
-	const hArguments = [ts$1.factory.createIdentifier(HOST), ts$1.factory.createCallExpression(ts$1.factory.createPropertyAccessExpression(ts$1.factory.createThis(), "hostData"), void 0, void 0)];
-	if (hasRender) hArguments.push(ts$1.factory.createCallExpression(ts$1.factory.createPropertyAccessExpression(ts$1.factory.createThis(), INTERNAL_RENDER), void 0, void 0));
-	/**
-	* render() {
-	*   return h(arguments);
-	* }
-	*/
-	return ts$1.factory.createMethodDeclaration(void 0, void 0, "render", void 0, void 0, [], void 0, ts$1.factory.createBlock([ts$1.factory.createReturnStatement(ts$1.factory.createCallExpression(ts$1.factory.createIdentifier(H), void 0, hArguments))]));
-};
-const INTERNAL_RENDER = "__stencil_render";
-//#endregion
 //#region src/compiler/transformers/reactive-handler-meta-transform.ts
 /**
 * Add a getter to a class for a static representation of the watchers
@@ -11012,7 +10974,6 @@ const updateLazyComponentMembers = (transformOpts, styleStatements, classNode, m
 	addReactivePropHandlers(classMembers, cmp, "watchers");
 	addReactivePropHandlers(classMembers, cmp, "serializers");
 	addReactivePropHandlers(classMembers, cmp, "deserializers");
-	transformHostData(classMembers, moduleFile);
 	if (transformOpts.style === "static") addStaticStylePropertyToClass(styleStatements, cmp, buildCtx);
 	return classMembers;
 };
@@ -11460,7 +11421,6 @@ const updateNativeHostComponentMembers = (transformOpts, classNode, moduleFile,
 	addReactivePropHandlers(classMembers, cmp, "deserializers");
 	if (cmp.isPlain) addNativeComponentMeta(classMembers, cmp);
 	if (transformOpts.style === "static") addNativeStaticStyle(classMembers, cmp, buildCtx);
-	transformHostData(classMembers, moduleFile);
 	return classMembers;
 };
 //#endregion
@@ -11663,110 +11623,6 @@ const isDecoratorNamed = (propName) => {
 	};
 };
 //#endregion
-//#region src/compiler/transformers/decorators-to-static/attach-internals.ts
-/**
-* Convert the attach internals decorator to static, saving the name of the
-* decorated property so an `ElementInternals` object can be bound to it later
-* on.
-*
-* The `@AttachInternals` decorator is used to indicate a field on a class
-* where the return value of the `HTMLElement.attachInternals` method should be
-* bound. This then allows component authors to use that interface to make their
-* Stencil components rich participants in whatever `HTMLFormElement` instances
-* they find themselves inside of in the future.
-*
-* The decorator also accepts an optional `states` option to define initial
-* custom states that will be set on the `ElementInternals.states` CustomStateSet.
-* Each state property can have a JSDoc comment that will be extracted for documentation.
-*
-* **Note**: this function will mutate the `newMembers` parameter in order to
-* add new members to the class.
-*
-* @param diagnostics for reporting errors and warnings
-* @param decoratedMembers the decorated members found on the class
-* @param newMembers an out param for new class members
-* @param typeChecker a TypeScript typechecker, needed for resolving the prop
-* declaration name
-* @param decoratorName the name of the decorator to look for
-*/
-const attachInternalsDecoratorsToStatic = (diagnostics, decoratedMembers, newMembers, typeChecker, decoratorName) => {
-	const attachInternalsMembers = decoratedMembers.filter(ts$1.isPropertyDeclaration).filter((prop) => {
-		return !!retrieveTsDecorators(prop)?.find(isDecoratorNamed(decoratorName));
-	});
-	if (attachInternalsMembers.length === 0) return;
-	if (attachInternalsMembers.length > 1) {
-		const error = buildError(diagnostics);
-		error.messageText = `Stencil does not support adding more than one AttachInternals() decorator to a component`;
-		return;
-	}
-	const [decoratedProp] = attachInternalsMembers;
-	const { staticName: name } = tsPropDeclName(decoratedProp, typeChecker);
-	const decorator = retrieveTsDecorators(decoratedProp)?.find(isDecoratorNamed(decoratorName));
-	const customStates = parseCustomStatesFromDecorator(decorator, typeChecker);
-	const formAssociated = parseFormAssociatedFromDecorator(decorator);
-	newMembers.push(createStaticGetter("attachInternalsMemberName", convertValueToLiteral(name)));
-	if (customStates.length > 0) newMembers.push(createStaticGetter("attachInternalsCustomStates", convertValueToLiteral(customStates)));
-	if (formAssociated) newMembers.push(createStaticGetter("formAssociated", convertValueToLiteral(true)));
-};
-/**
-* Parse the formAssociated option from the decorator.
-* Returns true (form-associated) unless explicitly set to false.
-*
-* @param decorator the decorator node to parse
-* @returns whether the component should be form-associated
-*/
-function parseFormAssociatedFromDecorator(decorator) {
-	if (!decorator || !ts$1.isCallExpression(decorator.expression)) return true;
-	const [firstArg] = decorator.expression.arguments;
-	if (!firstArg || !ts$1.isObjectLiteralExpression(firstArg)) return true;
-	const formAssociatedProp = firstArg.properties.find((prop) => ts$1.isPropertyAssignment(prop) && ts$1.isIdentifier(prop.name) && prop.name.text === "formAssociated");
-	if (!formAssociatedProp) return true;
-	if (formAssociatedProp.initializer.kind === ts$1.SyntaxKind.FalseKeyword) return false;
-	return true;
-}
-/**
-* Parse custom states from the decorator AST, including JSDoc comments.
-*
-* Supports JSDoc comments on state properties:
-* ```ts
-* @AttachInternals({
-*   states: {
-*     hovered: false,
-*     /** Whether is currently active */
-*     active: true
-*   }
-* })
-* ```
-*
-* @param decorator the decorator node to parse
-* @param typeChecker a TypeScript typechecker for resolving symbols
-* @returns array of custom state metadata with docs
-*/
-function parseCustomStatesFromDecorator(decorator, typeChecker) {
-	if (!decorator || !ts$1.isCallExpression(decorator.expression)) return [];
-	const [firstArg] = decorator.expression.arguments;
-	if (!firstArg || !ts$1.isObjectLiteralExpression(firstArg)) return [];
-	const statesProp = firstArg.properties.find((prop) => ts$1.isPropertyAssignment(prop) && ts$1.isIdentifier(prop.name) && prop.name.text === "states");
-	if (!statesProp || !ts$1.isObjectLiteralExpression(statesProp.initializer)) return [];
-	const customStates = [];
-	for (const prop of statesProp.initializer.properties) {
-		if (!ts$1.isPropertyAssignment(prop)) continue;
-		const stateName = ts$1.isIdentifier(prop.name) ? prop.name.text : ts$1.isStringLiteral(prop.name) ? prop.name.text : null;
-		if (!stateName) continue;
-		let initialValue = false;
-		if (prop.initializer.kind === ts$1.SyntaxKind.TrueKeyword) initialValue = true;
-		else if (prop.initializer.kind === ts$1.SyntaxKind.FalseKeyword) initialValue = false;
-		const symbol = typeChecker.getSymbolAtLocation(prop.name);
-		const docs = symbol ? ts$1.displayPartsToString(symbol.getDocumentationComment(typeChecker)) : "";
-		customStates.push({
-			name: stateName,
-			initialValue,
-			docs
-		});
-	}
-	return customStates;
-}
-//#endregion
 //#region src/compiler/transformers/decorators-to-static/style-to-static.ts
 const styleToStatic = (newMembers, componentOptions) => {
 	const defaultModeStyles = [];
@@ -11831,6 +11687,12 @@ const normalizeStyleUrl = (style) => {
 //#region src/compiler/transformers/decorators-to-static/component-decorator.ts
 let hasShownDeprecatedApiError = false;
 /**
+* Reset the deprecated API error flag. Call this at the start of each build.
+*/
+const resetDeprecatedApiWarning = () => {
+	hasShownDeprecatedApiError = false;
+};
+/**
 * Perform code generation to create new class members for a Stencil component
 * which will drive the runtime functionality specified by various options
 * passed to the `@Component` decorator.
@@ -12031,6 +11893,110 @@ const findTagNode = (propName, node) => {
 	return out;
 };
 //#endregion
+//#region src/compiler/transformers/decorators-to-static/attach-internals.ts
+/**
+* Convert the attach internals decorator to static, saving the name of the
+* decorated property so an `ElementInternals` object can be bound to it later
+* on.
+*
+* The `@AttachInternals` decorator is used to indicate a field on a class
+* where the return value of the `HTMLElement.attachInternals` method should be
+* bound. This then allows component authors to use that interface to make their
+* Stencil components rich participants in whatever `HTMLFormElement` instances
+* they find themselves inside of in the future.
+*
+* The decorator also accepts an optional `states` option to define initial
+* custom states that will be set on the `ElementInternals.states` CustomStateSet.
+* Each state property can have a JSDoc comment that will be extracted for documentation.
+*
+* **Note**: this function will mutate the `newMembers` parameter in order to
+* add new members to the class.
+*
+* @param diagnostics for reporting errors and warnings
+* @param decoratedMembers the decorated members found on the class
+* @param newMembers an out param for new class members
+* @param typeChecker a TypeScript typechecker, needed for resolving the prop
+* declaration name
+* @param decoratorName the name of the decorator to look for
+*/
+const attachInternalsDecoratorsToStatic = (diagnostics, decoratedMembers, newMembers, typeChecker, decoratorName) => {
+	const attachInternalsMembers = decoratedMembers.filter(ts$1.isPropertyDeclaration).filter((prop) => {
+		return !!retrieveTsDecorators(prop)?.find(isDecoratorNamed(decoratorName));
+	});
+	if (attachInternalsMembers.length === 0) return;
+	if (attachInternalsMembers.length > 1) {
+		const error = buildError(diagnostics);
+		error.messageText = `Stencil does not support adding more than one AttachInternals() decorator to a component`;
+		return;
+	}
+	const [decoratedProp] = attachInternalsMembers;
+	const { staticName: name } = tsPropDeclName(decoratedProp, typeChecker);
+	const decorator = retrieveTsDecorators(decoratedProp)?.find(isDecoratorNamed(decoratorName));
+	const customStates = parseCustomStatesFromDecorator(decorator, typeChecker);
+	const formAssociated = parseFormAssociatedFromDecorator(decorator);
+	newMembers.push(createStaticGetter("attachInternalsMemberName", convertValueToLiteral(name)));
+	if (customStates.length > 0) newMembers.push(createStaticGetter("attachInternalsCustomStates", convertValueToLiteral(customStates)));
+	if (formAssociated) newMembers.push(createStaticGetter("formAssociated", convertValueToLiteral(true)));
+};
+/**
+* Parse the formAssociated option from the decorator.
+* Returns true (form-associated) unless explicitly set to false.
+*
+* @param decorator the decorator node to parse
+* @returns whether the component should be form-associated
+*/
+function parseFormAssociatedFromDecorator(decorator) {
+	if (!decorator || !ts$1.isCallExpression(decorator.expression)) return true;
+	const [firstArg] = decorator.expression.arguments;
+	if (!firstArg || !ts$1.isObjectLiteralExpression(firstArg)) return true;
+	const formAssociatedProp = firstArg.properties.find((prop) => ts$1.isPropertyAssignment(prop) && ts$1.isIdentifier(prop.name) && prop.name.text === "formAssociated");
+	if (!formAssociatedProp) return true;
+	if (formAssociatedProp.initializer.kind === ts$1.SyntaxKind.FalseKeyword) return false;
+	return true;
+}
+/**
+* Parse custom states from the decorator AST, including JSDoc comments.
+*
+* Supports JSDoc comments on state properties:
+* ```ts
+* @AttachInternals({
+*   states: {
+*     hovered: false,
+*     /** Whether is currently active */
+*     active: true
+*   }
+* })
+* ```
+*
+* @param decorator the decorator node to parse
+* @param typeChecker a TypeScript typechecker for resolving symbols
+* @returns array of custom state metadata with docs
+*/
+function parseCustomStatesFromDecorator(decorator, typeChecker) {
+	if (!decorator || !ts$1.isCallExpression(decorator.expression)) return [];
+	const [firstArg] = decorator.expression.arguments;
+	if (!firstArg || !ts$1.isObjectLiteralExpression(firstArg)) return [];
+	const statesProp = firstArg.properties.find((prop) => ts$1.isPropertyAssignment(prop) && ts$1.isIdentifier(prop.name) && prop.name.text === "states");
+	if (!statesProp || !ts$1.isObjectLiteralExpression(statesProp.initializer)) return [];
+	const customStates = [];
+	for (const prop of statesProp.initializer.properties) {
+		if (!ts$1.isPropertyAssignment(prop)) continue;
+		const stateName = ts$1.isIdentifier(prop.name) ? prop.name.text : ts$1.isStringLiteral(prop.name) ? prop.name.text : null;
+		if (!stateName) continue;
+		let initialValue = false;
+		if (prop.initializer.kind === ts$1.SyntaxKind.TrueKeyword) initialValue = true;
+		else if (prop.initializer.kind === ts$1.SyntaxKind.FalseKeyword) initialValue = false;
+		const symbol = typeChecker.getSymbolAtLocation(prop.name);
+		const docs = symbol ? ts$1.displayPartsToString(symbol.getDocumentationComment(typeChecker)) : "";
+		customStates.push({
+			name: stateName,
+			initialValue,
+			docs
+		});
+	}
+	return customStates;
+}
+//#endregion
 //#region src/compiler/transformers/decorators-to-static/decorators-constants.ts
 /**
 * All the decorators supported by Stencil
@@ -15083,7 +15049,6 @@ function mergeExtendedClassMetaWithResolveImport(cmpNode, staticMembers, sourceF
 //#region src/compiler/transformers/static-to-meta/class-methods.ts
 const parseClassMethods = (classMethods, cmpMeta) => {
 	if (!classMethods?.length) return;
-	const hasHostData = classMethods.includes("hostData");
 	cmpMeta.hasAttributeChangedCallbackFn = classMethods.includes("attributeChangedCallback");
 	cmpMeta.hasConnectedCallbackFn = classMethods.includes("connectedCallback");
 	cmpMeta.hasDisconnectedCallbackFn = classMethods.includes("disconnectedCallback");
@@ -15095,8 +15060,7 @@ const parseClassMethods = (classMethods, cmpMeta) => {
 	cmpMeta.hasComponentShouldUpdateFn = classMethods.includes("componentShouldUpdate");
 	cmpMeta.hasComponentDidUpdateFn = classMethods.includes("componentDidUpdate");
 	cmpMeta.hasLifecycle = cmpMeta.hasComponentWillLoadFn || cmpMeta.hasComponentDidLoadFn || cmpMeta.hasComponentWillUpdateFn || cmpMeta.hasComponentDidUpdateFn;
-	cmpMeta.hasRenderFn = classMethods.includes("render") || hasHostData;
-	cmpMeta.hasVdomRender = cmpMeta.hasVdomRender || hasHostData;
+	cmpMeta.hasRenderFn = classMethods.includes("render");
 };
 //#endregion
 //#region src/compiler/transformers/static-to-meta/element-ref.ts
@@ -15995,6 +15959,7 @@ const transpileModule = (config, input, transformOpts) => {
 		...config,
 		logger: createNodeLogger()
 	};
+	resetDeprecatedApiWarning();
 	const compilerCtx = new CompilerContext();
 	const buildCtx = new BuildContext(config, compilerCtx);
 	const tsCompilerOptions = { ...config.tsCompilerOptions };