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

package/dist/compiler/browser.js

@@ -1844,7 +1844,7 @@ const validateComponentTag = (tag) => {
 };
 //#endregion
 //#region src/version.ts
-const version = "5.0.0-beta.20";
+const version = "5.0.0-beta.22";
 //#endregion
 //#region src/compiler/events.ts
 const buildEvents = () => {
@@ -2643,14 +2643,14 @@ const getTranspileCssConfig = (compileOpts, importData, results) => {
 };
 const getTranspileConfigOpt = (value, validValues, defaultValue) => {
 	if (value === null || value === "null") return null;
-	value = isString$1(value) ? value.toLowerCase().trim() : null;
+	value = isString$1(value) ? value.toLowerCase().trim() : void 0;
 	if (validValues.has(value)) return value;
 	return defaultValue;
 };
 const VALID_EXPORT = /* @__PURE__ */ new Set(["customelement", "module"]);
-const VALID_METADATA = /* @__PURE__ */ new Set(["compilerstatic", null]);
+const VALID_METADATA = /* @__PURE__ */ new Set(["compilerstatic"]);
 const VALID_MODULE = /* @__PURE__ */ new Set(["cjs", "esm"]);
-const VALID_PROXY = /* @__PURE__ */ new Set(["defineproperty", null]);
+const VALID_PROXY = /* @__PURE__ */ new Set(["defineproperty"]);
 const VALID_STYLE = /* @__PURE__ */ new Set(["static"]);
 const VALID_STYLE_IMPORT_DATA = /* @__PURE__ */ new Set(["queryparams"]);
 const VALID_TARGET = /* @__PURE__ */ new Set([
@@ -2830,7 +2830,7 @@ const validateReadmeOutputTarget = (config, outputTarget) => {
 	if (!isAbsolute(outputTarget.dir)) outputTarget.dir = join$1(config.rootDir, outputTarget.dir);
 	if (outputTarget.footer == null) outputTarget.footer = NOTE;
 	outputTarget.strict = !!outputTarget.strict;
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const validateJsonDocsOutputTarget = (config, diagnostics, outputTarget) => {
@@ -2842,7 +2842,7 @@ const validateJsonDocsOutputTarget = (config, diagnostics, outputTarget) => {
 	if (isString$1(outputTarget.typesFile) && !isAbsolute(outputTarget.typesFile)) outputTarget.typesFile = join$1(config.rootDir, outputTarget.typesFile);
 	else if (outputTarget.typesFile !== null && outputTarget.file.endsWith(".json")) outputTarget.typesFile = outputTarget.file.replace(/\.json$/, ".d.ts");
 	outputTarget.strict = !!outputTarget.strict;
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const validateCustomDocsOutputTarget = (config, diagnostics, outputTarget) => {
@@ -2851,7 +2851,7 @@ const validateCustomDocsOutputTarget = (config, diagnostics, outputTarget) => {
 		err.messageText = `docs-custom outputTarget missing the "generator" function`;
 	}
 	outputTarget.strict = !!outputTarget.strict;
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const validateVScodeDocsOutputTarget = (config, diagnostics, outputTarget) => {
@@ -2859,21 +2859,21 @@ const validateVScodeDocsOutputTarget = (config, diagnostics, outputTarget) => {
 		const err = buildError(diagnostics);
 		err.messageText = `docs-vscode outputTarget missing the "file" path`;
 	}
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const DEFAULT_AGENT_SKILL_DIR = "dist/skill";
 const validateAgentSkillOutputTarget = (config, outputTarget) => {
 	outputTarget.dir = getAbsolutePath(config, outputTarget.dir || DEFAULT_AGENT_SKILL_DIR);
 	outputTarget.name = toSkillName(outputTarget.name || config.fsNamespace);
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const validateCustomElementsManifestOutputTarget = (config, outputTarget) => {
 	if (!isString$1(outputTarget.file)) outputTarget.file = "custom-elements.json";
 	if (!isAbsolute(outputTarget.file)) outputTarget.file = join$1(config.rootDir, outputTarget.file);
 	outputTarget.strict = !!outputTarget.strict;
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 //#endregion
@@ -15440,13 +15440,13 @@ const parseStaticComponentMeta = (compilerCtx, typeChecker, cmpNode, moduleFile,
 		hasPatchClone: false,
 		hasPatchInsert: false
 	};
-	const visitComponentChildNode = (node, ctx) => {
-		validateComponentMembers(node, ctx);
+	if (!isCollectionDependency) validateComponentMembers(cmpNode, buildCtx);
+	const visitComponentChildNode = (node) => {
 		if (ts$1.isCallExpression(node)) parseCallExpression(cmp, node, typeChecker);
 		else if (ts$1.isStringLiteral(node)) parseStringLiteral(cmp, node);
-		node.forEachChild((child) => visitComponentChildNode(child, ctx));
+		node.forEachChild(visitComponentChildNode);
 	};
-	visitComponentChildNode(cmpNode, buildCtx);
+	visitComponentChildNode(cmpNode);
 	parseClassMethods(classMethods, cmp);
 	cmp.hasModernPropertyDecls = detectModernPropDeclarations(cmpNode) || doesExtend;
 	cmp.htmlAttrNames = unique(cmp.htmlAttrNames);
@@ -15464,31 +15464,32 @@ const parseStaticComponentMeta = (compilerCtx, typeChecker, cmpNode, moduleFile,
 	return cmpNode;
 };
 /**
-* Check whether a class declaration is a Stencil component, i.e. it's
-* decorated with `@Component({ tag: ... })`.
-* @param classNode the class declaration to check
-* @returns whether `classNode` is a Stencil component class
+* Warn about members a Stencil component class should not define.
+* @param cmpNode the component class declaration
+* @param buildCtx the current build context, used to surface diagnostics
 */
-const isStencilComponentClass = (classNode) => {
-	const decorator = ts$1.getDecorators(classNode)?.[0];
-	return decorator != null && ts$1.isCallExpression(decorator.expression) && decorator.expression.arguments.length === 1 && ts$1.isObjectLiteralExpression(decorator.expression.arguments[0]) && decorator.expression.arguments[0].properties.some((prop) => ts$1.isPropertyAssignment(prop) && prop.name.getText() === "tag");
-};
-const validateComponentMembers = (node, buildCtx) => {
-	/**
-	* validate if:
-	*/
-	if (ts$1.isGetAccessorDeclaration(node) && ts$1.isIdentifier(node.name) && typeof node.name.escapedText === "string" && BLACKLISTED_COMPONENT_METHODS.includes(node.name.escapedText) && node.parent && ts$1.isClassDeclaration(node.parent) && isStencilComponentClass(node.parent)) {
-		const propName = node.name.escapedText;
-		const componentName = node.parent.name.getText();
-		const err = buildWarn(buildCtx.diagnostics);
-		err.messageText = `The component "${componentName}" has a getter called "${propName}". This getter is reserved for use by Stencil components and should not be defined by the user.`;
-		augmentDiagnosticWithNode(err, node);
-	}
-	if (ts$1.isMethodDeclaration(node) && ts$1.isIdentifier(node.name) && node.name.escapedText === "componentShouldUpdate" && node.parameters.length > 1 && node.parent && ts$1.isClassDeclaration(node.parent) && isStencilComponentClass(node.parent)) {
-		const componentName = node.parent.name.getText();
-		const err = buildWarn(buildCtx.diagnostics);
-		err.messageText = `The component "${componentName}" defines "componentShouldUpdate" with ${node.parameters.length} parameters. As of Stencil v5, "componentShouldUpdate" is called once per render with a single "changes" argument (a map of prop/state names to "{ newVal, oldVal }") instead of once per prop with "(newVal, oldVal, propName)". This method will still compile, but any extra parameters will be "undefined" at runtime.`;
-		augmentDiagnosticWithNode(err, node);
+const validateComponentMembers = (cmpNode, buildCtx) => {
+	const componentName = cmpNode.name?.text ?? "";
+	for (const member of cmpNode.members) {
+		if (!member.name || !ts$1.isIdentifier(member.name)) continue;
+		const memberName = member.name.text;
+		/**
+		* the component has a getter called "shadowRoot"
+		*/
+		if (ts$1.isGetAccessorDeclaration(member) && BLACKLISTED_COMPONENT_METHODS.includes(memberName)) {
+			const err = buildWarn(buildCtx.diagnostics);
+			err.messageText = `The component "${componentName}" has a getter called "${memberName}". This getter is reserved for use by Stencil components and should not be defined by the user.`;
+			augmentDiagnosticWithNode(err, ts$1.getOriginalNode(member));
+		}
+		/**
+		* the component defines a "componentShouldUpdate" method with more than one parameter,
+		* which was the pre-v5 per-prop signature "(newVal, oldVal, propName)"
+		*/
+		if (ts$1.isMethodDeclaration(member) && memberName === "componentShouldUpdate" && member.parameters.length > 1) {
+			const err = buildWarn(buildCtx.diagnostics);
+			err.messageText = `The component "${componentName}" defines "componentShouldUpdate" with ${member.parameters.length} parameters. As of Stencil v5, "componentShouldUpdate" is called once per render with a single "changes" argument (a map of prop/state names to "{ newVal, oldVal }") instead of once per prop with "(newVal, oldVal, propName)". This method will still compile, but any extra parameters will be "undefined" at runtime.`;
+			augmentDiagnosticWithNode(err, ts$1.getOriginalNode(member));
+		}
 	}
 };
 const parseVirtualProps = (docs) => {

package/dist/compiler/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as CompilerFsStats, $n as WorkerMainController, $t as OutputTargetBuild, A as BuildOverrides, An as ResolveModuleIdResults, At as HotModuleReplacement, B as CompilerEventBuildLog, Bn as SsrFactoryOptions, Bt as Logger, C as BuildEmitEvents, Cn as PluginTransformResults, Cr as JsonDocsStyle, Ct as DevServerEditor, D as BuildOnEventRemove, Dn as PrerenderResults, Dr as JsonDocsValue, Dt as HistoryApiFallback, E as BuildNoChangeResults, En as PrerenderOptions, Er as JsonDocsUsage, Et as FsWatchResults, F as Compiler, Fn as SerializeDocumentOptions, Ft as LazyRequire, G as CompilerEventFileAdd, Gn as TransformOptions, Gt as OptimizeCssInput, H as CompilerEventBuildStart, Hn as StencilDevServerConfig, Ht as LoggerTimeSpan, I as CompilerBuildResults, In as ServiceWorkerConfig, It as LightDomPatches, J as CompilerEventFsChange, Jn as TranspileResults, Jt as OptimizeJsOutput, K as CompilerEventFileDelete, Kn as TranspileOnlyResults, Kt as OptimizeCssOutput, L as CompilerBuildStart, Ln as SitemapXmpOpts, Lt as LoadConfigInit, M as CliInitOptions, Mn as RobotsTxtOpts, Mt as HydrateFactoryOptions, N as CompileScriptMinifyOptions, Nn as RobotsTxtResults, Nt as HydratedFlag, O as BuildOnEvents, On as PrerenderStartOptions, Or as StyleDoc, Ot as HmrGlobalStyleUpdate, P as CompileTarget, Pn as RolldownConfig, Pt as LOG_LEVELS, Q as CompilerFileWatcherEvent, Qn as WatcherCloseResults, Qt as OutputTargetBaseNext, R as CompilerDependency, Rn as SitemapXmpResults, Rt as LoadConfigResults, S as AutoprefixerOptions, Sn as PluginCtx, Sr as JsonDocsSlot, St as DevServerConfig, T as BuildLog, Tn as PrerenderHydrateOptions, Tr as JsonDocsTypeLibrary, Tt as DocsReadmeCustomColumn, U as CompilerEventDirAdd, Un as StencilDocsConfig, Ut as ModeConfig, V as CompilerEventBuildNoChange, Vn as StencilConfig, Vt as LoggerLineUpdater, W as CompilerEventDirDelete, Wn as SystemDetails, Wt as NodeResolveConfig, X as CompilerFileWatcher, Xn as ValidatedConfig, Xt as OutputTargetAssets, Y as CompilerEventName, Yn as UnvalidatedConfig, Yt as OutputTarget, Z as CompilerFileWatcherCallback, Zn as ValidatedOutputTargetWww, Zt as OutputTargetBase, _ as PrintLine, _n as OutputTargetWww, _r as JsonDocsListener, _t as CopyTask, a as ComponentCompilerEvent, an as OutputTargetDocsCustom, at as CompilerSystemRealpathResults, b as SsrResults, bn as PlatformPath, br as JsonDocsPart, bt as CustomElementsExportBehaviorOptions, c as ComponentCompilerMethod, cn as OutputTargetDocsReadme, ct as CompilerSystemRemoveFileResults, d as ComponentCompilerTypeReferences, dn as OutputTargetLoaderBundle, dr as JsonDocMethodParameter, dt as CompilerSystemWriteFileResults, en as OutputTargetCollection, er as WorkerOptions, et as CompilerRequest, f as ComponentGlobalStyle, fn as OutputTargetSsr, fr as JsonDocs, ft as CompilerWatcher, g as PrerenderUrlResults, gn as OutputTargetTypes, gr as JsonDocsEvent, gt as CopyResults, h as PackageJsonData, hn as OutputTargetStats, hr as JsonDocsDependencyGraph, ht as ConfigCompat, i as CompilerWorkerContext, in as OutputTargetDocsAgentSkill, it as CompilerSystemCreateDirectoryResults, j as BuildResultsComponentGraph, jn as ResolveModuleOptions, jt as HydrateDocumentOptions, k as BuildOutput, kn as ResolveModuleIdOptions, kr as FsWriteResults, kt as HmrStyleUpdate, l as ComponentCompilerProperty, ln as OutputTargetDocsVscode, lr as UserBuildConditionals, lt as CompilerSystemRenameResults, m as LazyBundlesRuntimeData, mn as OutputTargetStandalone, mr as JsonDocsCustomState, mt as ConfigBundle, nn as OutputTargetCustom, nt as CompilerSystem, o as ComponentCompilerListener, on as OutputTargetDocsCustomElementsManifest, ot as CompilerSystemRemoveDirectoryOptions, pn as OutputTargetSsrWasm, pr as JsonDocsComponent, pt as Config, q as CompilerEventFileUpdate, qn as TranspileOptions, qt as OptimizeJsInput, r as CompilerCtx, rn as OutputTargetDistLazy, rt as CompilerSystemCreateDirectoryOptions, s as ComponentCompilerMeta, sn as OutputTargetDocsJson, st as CompilerSystemRemoveDirectoryResults, t as BuildCtx, tn as OutputTargetCopy, tt as CompilerRequestResponse, u as ComponentCompilerState, un as OutputTargetGlobalStyle, ut as CompilerSystemRenamedPath, vn as PageReloadStrategy, vr as JsonDocsMethod, vt as Credentials, w as BuildEvents, wn as PrerenderConfig, wr as JsonDocsTag, wt as Diagnostic, x as WorkerMsgHandler, xn as Plugin, xr as JsonDocsProp, xt as DevServer, yn as ParsedPath, yr as JsonDocsMethodReturn, yt as CustomElementsExportBehavior, z as CompilerEventBuildFinish, zn as SsrDocumentOptions, zt as LogLevel } from "../index-B9-Byy8z.mjs";
+import { $ as CompilerFsStats, $n as WorkerMainController, $t as OutputTargetBuild, A as BuildOverrides, An as ResolveModuleIdResults, At as HotModuleReplacement, B as CompilerEventBuildLog, Bn as SsrFactoryOptions, Bt as Logger, C as BuildEmitEvents, Cn as PluginTransformResults, Cr as JsonDocsStyle, Ct as DevServerEditor, D as BuildOnEventRemove, Dn as PrerenderResults, Dr as JsonDocsValue, Dt as HistoryApiFallback, E as BuildNoChangeResults, En as PrerenderOptions, Er as JsonDocsUsage, Et as FsWatchResults, F as Compiler, Fn as SerializeDocumentOptions, Ft as LazyRequire, G as CompilerEventFileAdd, Gn as TransformOptions, Gt as OptimizeCssInput, H as CompilerEventBuildStart, Hn as StencilDevServerConfig, Ht as LoggerTimeSpan, I as CompilerBuildResults, In as ServiceWorkerConfig, It as LightDomPatches, J as CompilerEventFsChange, Jn as TranspileResults, Jt as OptimizeJsOutput, K as CompilerEventFileDelete, Kn as TranspileOnlyResults, Kt as OptimizeCssOutput, L as CompilerBuildStart, Ln as SitemapXmpOpts, Lt as LoadConfigInit, M as CliInitOptions, Mn as RobotsTxtOpts, Mt as HydrateFactoryOptions, N as CompileScriptMinifyOptions, Nn as RobotsTxtResults, Nt as HydratedFlag, O as BuildOnEvents, On as PrerenderStartOptions, Or as StyleDoc, Ot as HmrGlobalStyleUpdate, P as CompileTarget, Pn as RolldownConfig, Pt as LOG_LEVELS, Q as CompilerFileWatcherEvent, Qn as WatcherCloseResults, Qt as OutputTargetBaseNext, R as CompilerDependency, Rn as SitemapXmpResults, Rt as LoadConfigResults, S as AutoprefixerOptions, Sn as PluginCtx, Sr as JsonDocsSlot, St as DevServerConfig, T as BuildLog, Tn as PrerenderHydrateOptions, Tr as JsonDocsTypeLibrary, Tt as DocsReadmeCustomColumn, U as CompilerEventDirAdd, Un as StencilDocsConfig, Ut as ModeConfig, V as CompilerEventBuildNoChange, Vn as StencilConfig, Vt as LoggerLineUpdater, W as CompilerEventDirDelete, Wn as SystemDetails, Wt as NodeResolveConfig, X as CompilerFileWatcher, Xn as ValidatedConfig, Xt as OutputTargetAssets, Y as CompilerEventName, Yn as UnvalidatedConfig, Yt as OutputTarget, Z as CompilerFileWatcherCallback, Zn as ValidatedOutputTargetWww, Zt as OutputTargetBase, _ as PrintLine, _n as OutputTargetWww, _r as JsonDocsListener, _t as CopyTask, a as ComponentCompilerEvent, an as OutputTargetDocsCustom, at as CompilerSystemRealpathResults, b as SsrResults, bn as PlatformPath, br as JsonDocsPart, bt as CustomElementsExportBehaviorOptions, c as ComponentCompilerMethod, cn as OutputTargetDocsReadme, ct as CompilerSystemRemoveFileResults, d as ComponentCompilerTypeReferences, dn as OutputTargetLoaderBundle, dr as JsonDocMethodParameter, dt as CompilerSystemWriteFileResults, en as OutputTargetCollection, er as WorkerOptions, et as CompilerRequest, f as ComponentGlobalStyle, fn as OutputTargetSsr, fr as JsonDocs, ft as CompilerWatcher, g as PrerenderUrlResults, gn as OutputTargetTypes, gr as JsonDocsEvent, gt as CopyResults, h as PackageJsonData, hn as OutputTargetStats, hr as JsonDocsDependencyGraph, ht as ConfigCompat, i as CompilerWorkerContext, in as OutputTargetDocsAgentSkill, it as CompilerSystemCreateDirectoryResults, j as BuildResultsComponentGraph, jn as ResolveModuleOptions, jt as HydrateDocumentOptions, k as BuildOutput, kn as ResolveModuleIdOptions, kr as FsWriteResults, kt as HmrStyleUpdate, l as ComponentCompilerProperty, ln as OutputTargetDocsVscode, lr as UserBuildConditionals, lt as CompilerSystemRenameResults, m as LazyBundlesRuntimeData, mn as OutputTargetStandalone, mr as JsonDocsCustomState, mt as ConfigBundle, nn as OutputTargetCustom, nt as CompilerSystem, o as ComponentCompilerListener, on as OutputTargetDocsCustomElementsManifest, ot as CompilerSystemRemoveDirectoryOptions, pn as OutputTargetSsrWasm, pr as JsonDocsComponent, pt as Config, q as CompilerEventFileUpdate, qn as TranspileOptions, qt as OptimizeJsInput, r as CompilerCtx, rn as OutputTargetDistLazy, rt as CompilerSystemCreateDirectoryOptions, s as ComponentCompilerMeta, sn as OutputTargetDocsJson, st as CompilerSystemRemoveDirectoryResults, t as BuildCtx, tn as OutputTargetCopy, tt as CompilerRequestResponse, u as ComponentCompilerState, un as OutputTargetGlobalStyle, ut as CompilerSystemRenamedPath, vn as PageReloadStrategy, vr as JsonDocsMethod, vt as Credentials, w as BuildEvents, wn as PrerenderConfig, wr as JsonDocsTag, wt as Diagnostic, x as WorkerMsgHandler, xn as Plugin, xr as JsonDocsProp, xt as DevServer, yn as ParsedPath, yr as JsonDocsMethodReturn, yt as CustomElementsExportBehavior, z as CompilerEventBuildFinish, zn as SsrDocumentOptions, zt as LogLevel } from "../index-ZTa5XM0M.mjs";
 import ts from "typescript";
 import { Plugin as Plugin$1 } from "rolldown";
 //#region src/version.d.ts

package/dist/compiler/index.mjs

@@ -1,3 +1,3 @@
-import { A as version, C as hasStencilHydrateImport, D as parseCssOnlyComponents, E as replaceStencilHydrateImport, M as scopeCss, O as buildId, S as hasStencilGlobalsImport, T as replaceStencilGlobalsImport, _ as cmpMetaToDocsComponent, a as createPrerenderer, b as buildHydrateCss, c as createWorkerContext, d as nodeRequire, f as optimizeCss, g as generateManifest, h as generateComponentTypesFile, i as createSystem, j as versions, k as vermoji, l as createWorkerMessageHandler, m as validateHydrated, n as transpile, o as loadConfig, p as validateConfig, r as transpileSync, s as createCompiler, t as ts, u as optimizeJs, v as getScopeId, w as replaceStencilCssComponentsImport, x as hasStencilCssComponentsImport, y as foldBuildFlags } from "../compiler-CUsOl_Kw.mjs";
+import { A as version, C as hasStencilHydrateImport, D as parseCssOnlyComponents, E as replaceStencilHydrateImport, M as scopeCss, O as buildId, S as hasStencilGlobalsImport, T as replaceStencilGlobalsImport, _ as cmpMetaToDocsComponent, a as createPrerenderer, b as buildHydrateCss, c as createWorkerContext, d as nodeRequire, f as optimizeCss, g as generateManifest, h as generateComponentTypesFile, i as createSystem, j as versions, k as vermoji, l as createWorkerMessageHandler, m as validateHydrated, n as transpile, o as loadConfig, p as validateConfig, r as transpileSync, s as createCompiler, t as ts, u as optimizeJs, v as getScopeId, w as replaceStencilCssComponentsImport, x as hasStencilCssComponentsImport, y as foldBuildFlags } from "../compiler-CShHxskG.mjs";
 import { a as LOG_LEVELS, i as CustomElementsExportBehaviorOptions } from "../node-Bz2SOK7_.mjs";
 export { CustomElementsExportBehaviorOptions, LOG_LEVELS, buildHydrateCss, buildId, cmpMetaToDocsComponent, createCompiler, createPrerenderer, createSystem, createWorkerContext, createWorkerMessageHandler, foldBuildFlags, generateComponentTypesFile, generateManifest, getScopeId, hasStencilCssComponentsImport, hasStencilGlobalsImport, hasStencilHydrateImport, loadConfig, nodeRequire, optimizeCss, optimizeJs, parseCssOnlyComponents, replaceStencilCssComponentsImport, replaceStencilGlobalsImport, replaceStencilHydrateImport, scopeCss, transpile, transpileSync, ts, validateConfig, validateHydrated, vermoji, version, versions };

package/dist/compiler/utils/index.d.mts

@@ -1,4 +1,4 @@
-import { $i as CUSTOM, $r as filterActiveTargets, Ai as buildWarn, Ar as ModeValidationError, Bi as loadTypeScriptDiagnostics, Br as isJsFile, Ca as TYPES, Ci as isOutputTargetWww, Da as XLINK_NS, Di as TASK_CANCELED_MSG, Ea as WWW, Ei as shouldExcludeComponent, Fi as escapeHtml, Fr as createJsVarName, Gi as formatLazyBundleRuntimeMeta, Gr as readOnlyArrayHasStringMember, Hi as isRolldownError, Hr as isTsFile, Ii as normalizeDiagnostics, Ir as generatePreamble, Ji as CMP_FLAGS, Jr as getSourceMappingUrlForEndOfFile, Ki as stringifyRuntimeData, Kr as readPackageJson, Li as splitLineBreaks, Lr as getTextDocs, Mi as hasError, Mr as validateComponentTag, Ni as hasWarning, Nr as ParsePackageJsonResult, Oi as buildError, Pi as shouldIgnoreError, Pr as addDocBlock, Qi as COPY, Qr as FilterComponentsResult, Ri as augmentDiagnosticWithNode, Rr as hasDependency, Sa as SVG_NS, Si as isOutputTargetTypes, Ta as WATCH_FLAGS, Ti as relativeImport, Ui as loadRolldownDiagnostics, Ur as isTsxFile, Vi as createOnWarnFn, Vr as isJsxFile, Wi as formatComponentRuntimeMeta, Wr as parsePackageJson, Xi as COLLECTION_APP_DATA_FILE_NAME, Xr as rolldownToStencilSourceMap, Yi as COLLECTION, Yr as getSourceMappingUrlLinker, Zi as COLLECTION_MANIFEST_FILE_NAME, Zr as result_d_exports, _a as SSR, _i as isOutputTargetLoaderBundle, aa as DOCS_JSON, ai as isOutputTargetCollection, ba as STATS, bi as isOutputTargetStandalone, ca as EVENT_FLAGS, ci as isOutputTargetDistLazy, da as HOST_FLAGS, di as isOutputTargetDocsCustom, ea as DEFAULT_STYLE_MODE, ei as filterExcludedComponents, fa as HTML_NS, fi as isOutputTargetDocsCustomElementsManifest, ga as NODE_TYPES, gi as isOutputTargetGlobalStyle, ha as MEMBER_FLAGS, hi as isOutputTargetDocsVscode, ia as DOCS_CUSTOM_ELEMENTS_MANIFEST, ii as isOutputTargetAssets, ji as catchError, jr as validateComponentModes, ki as buildJsonFileError, la as GENERATED_DTS, li as isOutputTargetDocs, ma as LOADER_BUNDLE, mi as isOutputTargetDocsReadme, na as DOCS_AGENT_SKILL, ni as getComponentsDtsTypesFilePath, oa as DOCS_README, oi as isOutputTargetCopy, pa as LISTENER_FLAGS, pi as isOutputTargetDocsJson, qi as ASSETS, qr as getInlineSourceMappingUrlLinker, ra as DOCS_CUSTOM, ri as getComponentsFromModules, sa as DOCS_VSCODE, si as isOutputTargetCustom, ta as DIST_LAZY, ti as getComponentsDtsSrcFilePath, ua as GLOBAL_STYLE, ui as isOutputTargetDocsAgentSkill, va as SSR_WASM, vi as isOutputTargetSsr, wa as VALID_CONFIG_OUTPUT_TARGETS, wi as isValidConfigOutputTarget, xa as STYLE_EXT, xi as isOutputTargetStats, ya as STANDALONE, yi as isOutputTargetSsrWasm, zi as loadTypeScriptDiagnostic, zr as isDtsFile } from "../../index-B9-Byy8z.mjs";
+import { $i as CUSTOM, $r as filterActiveTargets, Ai as buildWarn, Ar as ModeValidationError, Bi as loadTypeScriptDiagnostics, Br as isJsFile, Ca as TYPES, Ci as isOutputTargetWww, Da as XLINK_NS, Di as TASK_CANCELED_MSG, Ea as WWW, Ei as shouldExcludeComponent, Fi as escapeHtml, Fr as createJsVarName, Gi as formatLazyBundleRuntimeMeta, Gr as readOnlyArrayHasStringMember, Hi as isRolldownError, Hr as isTsFile, Ii as normalizeDiagnostics, Ir as generatePreamble, Ji as CMP_FLAGS, Jr as getSourceMappingUrlForEndOfFile, Ki as stringifyRuntimeData, Kr as readPackageJson, Li as splitLineBreaks, Lr as getTextDocs, Mi as hasError, Mr as validateComponentTag, Ni as hasWarning, Nr as ParsePackageJsonResult, Oi as buildError, Pi as shouldIgnoreError, Pr as addDocBlock, Qi as COPY, Qr as FilterComponentsResult, Ri as augmentDiagnosticWithNode, Rr as hasDependency, Sa as SVG_NS, Si as isOutputTargetTypes, Ta as WATCH_FLAGS, Ti as relativeImport, Ui as loadRolldownDiagnostics, Ur as isTsxFile, Vi as createOnWarnFn, Vr as isJsxFile, Wi as formatComponentRuntimeMeta, Wr as parsePackageJson, Xi as COLLECTION_APP_DATA_FILE_NAME, Xr as rolldownToStencilSourceMap, Yi as COLLECTION, Yr as getSourceMappingUrlLinker, Zi as COLLECTION_MANIFEST_FILE_NAME, Zr as result_d_exports, _a as SSR, _i as isOutputTargetLoaderBundle, aa as DOCS_JSON, ai as isOutputTargetCollection, ba as STATS, bi as isOutputTargetStandalone, ca as EVENT_FLAGS, ci as isOutputTargetDistLazy, da as HOST_FLAGS, di as isOutputTargetDocsCustom, ea as DEFAULT_STYLE_MODE, ei as filterExcludedComponents, fa as HTML_NS, fi as isOutputTargetDocsCustomElementsManifest, ga as NODE_TYPES, gi as isOutputTargetGlobalStyle, ha as MEMBER_FLAGS, hi as isOutputTargetDocsVscode, ia as DOCS_CUSTOM_ELEMENTS_MANIFEST, ii as isOutputTargetAssets, ji as catchError, jr as validateComponentModes, ki as buildJsonFileError, la as GENERATED_DTS, li as isOutputTargetDocs, ma as LOADER_BUNDLE, mi as isOutputTargetDocsReadme, na as DOCS_AGENT_SKILL, ni as getComponentsDtsTypesFilePath, oa as DOCS_README, oi as isOutputTargetCopy, pa as LISTENER_FLAGS, pi as isOutputTargetDocsJson, qi as ASSETS, qr as getInlineSourceMappingUrlLinker, ra as DOCS_CUSTOM, ri as getComponentsFromModules, sa as DOCS_VSCODE, si as isOutputTargetCustom, ta as DIST_LAZY, ti as getComponentsDtsSrcFilePath, ua as GLOBAL_STYLE, ui as isOutputTargetDocsAgentSkill, va as SSR_WASM, vi as isOutputTargetSsr, wa as VALID_CONFIG_OUTPUT_TARGETS, wi as isValidConfigOutputTarget, xa as STYLE_EXT, xi as isOutputTargetStats, ya as STANDALONE, yi as isOutputTargetSsrWasm, zi as loadTypeScriptDiagnostic, zr as isDtsFile } from "../../index-ZTa5XM0M.mjs";
 //#region src/utils/byte-size.d.ts
 /**
  * Used to learn the size of a string in bytes.

package/dist/{compiler-CUsOl_Kw.mjs → compiler-CShHxskG.mjs}

@@ -461,9 +461,9 @@ const scopeCss = (cssText, scopeId, commentOriginalSelector) => {
 };
 //#endregion
 //#region src/version.ts
-const version = "5.0.0-beta.20";
-const buildId = "1791812865";
-const vermoji = "🚕";
+const version = "5.0.0-beta.22";
+const buildId = "1791847427";
+const vermoji = "🎁";
 /**
 * Get the installed version of a tool/dependency.
 * Handles packages with exports maps that point to subdirectories.
@@ -5179,6 +5179,86 @@ const getScopeId = (tagName, mode) => {
 	return "sc-" + tagName + (mode && mode !== "$" ? "-" + mode : "");
 };
 //#endregion
+//#region src/compiler/style/transform-stylesheet.ts
+/**
+* Run a stylesheet through the plugin (e.g. Sass) and CSS-to-ESM transforms, memoized in
+* `compilerCtx.cssTransformCache` so every consumer of the same stylesheet shares one computation.
+*
+* @param config a user-supplied configuration
+* @param compilerCtx the current compiler context
+* @param buildCtx the current build context
+* @param id the stylesheet's path, annotated with its import data as query params - the cache key
+* @param data the import data serialized into `id`
+* @returns the cache entry, or `null` if the stylesheet could not be read
+*/
+const transformStylesheet = async (config, compilerCtx, buildCtx, id, data) => {
+	if (compilerCtx.cssTransformCache.has(id)) return compilerCtx.cssTransformCache.get(id) ?? null;
+	if (!compilerCtx.worker) return null;
+	const filePath = normalizeFsPath(id);
+	const code = await compilerCtx.fs.readFile(filePath);
+	if (typeof code !== "string") {
+		compilerCtx.cssTransformCache.set(id, null);
+		return null;
+	}
+	const pluginTransforms = await runPluginTransformsEsmImports(config, compilerCtx, buildCtx, code, filePath);
+	const cssInput = data.tag ? pluginTransforms.code : inlineRelativeCssUrlAssets(pluginTransforms.code, filePath);
+	const cssTransformOutput = await compilerCtx.worker.transformCssToEsm({
+		file: pluginTransforms.id,
+		input: cssInput,
+		tag: data.tag,
+		tags: buildCtx.components.map((c) => c.tagName),
+		addTagTransformers: !!buildCtx.config.compat.additionalTagTransformers,
+		encapsulation: data.encapsulation,
+		mode: data.mode,
+		sourceMap: config.sourceMap,
+		minify: config.minifyCss,
+		autoprefixer: config.autoprefixCss,
+		docs: config.outputTargets.some(isOutputTargetDocs)
+	});
+	const entry = {
+		pluginTransformId: pluginTransforms.id,
+		pluginTransformCode: pluginTransforms.code,
+		pluginTransformDependencies: pluginTransforms.dependencies,
+		pluginTransformDiagnostics: pluginTransforms.diagnostics,
+		cssTransformOutput
+	};
+	compilerCtx.cssTransformCache.set(id, entry);
+	return entry;
+};
+/**
+* 3rd-party stylesheets with relative `url(./font.ttf)` (font-face `src`, a background-image, ...)
+* have nowhere to resolve that path once this CSS is self-injected as a CSSStyleSheet:
+* there's no bundler output location for it to be relative *to*.
+* Inlining the referenced file as a `data:` URI sidesteps needing one - no separate asset
+* to serve, works the same regardless of how/where the final bundle is deployed.
+*/
+const CSS_URL_RE = /url\(\s*(['"]?)([^'"()]+)\1\s*\)/g;
+const CSS_URL_ASSET_MIME_TYPES = {
+	ttf: "font/ttf",
+	otf: "font/otf",
+	woff: "font/woff",
+	woff2: "font/woff2",
+	eot: "application/vnd.ms-fontobject",
+	png: "image/png",
+	jpg: "image/jpeg",
+	jpeg: "image/jpeg",
+	gif: "image/gif",
+	svg: "image/svg+xml"
+};
+const inlineRelativeCssUrlAssets = (cssText, cssFilePath) => cssText.replace(CSS_URL_RE, (original, _quote, url) => {
+	if (/^(data:|[a-z][a-z0-9+.-]*:|\/\/|\/)/i.test(url)) return original;
+	const cleanUrl = url.split(/[?#]/)[0];
+	const ext = cleanUrl.split(".").pop()?.toLowerCase();
+	const mimeType = ext && CSS_URL_ASSET_MIME_TYPES[ext];
+	if (!mimeType) return original;
+	try {
+		const assetPath = resolve(dirname(cssFilePath), cleanUrl);
+		return `url("data:${mimeType};base64,${readFileSync(assetPath).toString("base64")}")`;
+	} catch {
+		return original;
+	}
+});
+//#endregion
 //#region src/compiler/transformers/stencil-import-path.ts
 /**
 * Serialize data about a style import to an annotated path, where
@@ -5298,35 +5378,7 @@ const extTransformsPlugin = (config, compilerCtx, buildCtx) => {
 			if (data != null) {
 				const filePath = normalizeFsPath(id);
 				const wasCached = compilerCtx.cssTransformCache.has(id);
-				if (!wasCached) {
-					const code = await compilerCtx.fs.readFile(filePath);
-					if (typeof code !== "string") compilerCtx.cssTransformCache.set(id, null);
-					else {
-						const pluginTransforms = await runPluginTransformsEsmImports(config, compilerCtx, buildCtx, code, filePath);
-						const cssInput = data.tag ? pluginTransforms.code : inlineRelativeCssUrlAssets(pluginTransforms.code, filePath);
-						const cssTransformResults = await compilerCtx.worker.transformCssToEsm({
-							file: pluginTransforms.id,
-							input: cssInput,
-							tag: data.tag,
-							tags: buildCtx.components.map((c) => c.tagName),
-							addTagTransformers: !!buildCtx.config.compat.additionalTagTransformers,
-							encapsulation: data.encapsulation,
-							mode: data.mode,
-							sourceMap: config.sourceMap,
-							minify: config.minifyCss,
-							autoprefixer: config.autoprefixCss,
-							docs: config.outputTargets.some(isOutputTargetDocs)
-						});
-						compilerCtx.cssTransformCache.set(id, {
-							pluginTransformId: pluginTransforms.id,
-							pluginTransformCode: pluginTransforms.code,
-							pluginTransformDependencies: pluginTransforms.dependencies,
-							pluginTransformDiagnostics: pluginTransforms.diagnostics,
-							cssTransformOutput: cssTransformResults
-						});
-					}
-				}
-				const cacheEntry = compilerCtx.cssTransformCache.get(id);
+				const cacheEntry = await transformStylesheet(config, compilerCtx, buildCtx, id, data);
 				if (wasCached) cacheHits++;
 				if (cacheEntry == null) return null;
 				/**
@@ -5401,39 +5453,6 @@ const extTransformsPlugin = (config, compilerCtx, buildCtx) => {
 		}
 	};
 };
-/**
-* 3rd-party stylesheets with relative `url(./font.ttf)` (font-face `src`, a background-image, ...)
-* have nowhere to resolve that path once this CSS is self-injected as a CSSStyleSheet:
-* there's no bundler output location for it to be relative *to*.
-* Inlining the referenced file as a `data:` URI sidesteps needing one - no separate asset
-* to serve, works the same regardless of how/where the final bundle is deployed.
-*/
-const CSS_URL_RE = /url\(\s*(['"]?)([^'"()]+)\1\s*\)/g;
-const CSS_URL_ASSET_MIME_TYPES = {
-	ttf: "font/ttf",
-	otf: "font/otf",
-	woff: "font/woff",
-	woff2: "font/woff2",
-	eot: "application/vnd.ms-fontobject",
-	png: "image/png",
-	jpg: "image/jpeg",
-	jpeg: "image/jpeg",
-	gif: "image/gif",
-	svg: "image/svg+xml"
-};
-const inlineRelativeCssUrlAssets = (cssText, cssFilePath) => cssText.replace(CSS_URL_RE, (original, _quote, url) => {
-	if (/^(data:|[a-z][a-z0-9+.-]*:|\/\/|\/)/i.test(url)) return original;
-	const cleanUrl = url.split(/[?#]/)[0];
-	const ext = cleanUrl.split(".").pop()?.toLowerCase();
-	const mimeType = ext && CSS_URL_ASSET_MIME_TYPES[ext];
-	if (!mimeType) return original;
-	try {
-		const assetPath = resolve(dirname(cssFilePath), cleanUrl);
-		return `url("data:${mimeType};base64,${readFileSync(assetPath).toString("base64")}")`;
-	} catch {
-		return original;
-	}
-});
 //#endregion
 //#region src/compiler/bundle/file-load-plugin.ts
 const RESOLVE_EXTENSIONS = [
@@ -9955,6 +9974,46 @@ const componentToDeclaration = (component) => {
 	};
 };
 //#endregion
+//#region src/compiler/docs/collect-style-docs.ts
+/**
+* Populate `styleDocs` for every component from its external stylesheets. Stylesheets a bundler
+* has already transformed are read from `compilerCtx.cssTransformCache`; the rest are transformed
+* here, so style docs don't depend on a bundling output target having run.
+*
+* @param config the configuration associated with the current Stencil task run
+* @param compilerCtx the current compiler context
+* @param buildCtx the build context for the current Stencil task run
+*/
+const collectStyleDocs = async (config, compilerCtx, buildCtx) => {
+	const cached = /* @__PURE__ */ new Map();
+	for (const [id, entry] of compilerCtx.cssTransformCache) {
+		const { data } = parseImportPath(id);
+		if (entry && data?.tag) cached.set(cacheKey(id, data.tag, data.mode), entry);
+	}
+	const collect = async (cmp, mode, externalStyle) => {
+		let entry = cached.get(cacheKey(externalStyle.absolutePath, cmp.tagName, mode)) ?? cached.get(cacheKey(externalStyle.originalComponentPath, cmp.tagName, mode));
+		if (!entry) {
+			const data = {
+				tag: cmp.tagName,
+				mode,
+				encapsulation: cmp.encapsulation
+			};
+			const id = `${externalStyle.absolutePath}?${new URLSearchParams(data)}`;
+			const transformed = await transformStylesheet(config, compilerCtx, buildCtx, id, data);
+			if (!transformed) return;
+			entry = transformed;
+			const diagnostics = [...entry.pluginTransformDiagnostics, ...entry.cssTransformOutput.diagnostics];
+			buildCtx.diagnostics.push(...diagnostics);
+			if (hasError(diagnostics)) compilerCtx.cssTransformCache.delete(id);
+			for (const dep of entry.pluginTransformDependencies) compilerCtx.addWatchFile(dep);
+		}
+		cmp.styleDocs ||= [];
+		mergeIntoWith(cmp.styleDocs, entry.cssTransformOutput.styleDocs, (docs) => `${docs.name},${docs.mode}`);
+	};
+	await Promise.all(buildCtx.components.filter((cmp) => !cmp.internal && !cmp.isCollectionDependency).flatMap((cmp) => (cmp.styles ?? []).flatMap((style) => (style.externalStyles ?? []).map((externalStyle) => collect(cmp, style.modeName, externalStyle)))));
+};
+const cacheKey = (path, tag, mode) => `${normalizeFsPath(path)}\n${tag}\n${mode}`;
+//#endregion
 //#region src/compiler/docs/custom/index.ts
 const generateCustomDocs = async (config, docsData, outputTargets) => {
 	const customOutputTargets = outputTargets.filter(isOutputTargetDocsCustom);
@@ -10247,48 +10306,6 @@ const getDefaultReadme = (docsData) => {
 		""
 	].join("\n");
 };
-/**
-* Extract the existing CSS Custom Properties section from a README file.
-* This is used to preserve CSS props documentation when running `stencil docs`
-* without building styles.
-*
-* @param compilerCtx the current compiler context
-* @param readmePath the path to the README file to read
-* @returns array of CSS custom properties styles, or undefined if none found
-*/
-const extractExistingCssProps = async (compilerCtx, readmePath) => {
-	try {
-		const cssPropsSectionMatch = (await compilerCtx.fs.readFile(readmePath)).match(/## CSS Custom Properties\s*\n\s*\n([\s\S]*?)(?=\n##|\n-{4,}|$)/);
-		if (!cssPropsSectionMatch) return;
-		const cssPropsSection = cssPropsSectionMatch[1];
-		const styles = [];
-		const lines = cssPropsSection.split("\n");
-		let inTable = false;
-		for (const line of lines) {
-			const trimmedLine = line.trim();
-			if (trimmedLine.startsWith("| Name") || trimmedLine.startsWith("| ---")) {
-				inTable = true;
-				continue;
-			}
-			if (inTable && trimmedLine.startsWith("|")) {
-				const parts = trimmedLine.split("|").map((p) => p.trim()).filter((p) => p);
-				if (parts.length >= 2) {
-					const name = parts[0].replace(/`/g, "").trim();
-					const docs = parts[1].trim();
-					if (name.startsWith("--")) styles.push({
-						name,
-						docs,
-						annotation: "prop",
-						mode: void 0
-					});
-				}
-			}
-		}
-		return styles.length > 0 ? styles : void 0;
-	} catch {
-		return;
-	}
-};
 //#endregion
 //#region src/compiler/docs/readme/index.ts
 const generateReadmeDocs = async (config, compilerCtx, docsData, outputTargets) => {
@@ -10405,15 +10422,8 @@ const outputDocs = async (config, compilerCtx, buildCtx) => {
 	const docsOutputTargets = filterActiveTargets(config.outputTargets.filter((o) => isOutputTargetDocsReadme(o) || isOutputTargetDocsJson(o) || isOutputTargetDocsCustom(o) || isOutputTargetDocsVscode(o) || isOutputTargetDocsCustomElementsManifest(o) || isOutputTargetDocsAgentSkill(o)), config.devMode);
 	if (docsOutputTargets.length === 0) return;
 	await buildCtx.stylesPromise;
+	await collectStyleDocs(config, compilerCtx, buildCtx);
 	const docsData = await generateDocData(config, compilerCtx, buildCtx);
-	if (config.outputTargets.every((target) => target.type === "docs-readme" || target.type === "docs-json" || target.type === "docs-custom" || target.type === "docs-vscode" || target.type === "docs-custom-elements-manifest" || target.type === "docs-agent-skill")) await Promise.all(docsData.components.map(async (component) => {
-		if (component.styles.length === 0) {
-			const readmeDir = docsOutputTargets.find(isOutputTargetDocsReadme)?.dir || config.srcDir;
-			const readmePath = normalizePath(readmeDir) === normalizePath(config.srcDir) ? component.readmePath : join$2(readmeDir, component.readmePath.replace(config.srcDir, ""));
-			const existingCssProps = await extractExistingCssProps(compilerCtx, readmePath);
-			if (existingCssProps) component.styles = existingCssProps;
-		}
-	}));
 	await Promise.all([
 		generateReadmeDocs(config, compilerCtx, docsData, docsOutputTargets),
 		generateJsonDocs(config, compilerCtx, docsData, docsOutputTargets),
@@ -12778,11 +12788,9 @@ const generateSsrFactory = async (config, compilerCtx, buildCtx) => {
 				format: "cjs",
 				esModule: false,
 				strict: false,
-				intro: SSR_FACTORY_INTRO,
-				outro: SSR_FACTORY_OUTRO,
 				codeSplitting: false
 			});
-			if (!buildCtx.hasError && rolldownOutput != null && Array.isArray(rolldownOutput.output)) return rolldownOutput.output[0].code;
+			if (!buildCtx.hasError && rolldownOutput != null && Array.isArray(rolldownOutput.output)) return SSR_FACTORY_INTRO + rolldownOutput.output[0].code + SSR_FACTORY_OUTRO;
 		}
 	} catch (e) {
 		catchError(buildCtx.diagnostics, e);
@@ -18174,13 +18182,13 @@ const parseStaticComponentMeta = (compilerCtx, typeChecker, cmpNode, moduleFile,
 		hasPatchClone: false,
 		hasPatchInsert: false
 	};
-	const visitComponentChildNode = (node, ctx) => {
-		validateComponentMembers(node, ctx);
+	if (!isCollectionDependency) validateComponentMembers(cmpNode, buildCtx);
+	const visitComponentChildNode = (node) => {
 		if (ts.isCallExpression(node)) parseCallExpression(cmp, node, typeChecker);
 		else if (ts.isStringLiteral(node)) parseStringLiteral(cmp, node);
-		node.forEachChild((child) => visitComponentChildNode(child, ctx));
+		node.forEachChild(visitComponentChildNode);
 	};
-	visitComponentChildNode(cmpNode, buildCtx);
+	visitComponentChildNode(cmpNode);
 	parseClassMethods(classMethods, cmp);
 	cmp.hasModernPropertyDecls = detectModernPropDeclarations(cmpNode) || doesExtend;
 	cmp.htmlAttrNames = unique(cmp.htmlAttrNames);
@@ -18198,31 +18206,32 @@ const parseStaticComponentMeta = (compilerCtx, typeChecker, cmpNode, moduleFile,
 	return cmpNode;
 };
 /**
-* Check whether a class declaration is a Stencil component, i.e. it's
-* decorated with `@Component({ tag: ... })`.
-* @param classNode the class declaration to check
-* @returns whether `classNode` is a Stencil component class
+* Warn about members a Stencil component class should not define.
+* @param cmpNode the component class declaration
+* @param buildCtx the current build context, used to surface diagnostics
 */
-const isStencilComponentClass = (classNode) => {
-	const decorator = ts.getDecorators(classNode)?.[0];
-	return decorator != null && ts.isCallExpression(decorator.expression) && decorator.expression.arguments.length === 1 && ts.isObjectLiteralExpression(decorator.expression.arguments[0]) && decorator.expression.arguments[0].properties.some((prop) => ts.isPropertyAssignment(prop) && prop.name.getText() === "tag");
-};
-const validateComponentMembers = (node, buildCtx) => {
-	/**
-	* validate if:
-	*/
-	if (ts.isGetAccessorDeclaration(node) && ts.isIdentifier(node.name) && typeof node.name.escapedText === "string" && BLACKLISTED_COMPONENT_METHODS.includes(node.name.escapedText) && node.parent && ts.isClassDeclaration(node.parent) && isStencilComponentClass(node.parent)) {
-		const propName = node.name.escapedText;
-		const componentName = node.parent.name.getText();
-		const err = buildWarn(buildCtx.diagnostics);
-		err.messageText = `The component "${componentName}" has a getter called "${propName}". This getter is reserved for use by Stencil components and should not be defined by the user.`;
-		augmentDiagnosticWithNode(err, node);
-	}
-	if (ts.isMethodDeclaration(node) && ts.isIdentifier(node.name) && node.name.escapedText === "componentShouldUpdate" && node.parameters.length > 1 && node.parent && ts.isClassDeclaration(node.parent) && isStencilComponentClass(node.parent)) {
-		const componentName = node.parent.name.getText();
-		const err = buildWarn(buildCtx.diagnostics);
-		err.messageText = `The component "${componentName}" defines "componentShouldUpdate" with ${node.parameters.length} parameters. As of Stencil v5, "componentShouldUpdate" is called once per render with a single "changes" argument (a map of prop/state names to "{ newVal, oldVal }") instead of once per prop with "(newVal, oldVal, propName)". This method will still compile, but any extra parameters will be "undefined" at runtime.`;
-		augmentDiagnosticWithNode(err, node);
+const validateComponentMembers = (cmpNode, buildCtx) => {
+	const componentName = cmpNode.name?.text ?? "";
+	for (const member of cmpNode.members) {
+		if (!member.name || !ts.isIdentifier(member.name)) continue;
+		const memberName = member.name.text;
+		/**
+		* the component has a getter called "shadowRoot"
+		*/
+		if (ts.isGetAccessorDeclaration(member) && BLACKLISTED_COMPONENT_METHODS.includes(memberName)) {
+			const err = buildWarn(buildCtx.diagnostics);
+			err.messageText = `The component "${componentName}" has a getter called "${memberName}". This getter is reserved for use by Stencil components and should not be defined by the user.`;
+			augmentDiagnosticWithNode(err, ts.getOriginalNode(member));
+		}
+		/**
+		* the component defines a "componentShouldUpdate" method with more than one parameter,
+		* which was the pre-v5 per-prop signature "(newVal, oldVal, propName)"
+		*/
+		if (ts.isMethodDeclaration(member) && memberName === "componentShouldUpdate" && member.parameters.length > 1) {
+			const err = buildWarn(buildCtx.diagnostics);
+			err.messageText = `The component "${componentName}" defines "componentShouldUpdate" with ${member.parameters.length} parameters. As of Stencil v5, "componentShouldUpdate" is called once per render with a single "changes" argument (a map of prop/state names to "{ newVal, oldVal }") instead of once per prop with "(newVal, oldVal, propName)". This method will still compile, but any extra parameters will be "undefined" at runtime.`;
+			augmentDiagnosticWithNode(err, ts.getOriginalNode(member));
+		}
 	}
 };
 const parseVirtualProps = (docs) => {
@@ -21262,7 +21271,7 @@ const validateReadmeOutputTarget = (config, outputTarget) => {
 	if (!isAbsolute$1(outputTarget.dir)) outputTarget.dir = join$2(config.rootDir, outputTarget.dir);
 	if (outputTarget.footer == null) outputTarget.footer = NOTE;
 	outputTarget.strict = !!outputTarget.strict;
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const validateJsonDocsOutputTarget = (config, diagnostics, outputTarget) => {
@@ -21274,7 +21283,7 @@ const validateJsonDocsOutputTarget = (config, diagnostics, outputTarget) => {
 	if (isString$1(outputTarget.typesFile) && !isAbsolute$1(outputTarget.typesFile)) outputTarget.typesFile = join$2(config.rootDir, outputTarget.typesFile);
 	else if (outputTarget.typesFile !== null && outputTarget.file.endsWith(".json")) outputTarget.typesFile = outputTarget.file.replace(/\.json$/, ".d.ts");
 	outputTarget.strict = !!outputTarget.strict;
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const validateCustomDocsOutputTarget = (config, diagnostics, outputTarget) => {
@@ -21283,7 +21292,7 @@ const validateCustomDocsOutputTarget = (config, diagnostics, outputTarget) => {
 		err.messageText = `docs-custom outputTarget missing the "generator" function`;
 	}
 	outputTarget.strict = !!outputTarget.strict;
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const validateVScodeDocsOutputTarget = (config, diagnostics, outputTarget) => {
@@ -21291,21 +21300,21 @@ const validateVScodeDocsOutputTarget = (config, diagnostics, outputTarget) => {
 		const err = buildError(diagnostics);
 		err.messageText = `docs-vscode outputTarget missing the "file" path`;
 	}
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const DEFAULT_AGENT_SKILL_DIR = "dist/skill";
 const validateAgentSkillOutputTarget = (config, outputTarget) => {
 	outputTarget.dir = getAbsolutePath(config, outputTarget.dir || DEFAULT_AGENT_SKILL_DIR);
 	outputTarget.name = toSkillName(outputTarget.name || config.fsNamespace);
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 const validateCustomElementsManifestOutputTarget = (config, outputTarget) => {
 	if (!isString$1(outputTarget.file)) outputTarget.file = "custom-elements.json";
 	if (!isAbsolute$1(outputTarget.file)) outputTarget.file = join$2(config.rootDir, outputTarget.file);
 	outputTarget.strict = !!outputTarget.strict;
-	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = !config._docsFlag;
+	if (!isBoolean$1(outputTarget.skipInDev)) outputTarget.skipInDev = true;
 	return outputTarget;
 };
 //#endregion
@@ -26326,14 +26335,14 @@ const getTranspileCssConfig = (compileOpts, importData, results) => {
 };
 const getTranspileConfigOpt = (value, validValues, defaultValue) => {
 	if (value === null || value === "null") return null;
-	value = isString$1(value) ? value.toLowerCase().trim() : null;
+	value = isString$1(value) ? value.toLowerCase().trim() : void 0;
 	if (validValues.has(value)) return value;
 	return defaultValue;
 };
 const VALID_EXPORT = /* @__PURE__ */ new Set(["customelement", "module"]);
-const VALID_METADATA = /* @__PURE__ */ new Set(["compilerstatic", null]);
+const VALID_METADATA = /* @__PURE__ */ new Set(["compilerstatic"]);
 const VALID_MODULE = /* @__PURE__ */ new Set(["cjs", "esm"]);
-const VALID_PROXY = /* @__PURE__ */ new Set(["defineproperty", null]);
+const VALID_PROXY = /* @__PURE__ */ new Set(["defineproperty"]);
 const VALID_STYLE = /* @__PURE__ */ new Set(["static"]);
 const VALID_STYLE_IMPORT_DATA = /* @__PURE__ */ new Set(["queryparams"]);
 const VALID_TARGET = /* @__PURE__ */ new Set([

package/dist/declarations/stencil-public-compiler.d.ts

@@ -2101,11 +2101,6 @@ interface Config extends StencilConfig {
   tsWatchOptions?: any;
   _isValidated?: boolean;
   _isTesting?: boolean;
-  /**
-   * Internal flag set when --docs CLI flag is used.
-   * Forces docs output targets to build even in dev mode.
-   */
-  _docsFlag?: boolean;
   /**
    * Whether running in a CI environment (disables interactive features, adjusts worker count)
    */

package/dist/{index-Dz1G9pWZ.d.mts → index-Clnf0Xcw.d.mts}

@@ -1,4 +1,4 @@
-import { ar as RafCallback, cr as TagTransformer, lr as UserBuildConditionals, n as ChildType, nr as ErrorHandler, p as HostElement, rr as FunctionalComponent, sr as ResolutionHandler, ur as VNode, v as PropsType, y as RuntimeRef } from "./index-B9-Byy8z.mjs";
+import { ar as RafCallback, cr as TagTransformer, lr as UserBuildConditionals, n as ChildType, nr as ErrorHandler, p as HostElement, rr as FunctionalComponent, sr as ResolutionHandler, ur as VNode, v as PropsType, y as RuntimeRef } from "./index-ZTa5XM0M.mjs";
 //#region src/client/client-build.d.ts
 declare const Build: UserBuildConditionals;
 //#endregion

package/dist/{index-B9-Byy8z.d.mts → index-ZTa5XM0M.d.mts}

@@ -2141,11 +2141,6 @@ interface Config extends StencilConfig {
   tsWatchOptions?: any;
   _isValidated?: boolean;
   _isTesting?: boolean;
-  /**
-   * Internal flag set when --docs CLI flag is used.
-   * Forces docs output targets to build even in dev mode.
-   */
-  _docsFlag?: boolean;
   /**
    * Whether running in a CI environment (disables interactive features, adjusts worker count)
    */

package/dist/signals/index.js

@@ -103,35 +103,6 @@ const BUILD = {
 	asyncQueue: false
 };
 BUILD.isDev, BUILD.isTesting;
-const MEMBER_FLAGS = {
-	String: 1,
-	Number: 2,
-	Boolean: 4,
-	Any: 8,
-	Unknown: 16,
-	State: 32,
-	Method: 64,
-	Event: 128,
-	Element: 256,
-	ReflectAttr: 512,
-	Mutable: 1024,
-	Getter: 2048,
-	Setter: 4096,
-	Prop: 31,
-	HasAttribute: 31,
-	PropLike: 63
-};
-//#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();
-};
 //#endregion
 //#region src/client/client-log.ts
 const STENCIL_DEV_MODE = BUILD.isTesting ? ["STENCIL:"] : ["%cstencil", "color: white;background:#4c47ff;font-weight: bold; font-size:10px; padding:2px 6px; border-radius: 5px"];
@@ -173,13 +144,12 @@ BUILD.lazyLoad || globalThis.HTMLElement;
 * @returns the `ReadonlySignal` for the prop, or `null` if not found / not signal-backed
 */
 const getSignal = (elm, prop) => {
-	const hostRef = getHostRef(elm);
-	if (!hostRef?.$signalValues$) {
+	const signals = elm[STENCIL_SIGNALS_SYMBOL];
+	if (!signals) {
 		if (BUILD.isDev) consoleDevWarn(`getSignal('${prop}'): element <${elm.tagName.toLowerCase()}> is not signal-backed. Ensure signalBacking is true in stencil.config.ts.`);
 		return null;
 	}
-	if (!((hostRef.$cmpMeta$?.$members$?.[prop]?.[0] ?? 0) & MEMBER_FLAGS.Prop)) return null;
-	return hostRef.$signalValues$.get(prop) ?? null;
+	return signals.get(prop) ?? null;
 };
 /**
 * Marks a class method as a reactive effect. Wraps the method in `effect()` after

package/dist/sys/node/index.d.mts

@@ -1,4 +1,4 @@
-import { Bt as Logger, nt as CompilerSystem } from "../../index-B9-Byy8z.mjs";
+import { Bt as Logger, nt as CompilerSystem } from "../../index-ZTa5XM0M.mjs";
 //#region src/sys/node/logger/index.d.ts
 /**
  * Create a logger to run in a Node environment

package/dist/sys/node/worker.mjs

@@ -1,4 +1,4 @@
-import { l as createWorkerMessageHandler } from "../../compiler-CUsOl_Kw.mjs";
+import { l as createWorkerMessageHandler } from "../../compiler-CShHxskG.mjs";
 import { t as createNodeSys } from "../../node-Bz2SOK7_.mjs";
 //#region src/sys/node/node-worker-thread.ts
 /**

package/dist/testing/index.d.mts

@@ -1276,11 +1276,6 @@ interface Config extends StencilConfig {
   tsWatchOptions?: any;
   _isValidated?: boolean;
   _isTesting?: boolean;
-  /**
-   * Internal flag set when --docs CLI flag is used.
-   * Forces docs output targets to build even in dev mode.
-   */
-  _docsFlag?: boolean;
   /**
    * Whether running in a CI environment (disables interactive features, adjusts worker count)
    */

package/dist/testing/index.mjs

@@ -33,7 +33,7 @@ import "@rollup/pluginutils";
 import { createHash } from "crypto";
 import { afterAll, vi } from "vitest";
 //#region src/version.ts
-const version = "5.0.0-beta.20";
+const version = "5.0.0-beta.22";
 const MEMBER_FLAGS = {
 	String: 1,
 	Number: 2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core",
-  "version": "5.0.0-beta.20",
+  "version": "5.0.0-beta.22",
   "description": "A Compiler for Web Components and Progressive Web Apps",
   "keywords": [
     "components",
@@ -126,9 +126,9 @@
     "terser": "^5.50.0",
     "tinyglobby": "^0.2.17",
     "typescript": ">5.0.0 <7.0.0",
-    "@stencil/cli": "5.0.0-beta.20",
-    "@stencil/mock-doc": "5.0.0-beta.20",
-    "@stencil/dev-server": "5.0.0-beta.20"
+    "@stencil/cli": "5.0.0-beta.22",
+    "@stencil/dev-server": "5.0.0-beta.22",
+    "@stencil/mock-doc": "5.0.0-beta.22"
   },
   "devDependencies": {
     "@ionic/prettier-config": "^4.0.0",