@stencil/core 4.41.3-dev.1769664017.f2dbed7 → 4.41.3-dev.1769975738.ddc7508

package/cli/index.cjs

@@ -1,5 +1,5 @@
 /*!
- Stencil CLI (CommonJS) v4.41.3-dev.1769664017.f2dbed7 | MIT Licensed | https://stenciljs.com
+ Stencil CLI (CommonJS) v4.41.3-dev.1769975738.ddc7508 | MIT Licensed | https://stenciljs.com
  */
 "use strict";
 var __create = Object.create;

package/cli/index.js

@@ -1,5 +1,5 @@
 /*!
- Stencil CLI v4.41.3-dev.1769664017.f2dbed7 | MIT Licensed | https://stenciljs.com
+ Stencil CLI v4.41.3-dev.1769975738.ddc7508 | MIT Licensed | https://stenciljs.com
  */
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/cli",
-  "version": "4.41.3-dev.1769664017.f2dbed7",
+  "version": "4.41.3-dev.1769975738.ddc7508",
   "description": "Stencil CLI.",
   "main": "./index.cjs",
   "module": "./index.js",

package/compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/compiler",
-  "version": "4.41.3-dev.1769664017.f2dbed7",
+  "version": "4.41.3-dev.1769975738.ddc7508",
   "description": "Stencil Compiler.",
   "main": "./stencil.js",
   "types": "./stencil.d.ts",

package/compiler/stencil.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Compiler v4.41.3-dev.1769664017.f2dbed7 | MIT Licensed | https://stenciljs.com
+ Stencil Compiler v4.41.3-dev.1769975738.ddc7508 | MIT Licensed | https://stenciljs.com
  */
 "use strict";
 var __create = Object.create;
@@ -245765,7 +245765,7 @@ var import_typescript72 = __toESM(require_typescript_5_8_3_bundle_cache_min());
 
 // src/version.ts
 init_import_meta_url();
-var buildId = "1769664017";
+var buildId = "1769975738";
 var minfyJsId = "terser5.37.0_7";
 var optimizeCssId = "autoprefixer10.4.19_postcss8.5.6_7";
 var parse5Version = "7.2.1";
@@ -245773,8 +245773,8 @@ var rollupVersion = "4.34.9";
 var jqueryVersion = "4.0.0-pre";
 var terserVersion = "5.37.0";
 var typescriptVersion = "5.8.3";
-var vermoji = "\u{1F980}";
-var version = "4.41.3-dev.1769664017.f2dbed7";
+var vermoji = "\u{1F336}";
+var version = "4.41.3-dev.1769975738.ddc7508";
 var versions = {
   stencil: version,
   parse5: parse5Version,
@@ -249742,92 +249742,112 @@ var HOST_REF_ARG = "hostRef";
 
 // src/compiler/transformers/component-lazy/attach-internals.ts
 function createLazyAttachInternalsBinding(cmp) {
+  var _a2;
   if (!(cmp == null ? void 0 : cmp.attachInternalsMemberName)) {
     return [];
   }
-  if (cmp.attachInternalsMemberName) {
-    return [
-      import_typescript4.default.factory.createIfStatement(
-        // the condition for the `if` statement here is just whether the
-        // following is defined:
-        //
-        // ```ts
-        // hostRef.$hostElement$["s-ei"]
-        // ```
-        hostRefElementInternalsPropAccess(),
-        import_typescript4.default.factory.createBlock(
-          [
-            // this `ts.factory` call creates the following statement:
-            //
-            // ```ts
-            // this.${ cmp.formInternalsMemberName } = hostRef.$hostElement$['s-ei'];
-            // ```
-            import_typescript4.default.factory.createExpressionStatement(
-              import_typescript4.default.factory.createBinaryExpression(
-                import_typescript4.default.factory.createPropertyAccessExpression(
-                  import_typescript4.default.factory.createThis(),
-                  // use the name set on the {@link d.ComponentCompilerMeta}
-                  import_typescript4.default.factory.createIdentifier(cmp.attachInternalsMemberName)
-                ),
-                import_typescript4.default.factory.createToken(import_typescript4.default.SyntaxKind.EqualsToken),
-                hostRefElementInternalsPropAccess()
-              )
+  const statements = [
+    import_typescript4.default.factory.createIfStatement(
+      // the condition for the `if` statement here is just whether the
+      // following is defined:
+      //
+      // ```ts
+      // hostRef.$hostElement$["s-ei"]
+      // ```
+      hostRefElementInternalsPropAccess(),
+      import_typescript4.default.factory.createBlock(
+        [
+          // this `ts.factory` call creates the following statement:
+          //
+          // ```ts
+          // this.${ cmp.formInternalsMemberName } = hostRef.$hostElement$['s-ei'];
+          // ```
+          import_typescript4.default.factory.createExpressionStatement(
+            import_typescript4.default.factory.createBinaryExpression(
+              import_typescript4.default.factory.createPropertyAccessExpression(
+                import_typescript4.default.factory.createThis(),
+                // use the name set on the {@link d.ComponentCompilerMeta}
+                import_typescript4.default.factory.createIdentifier(cmp.attachInternalsMemberName)
+              ),
+              import_typescript4.default.factory.createToken(import_typescript4.default.SyntaxKind.EqualsToken),
+              hostRefElementInternalsPropAccess()
             )
-          ],
-          true
-        ),
-        import_typescript4.default.factory.createBlock(
-          [
-            // this `ts.factory` call creates the following statement:
-            //
-            // ```ts
-            // this.${ cmp.attachInternalsMemberName } = hostRef.$hostElement$.attachInternals();
-            // ```
-            import_typescript4.default.factory.createExpressionStatement(
-              import_typescript4.default.factory.createBinaryExpression(
+          )
+        ],
+        true
+      ),
+      import_typescript4.default.factory.createBlock(
+        [
+          // this `ts.factory` call creates the following statement:
+          //
+          // ```ts
+          // this.${ cmp.attachInternalsMemberName } = hostRef.$hostElement$.attachInternals();
+          // ```
+          import_typescript4.default.factory.createExpressionStatement(
+            import_typescript4.default.factory.createBinaryExpression(
+              import_typescript4.default.factory.createPropertyAccessExpression(
+                import_typescript4.default.factory.createThis(),
+                // use the name set on the {@link d.ComponentCompilerMeta}
+                import_typescript4.default.factory.createIdentifier(cmp.attachInternalsMemberName)
+              ),
+              import_typescript4.default.factory.createToken(import_typescript4.default.SyntaxKind.EqualsToken),
+              import_typescript4.default.factory.createCallExpression(
                 import_typescript4.default.factory.createPropertyAccessExpression(
-                  import_typescript4.default.factory.createThis(),
-                  // use the name set on the {@link d.ComponentCompilerMeta}
-                  import_typescript4.default.factory.createIdentifier(cmp.attachInternalsMemberName)
-                ),
-                import_typescript4.default.factory.createToken(import_typescript4.default.SyntaxKind.EqualsToken),
-                import_typescript4.default.factory.createCallExpression(
                   import_typescript4.default.factory.createPropertyAccessExpression(
-                    import_typescript4.default.factory.createPropertyAccessExpression(
-                      import_typescript4.default.factory.createIdentifier(HOST_REF_ARG),
-                      import_typescript4.default.factory.createIdentifier("$hostElement$")
-                    ),
-                    import_typescript4.default.factory.createIdentifier("attachInternals")
+                    import_typescript4.default.factory.createIdentifier(HOST_REF_ARG),
+                    import_typescript4.default.factory.createIdentifier("$hostElement$")
                   ),
-                  void 0,
-                  []
-                )
+                  import_typescript4.default.factory.createIdentifier("attachInternals")
+                ),
+                void 0,
+                []
               )
-            ),
-            // this `ts.factory` call produces the following:
-            //
-            // ```ts
-            // hostRef.$hostElement$['s-ei'] = this.${ cmp.attachInternalsMemberName };
-            // ```
-            import_typescript4.default.factory.createExpressionStatement(
-              import_typescript4.default.factory.createBinaryExpression(
-                hostRefElementInternalsPropAccess(),
-                import_typescript4.default.factory.createToken(import_typescript4.default.SyntaxKind.EqualsToken),
-                import_typescript4.default.factory.createPropertyAccessExpression(
-                  import_typescript4.default.factory.createThis(),
-                  // use the name set on the {@link d.ComponentCompilerMeta}
-                  import_typescript4.default.factory.createIdentifier(cmp.attachInternalsMemberName)
-                )
+            )
+          ),
+          // this `ts.factory` call produces the following:
+          //
+          // ```ts
+          // hostRef.$hostElement$['s-ei'] = this.${ cmp.attachInternalsMemberName };
+          // ```
+          import_typescript4.default.factory.createExpressionStatement(
+            import_typescript4.default.factory.createBinaryExpression(
+              hostRefElementInternalsPropAccess(),
+              import_typescript4.default.factory.createToken(import_typescript4.default.SyntaxKind.EqualsToken),
+              import_typescript4.default.factory.createPropertyAccessExpression(
+                import_typescript4.default.factory.createThis(),
+                // use the name set on the {@link d.ComponentCompilerMeta}
+                import_typescript4.default.factory.createIdentifier(cmp.attachInternalsMemberName)
               )
             )
-          ],
-          true
-        )
+          )
+        ],
+        true
       )
-    ];
-  } else {
-    return [];
+    )
+  ];
+  if (((_a2 = cmp.attachInternalsCustomStates) == null ? void 0 : _a2.length) > 0) {
+    for (const customState of cmp.attachInternalsCustomStates) {
+      if (customState.initialValue) {
+        statements.push(createStatesAddCall(cmp.attachInternalsMemberName, customState.name));
+      }
+    }
   }
+  return statements;
+}
+function createStatesAddCall(memberName, stateName) {
+  return import_typescript4.default.factory.createExpressionStatement(
+    import_typescript4.default.factory.createCallExpression(
+      import_typescript4.default.factory.createPropertyAccessExpression(
+        import_typescript4.default.factory.createPropertyAccessExpression(
+          import_typescript4.default.factory.createPropertyAccessExpression(import_typescript4.default.factory.createThis(), import_typescript4.default.factory.createIdentifier(memberName)),
+          import_typescript4.default.factory.createIdentifier("states")
+        ),
+        import_typescript4.default.factory.createIdentifier("add")
+      ),
+      void 0,
+      [import_typescript4.default.factory.createStringLiteral(stateName)]
+    )
+  );
 }
 function hostRefElementInternalsPropAccess() {
   return import_typescript4.default.factory.createElementAccessExpression(
@@ -268038,30 +268058,53 @@ var import_typescript27 = __toESM(require_typescript_5_8_3_bundle_cache_min());
 init_import_meta_url();
 var import_typescript26 = __toESM(require_typescript_5_8_3_bundle_cache_min());
 function createNativeAttachInternalsBinding(cmp) {
-  if (cmp.attachInternalsMemberName) {
-    return [
-      import_typescript26.default.factory.createExpressionStatement(
-        import_typescript26.default.factory.createBinaryExpression(
+  var _a2;
+  if (!cmp.attachInternalsMemberName) {
+    return [];
+  }
+  const statements = [
+    import_typescript26.default.factory.createExpressionStatement(
+      import_typescript26.default.factory.createBinaryExpression(
+        import_typescript26.default.factory.createPropertyAccessExpression(
+          import_typescript26.default.factory.createThis(),
+          // use the name set on the {@link d.ComponentCompilerMeta}
+          import_typescript26.default.factory.createIdentifier(cmp.attachInternalsMemberName)
+        ),
+        import_typescript26.default.factory.createToken(import_typescript26.default.SyntaxKind.EqualsToken),
+        import_typescript26.default.factory.createCallExpression(
           import_typescript26.default.factory.createPropertyAccessExpression(
             import_typescript26.default.factory.createThis(),
-            // use the name set on the {@link d.ComponentCompilerMeta}
-            import_typescript26.default.factory.createIdentifier(cmp.attachInternalsMemberName)
+            import_typescript26.default.factory.createIdentifier("attachInternals")
           ),
-          import_typescript26.default.factory.createToken(import_typescript26.default.SyntaxKind.EqualsToken),
-          import_typescript26.default.factory.createCallExpression(
-            import_typescript26.default.factory.createPropertyAccessExpression(
-              import_typescript26.default.factory.createThis(),
-              import_typescript26.default.factory.createIdentifier("attachInternals")
-            ),
-            void 0,
-            []
-          )
+          void 0,
+          []
         )
       )
-    ];
-  } else {
-    return [];
+    )
+  ];
+  if (((_a2 = cmp.attachInternalsCustomStates) == null ? void 0 : _a2.length) > 0) {
+    for (const customState of cmp.attachInternalsCustomStates) {
+      if (customState.initialValue) {
+        statements.push(createStatesAddCall2(cmp.attachInternalsMemberName, customState.name));
+      }
+    }
   }
+  return statements;
+}
+function createStatesAddCall2(memberName, stateName) {
+  return import_typescript26.default.factory.createExpressionStatement(
+    import_typescript26.default.factory.createCallExpression(
+      import_typescript26.default.factory.createPropertyAccessExpression(
+        import_typescript26.default.factory.createPropertyAccessExpression(
+          import_typescript26.default.factory.createPropertyAccessExpression(import_typescript26.default.factory.createThis(), import_typescript26.default.factory.createIdentifier(memberName)),
+          import_typescript26.default.factory.createIdentifier("states")
+        ),
+        import_typescript26.default.factory.createIdentifier("add")
+      ),
+      void 0,
+      [import_typescript26.default.factory.createStringLiteral(stateName)]
+    )
+  );
 }
 
 // src/compiler/transformers/component-native/native-constructor.ts
@@ -273084,6 +273127,7 @@ var getDocsComponents = async (config, compilerCtx, buildCtx) => {
         styles: getDocsStyles(cmp),
         slots: getDocsSlots(cmp.docs.tags),
         parts: getDocsParts(cmp.htmlParts, cmp.docs.tags),
+        customStates: getDocsCustomStates(cmp),
         listeners: getDocsListeners(cmp.listeners)
       }));
     })
@@ -273282,6 +273326,19 @@ var getDocsParts = (vdom, tags) => {
     (p) => p.name
   );
 };
+var getDocsCustomStates = (cmpMeta) => {
+  if (!cmpMeta.attachInternalsCustomStates || cmpMeta.attachInternalsCustomStates.length === 0) {
+    return [];
+  }
+  return sortBy(
+    cmpMeta.attachInternalsCustomStates.map((state) => ({
+      name: state.name,
+      initialValue: state.initialValue,
+      docs: state.docs || ""
+    })),
+    (state) => state.name
+  );
+};
 var getNameText = (name, tags) => {
   return tags.filter((tag) => tag.name === name && tag.text).map(({ text }) => {
     const [namePart, ...rest] = (" " + text).split(" - ");
@@ -273394,7 +273451,7 @@ var generateCustomDocs = async (config, docsData, outputTargets) => {
   );
 };
 
-// src/compiler/docs/custom-elements-manifest.ts
+// src/compiler/docs/cem/index.ts
 init_import_meta_url();
 var generateCustomElementsManifestDocs = async (compilerCtx, docsData, outputTargets) => {
   const cemOutputTargets = outputTargets.filter(isOutputTargetDocsCustomElementsManifest);
@@ -273567,6 +273624,13 @@ var componentToDeclaration = (component) => {
     ...slots.length > 0 && { slots },
     ...cssParts.length > 0 && { cssParts },
     ...cssProperties.length > 0 && { cssProperties },
+    ...component.customStates.length > 0 && {
+      customStates: component.customStates.map((state) => ({
+        name: state.name,
+        initialValue: state.initialValue,
+        ...state.docs && { description: state.docs }
+      }))
+    },
     ...demos.length > 0 && { demos }
   };
 };
@@ -273607,6 +273671,7 @@ export default _default;
       styles: cmp.styles,
       slots: cmp.slots,
       parts: cmp.parts,
+      states: cmp.customStates,
       dependents: cmp.dependents,
       dependencies: cmp.dependencies,
       dependencyGraph: cmp.dependencyGraph,
@@ -273653,6 +273718,26 @@ var stylesToMarkdown = (styles2) => {
   return content;
 };
 
+// src/compiler/docs/readme/markdown-custom-states.ts
+init_import_meta_url();
+var customStatesToMarkdown = (customStates) => {
+  const content = [];
+  if (customStates.length === 0) {
+    return content;
+  }
+  content.push(`## Custom States`);
+  content.push(``);
+  const table = new MarkdownTable();
+  table.addHeader(["State", "Initial Value", "Description"]);
+  customStates.forEach((state) => {
+    table.addRow([`\`:state(${state.name})\``, state.initialValue ? "`true`" : "`false`", state.docs]);
+  });
+  content.push(...table.toMarkdown());
+  content.push(``);
+  content.push(``);
+  return content;
+};
+
 // src/compiler/docs/readme/markdown-dependencies.ts
 init_import_meta_url();
 var depsToMarkdown = (cmp, cmps, config) => {
@@ -273953,6 +274038,7 @@ var generateMarkdown = (userContent, cmp, cmps, readmeOutput, config) => {
     ...methodsToMarkdown(cmp.methods),
     ...slotsToMarkdown(cmp.slots),
     ...partsToMarkdown(cmp.parts),
+    ...customStatesToMarkdown(cmp.customStates),
     ...stylesToMarkdown(cmp.styles),
     ...dependencies,
     `----------------------------------------------`,
@@ -274674,6 +274760,23 @@ var generateComponentTypes = (cmp, typeImportData, areTypesInternal) => {
     `        new (): ${htmlElementName};`,
     `    };`
   ];
+  const propsWithAttributes = cmp.properties.filter((prop) => prop.attribute !== void 0);
+  const hasExplicitAttributes = propsWithAttributes.length > 0;
+  const requiredProps = propsWithAttributes.filter((prop) => prop.required);
+  const hasRequiredProps = requiredProps.length > 0;
+  const explicitAttributes = propsWithAttributes.map((prop) => {
+    const propMeta = cmp.properties.find((p) => p.name === prop.name);
+    let attrType = "string";
+    if (propMeta == null ? void 0 : propMeta.type) {
+      const simpleType = propMeta.type.trim();
+      if (["string", "number", "boolean"].includes(simpleType)) {
+        attrType = simpleType;
+      } else {
+        attrType = "string";
+      }
+    }
+    return `        "${prop.name}": ${attrType};`;
+  }).join("\n");
   return {
     isDep,
     tagName,
@@ -274684,7 +274787,16 @@ ${componentAttributes}    }`, cmp.docs, 4),
     jsx: `    interface ${tagNameAsPascal} {
 ${jsxAttributes}    }`,
     element: element.join(`
-`)
+`),
+    explicitAttributes: hasExplicitAttributes ? `    interface ${tagNameAsPascal}Attributes {
+${explicitAttributes}
+    }` : null,
+    explicitProperties: null,
+    requiredProps: hasRequiredProps ? requiredProps.map((p) => ({
+      name: p.name,
+      type: p.type,
+      complexType: p.complexType
+    })) : null
   };
 };
 function generateStandardElementInterface(htmlElementName, tagNameAsPascal, htmlElementEventListenerProperties, docs) {
@@ -274760,7 +274872,10 @@ var generateEventDetailTypes = (cmp) => {
     htmlElementName,
     component: cmpInterface.join("\n"),
     jsx: cmpInterface.join("\n"),
-    element: cmpInterface.join("\n")
+    element: cmpInterface.join("\n"),
+    explicitAttributes: null,
+    explicitProperties: null,
+    requiredProps: null
   };
 };
 
@@ -274949,14 +275064,43 @@ var generateComponentTypesFile = (config, buildCtx, areTypesInternal) => {
   c.push(`    }`);
   c.push(`}`);
   c.push(`declare namespace LocalJSX {`);
+  const hasAnyRequiredProps = modules.some((m) => m.requiredProps);
+  if (hasAnyRequiredProps) {
+    c.push(
+      `    type OneOf<K extends string, T> = { [P in K]: T } | { [P in \`attr:\${K}\`]: T } | { [P in \`prop:\${K}\`]: T };`
+    );
+    c.push(``);
+  }
   c.push(
     ...modules.map((m) => {
       const docs = components.find((c2) => c2.tagName === m.tagName).docs;
       return addDocBlock(m.jsx, docs, 4);
     })
   );
+  const attributeInterfaces = modules.filter((m) => m.explicitAttributes).map((m) => m.explicitAttributes);
+  if (attributeInterfaces.length > 0) {
+    c.push(``);
+    c.push(...attributeInterfaces);
+    c.push(``);
+  }
   c.push(`    interface IntrinsicElements {`);
-  c.push(...modules.map((m) => `        "${m.tagName}": ${m.tagNameAsPascal};`));
+  c.push(
+    ...modules.map((m) => {
+      if (m.explicitAttributes) {
+        const baseOptional = `Omit<${m.tagNameAsPascal}, keyof ${m.tagNameAsPascal}Attributes> & { [K in keyof ${m.tagNameAsPascal} & keyof ${m.tagNameAsPascal}Attributes]?: ${m.tagNameAsPascal}[K] } & { [K in keyof ${m.tagNameAsPascal} & keyof ${m.tagNameAsPascal}Attributes as \`attr:\${K}\`]?: ${m.tagNameAsPascal}Attributes[K] } & { [K in keyof ${m.tagNameAsPascal} & keyof ${m.tagNameAsPascal}Attributes as \`prop:\${K}\`]?: ${m.tagNameAsPascal}[K] }`;
+        if (m.requiredProps && m.requiredProps.length > 0) {
+          const requiredUnions = m.requiredProps.map((prop) => {
+            return `OneOf<"${prop.name}", ${m.tagNameAsPascal}["${prop.name}"]>`;
+          }).join(" & ");
+          return `        "${m.tagName}": ${baseOptional} & ${requiredUnions};`;
+        } else {
+          return `        "${m.tagName}": ${baseOptional};`;
+        }
+      } else {
+        return `        "${m.tagName}": ${m.tagNameAsPascal};`;
+      }
+    })
+  );
   c.push(`    }`);
   c.push(`}`);
   c.push(`export { LocalJSX as JSX };`);
@@ -274967,7 +275111,7 @@ var generateComponentTypesFile = (config, buildCtx, areTypesInternal) => {
     ...modules.map((m) => {
       const docs = components.find((c2) => c2.tagName === m.tagName).docs;
       return addDocBlock(
-        `            "${m.tagName}": LocalJSX.${m.tagNameAsPascal} & JSXBase.HTMLAttributes<${m.htmlElementName}>;`,
+        `            "${m.tagName}": LocalJSX.IntrinsicElements["${m.tagName}"] & JSXBase.HTMLAttributes<${m.htmlElementName}>;`,
         docs,
         12
       );
@@ -276150,9 +276294,10 @@ var isDecoratorNamed = (propName) => {
 
 // src/compiler/transformers/decorators-to-static/attach-internals.ts
 var attachInternalsDecoratorsToStatic = (diagnostics, decoratedMembers, newMembers, typeChecker, decoratorName) => {
+  var _a2;
   const attachInternalsMembers = decoratedMembers.filter(import_typescript44.default.isPropertyDeclaration).filter((prop) => {
-    var _a2;
-    return !!((_a2 = retrieveTsDecorators(prop)) == null ? void 0 : _a2.find(isDecoratorNamed(decoratorName)));
+    var _a3;
+    return !!((_a3 = retrieveTsDecorators(prop)) == null ? void 0 : _a3.find(isDecoratorNamed(decoratorName)));
   });
   if (attachInternalsMembers.length === 0) {
     return;
@@ -276164,8 +276309,52 @@ var attachInternalsDecoratorsToStatic = (diagnostics, decoratedMembers, newMembe
   }
   const [decoratedProp] = attachInternalsMembers;
   const { staticName: name } = tsPropDeclName(decoratedProp, typeChecker);
+  const decorator3 = (_a2 = retrieveTsDecorators(decoratedProp)) == null ? void 0 : _a2.find(isDecoratorNamed(decoratorName));
+  const customStates = parseCustomStatesFromDecorator(decorator3, typeChecker);
   newMembers.push(createStaticGetter("attachInternalsMemberName", convertValueToLiteral(name)));
+  if (customStates.length > 0) {
+    newMembers.push(createStaticGetter("attachInternalsCustomStates", convertValueToLiteral(customStates)));
+  }
 };
+function parseCustomStatesFromDecorator(decorator3, typeChecker) {
+  if (!decorator3 || !import_typescript44.default.isCallExpression(decorator3.expression)) {
+    return [];
+  }
+  const [firstArg] = decorator3.expression.arguments;
+  if (!firstArg || !import_typescript44.default.isObjectLiteralExpression(firstArg)) {
+    return [];
+  }
+  const statesProp = firstArg.properties.find(
+    (prop) => import_typescript44.default.isPropertyAssignment(prop) && import_typescript44.default.isIdentifier(prop.name) && prop.name.text === "states"
+  );
+  if (!statesProp || !import_typescript44.default.isObjectLiteralExpression(statesProp.initializer)) {
+    return [];
+  }
+  const customStates = [];
+  for (const prop of statesProp.initializer.properties) {
+    if (!import_typescript44.default.isPropertyAssignment(prop)) {
+      continue;
+    }
+    const stateName = import_typescript44.default.isIdentifier(prop.name) ? prop.name.text : import_typescript44.default.isStringLiteral(prop.name) ? prop.name.text : null;
+    if (!stateName) {
+      continue;
+    }
+    let initialValue = false;
+    if (prop.initializer.kind === import_typescript44.default.SyntaxKind.TrueKeyword) {
+      initialValue = true;
+    } else if (prop.initializer.kind === import_typescript44.default.SyntaxKind.FalseKeyword) {
+      initialValue = false;
+    }
+    const symbol = typeChecker.getSymbolAtLocation(prop.name);
+    const docs = symbol ? import_typescript44.default.displayPartsToString(symbol.getDocumentationComment(typeChecker)) : "";
+    customStates.push({
+      name: stateName,
+      initialValue,
+      docs
+    });
+  }
+  return customStates;
+}
 
 // src/compiler/transformers/decorators-to-static/component-decorator.ts
 init_import_meta_url();
@@ -277968,6 +278157,20 @@ var parseAttachInternals = (staticMembers) => {
     return null;
   }
 };
+var parseAttachInternalsCustomStates = (staticMembers) => {
+  const parsedCustomStates = getStaticValue(staticMembers, "attachInternalsCustomStates");
+  if (Array.isArray(parsedCustomStates)) {
+    return parsedCustomStates.map((state) => {
+      var _a2;
+      return {
+        name: String(state.name),
+        initialValue: Boolean(state.initialValue),
+        docs: (_a2 = state.docs) != null ? _a2 : ""
+      };
+    });
+  }
+  return [];
+};
 
 // src/compiler/transformers/static-to-meta/class-methods.ts
 init_import_meta_url();
@@ -278628,6 +278831,7 @@ var parseStaticComponentMeta = (compilerCtx, typeChecker, cmpNode, moduleFile, b
   const encapsulation = parseStaticEncapsulation(staticMembers);
   const cmp = {
     attachInternalsMemberName: parseAttachInternals(staticMembers),
+    attachInternalsCustomStates: parseAttachInternalsCustomStates(staticMembers),
     formAssociated: parseFormAssociated(staticMembers),
     tagName,
     excludeFromCollection: moduleFile.excludeFromCollection,

package/dev-server/client/index.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Dev Server Client v4.41.3-dev.1769664017.f2dbed7 | MIT Licensed | https://stenciljs.com
+ Stencil Dev Server Client v4.41.3-dev.1769975738.ddc7508 | MIT Licensed | https://stenciljs.com
  */
 
 // src/dev-server/client/app-error.css

package/dev-server/client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/dev-server/client",
-  "version": "4.41.3-dev.1769664017.f2dbed7",
+  "version": "4.41.3-dev.1769975738.ddc7508",
   "description": "Stencil Dev Server Client.",
   "main": "./index.js",
   "types": "./index.d.ts",