Merge remote-tracking branch 'origin/main' into serialize-deserialize

Author: John Jenkins

CHANGELOG.md

@@ -1,3 +1,14 @@
+## 🏰 [4.37.1](https://github.com/stenciljs/core/compare/v4.37.0...v4.37.1) (2025-09-19)
+
+
+### Bug Fixes
+
+* **dist-custom-elements:** revert [#6381](https://github.com/stenciljs/core/issues/6381) ([77cfdb3](https://github.com/stenciljs/core/commit/77cfdb3b704205ced93b7a265ea0881fa2dd19d0))
+* **Mixin:** export `MixinFactory` type for ease of use ([#6390](https://github.com/stenciljs/core/issues/6390)) ([a26114e](https://github.com/stenciljs/core/commit/a26114ee8a3d808ddb4731547842301628654312))
+* **runtime:** stop eager json parsing for unknown and any type bindings ([#6384](https://github.com/stenciljs/core/issues/6384)) ([ccae0d7](https://github.com/stenciljs/core/commit/ccae0d743cd4eb2766eb7e48cb6add854c9fd640))
+
+
+
 # ⛴ [4.37.0](https://github.com/stenciljs/core/compare/v4.36.3...v4.37.0) (2025-09-13)
 
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core",
-  "version": "4.37.0",
+  "version": "4.37.1",
   "license": "MIT",
   "main": "./internal/stencil-core/index.cjs",
   "module": "./internal/stencil-core/index.js",

package.json

@@ -116,6 +116,19 @@ describe('validation', () => {
     });
   });
 
+  describe('suppressReservedPublicNameWarnings', () => {
+    it.each([true, false])('sets suppressReservedPublicNameWarnings to %p when provided', (bool) => {
+      userConfig.suppressReservedPublicNameWarnings = bool;
+      const { config } = validateConfig(userConfig, bootstrapConfig);
+      expect(config.suppressReservedPublicNameWarnings).toBe(bool);
+    });
+
+    it('defaults suppressReservedPublicNameWarnings to false', () => {
+      const { config } = validateConfig(userConfig, bootstrapConfig);
+      expect(config.suppressReservedPublicNameWarnings).toBe(false);
+    });
+  });
+
   describe('enableCache', () => {
     it('set enableCache true', () => {
       userConfig.enableCache = true;

src/compiler/config/test/validate-config.spec.ts

@@ -205,6 +205,7 @@ export const validateConfig = (
   setBooleanConfig(validatedConfig, 'autoprefixCss', null, validatedConfig.buildEs5);
   setBooleanConfig(validatedConfig, 'validateTypes', null, !validatedConfig._isTesting);
   setBooleanConfig(validatedConfig, 'allowInlineScripts', null, true);
+  setBooleanConfig(validatedConfig, 'suppressReservedPublicNameWarnings', null, false);
 
   if (!isString(validatedConfig.taskQueue)) {
     validatedConfig.taskQueue = 'async';

src/compiler/config/validate-config.ts

@@ -136,6 +136,7 @@ const visitClassDeclaration = (
       importAliasMap.get('Prop'),
     );
     propDecoratorsToStatic(
+      config,
       diagnostics,
       decoratedMembers,
       typeChecker,

src/compiler/transformers/decorators-to-static/convert-decorators.ts

@@ -89,7 +89,7 @@ const parseMethodDecorator = (
   }
 
   // Validate if the method name does not conflict with existing public names
-  validatePublicName(diagnostics, methodName, '@Method()', 'method', method.name);
+  validatePublicName(config, diagnostics, methodName, '@Method()', 'method', method.name);
 
   const methodMeta: d.ComponentCompilerStaticMethod = {
     complexType: {

src/compiler/transformers/decorators-to-static/method-decorator.ts

@@ -31,6 +31,7 @@ import { getDecoratorParameters, isDecoratorNamed } from './decorator-utils';
  * @param serializers a collection of serializers (from prop > attribute) used on `@Prop` annotated class members
  */
 export const propDecoratorsToStatic = (
+  config: d.ValidatedConfig,
   diagnostics: d.Diagnostic[],
   decoratedProps: ts.ClassElement[],
   typeChecker: ts.TypeChecker,
@@ -44,6 +45,7 @@ export const propDecoratorsToStatic = (
     .filter((prop) => ts.isPropertyDeclaration(prop) || ts.isGetAccessor(prop))
     .map((prop) =>
       parsePropDecorator(
+        config,
         diagnostics,
         typeChecker,
         program,
@@ -75,6 +77,7 @@ export const propDecoratorsToStatic = (
  * @returns a property assignment expression to be added to the Stencil component's class
  */
 const parsePropDecorator = (
+  config: d.ValidatedConfig,
   diagnostics: d.Diagnostic[],
   typeChecker: ts.TypeChecker,
   program: ts.Program,
@@ -106,7 +109,7 @@ const parsePropDecorator = (
     warn.messageText = `The @Prop() name "${propName}" looks like an event. Please use the "@Event()" decorator to expose events instead, not properties or methods.`;
     augmentDiagnosticWithNode(warn, prop.name);
   } else {
-    validatePublicName(diagnostics, propName, '@Prop()', 'prop', prop.name);
+    validatePublicName(config, diagnostics, propName, '@Prop()', 'prop', prop.name);
   }
 
   const symbol = typeChecker.getSymbolAtLocation(prop.name);

src/compiler/transformers/decorators-to-static/prop-decorator.ts

@@ -14,12 +14,17 @@ import type * as d from '../../declarations';
  * @param node the TypeScript AST node at which the class member is defined
  */
 export const validatePublicName = (
+  config: d.ValidatedConfig,
   diagnostics: d.Diagnostic[],
   memberName: string,
   decorator: string,
   memberType: string,
   node: ts.Node,
 ): void => {
+  if (config.suppressReservedPublicNameWarnings) {
+    return;
+  }
+
   if (RESERVED_PUBLIC_MEMBERS.has(memberName.toLowerCase())) {
     const warn = buildWarn(diagnostics);
     warn.messageText = [

src/compiler/transformers/reserved-public-members.ts

@@ -152,6 +152,11 @@ export interface StencilConfig {
    * This behavior defaults to `true`, but may be opted-out of by setting this flag to `false`.
    */
   transformAliasedImportPaths?: boolean;
+  /**
+   * When `true`, Stencil will suppress diagnostics which warn about public members using reserved names
+   * (for example, decorating a method named `focus` with `@Method()`). Defaults to `false`.
+   */
+  suppressReservedPublicNameWarnings?: boolean;
   /**
    * When `true`, we will validate a project's `package.json` based on the output target the user has designated
    * as `isPrimaryPackageOutputTarget: true` in their Stencil config.