@stencil/core 4.41.3 → 4.42.0

package/compiler/stencil.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Compiler v4.41.3 | MIT Licensed | https://stenciljs.com
+ Stencil Compiler v4.42.0 | MIT Licensed | https://stenciljs.com
  */
 "use strict";
 var __create = Object.create;
@@ -60573,7 +60573,7 @@ ${lanes.join("\n")}
         function symbolIsValue(symbol, includeTypeOnlyMembers) {
           return !!(symbol.flags & 111551 || symbol.flags & 2097152 && getSymbolFlags(symbol, !includeTypeOnlyMembers) & 111551);
         }
-        function createType(flags) {
+        function createType2(flags) {
           var _a2;
           const result2 = new Type29(checker, flags);
           typeCount++;
@@ -60582,7 +60582,7 @@ ${lanes.join("\n")}
           return result2;
         }
         function createTypeWithSymbol(flags, symbol) {
-          const result2 = createType(flags);
+          const result2 = createType2(flags);
           result2.symbol = symbol;
           return result2;
         }
@@ -60591,7 +60591,7 @@ ${lanes.join("\n")}
         }
         function createIntrinsicType(kind, intrinsicName, objectFlags = 0, debugIntrinsicName) {
           checkIntrinsicName(intrinsicName, debugIntrinsicName);
-          const type = createType(kind);
+          const type = createType2(kind);
           type.intrinsicName = intrinsicName;
           type.debugIntrinsicName = debugIntrinsicName;
           type.objectFlags = objectFlags | 524288 | 2097152 | 33554432 | 16777216;
@@ -71142,7 +71142,7 @@ ${lanes.join("\n")}
           if (cached) {
             return cached;
           }
-          const result2 = createType(
+          const result2 = createType2(
             33554432
             /* Substitution */
           );
@@ -72366,7 +72366,7 @@ ${lanes.join("\n")}
           const id = typeKey + getAliasId(aliasSymbol, aliasTypeArguments);
           let type = unionTypes.get(id);
           if (!type) {
-            type = createType(
+            type = createType2(
               1048576
               /* Union */
             );
@@ -72528,7 +72528,7 @@ ${lanes.join("\n")}
           return true;
         }
         function createIntersectionType(types2, objectFlags, aliasSymbol, aliasTypeArguments) {
-          const result2 = createType(
+          const result2 = createType2(
             2097152
             /* Intersection */
           );
@@ -72684,7 +72684,7 @@ ${lanes.join("\n")}
           return links.resolvedType;
         }
         function createIndexType(type, indexFlags) {
-          const result2 = createType(
+          const result2 = createType2(
             4194304
             /* Index */
           );
@@ -72906,7 +72906,7 @@ ${lanes.join("\n")}
           return type.flags & 128 ? type.value : type.flags & 256 ? "" + type.value : type.flags & 2048 ? pseudoBigIntToString(type.value) : type.flags & (512 | 98304) ? type.intrinsicName : void 0;
         }
         function createTemplateLiteralType(texts, types2) {
-          const type = createType(
+          const type = createType2(
             134217728
             /* TemplateLiteral */
           );
@@ -72963,7 +72963,7 @@ ${lanes.join("\n")}
           return result2;
         }
         function createIndexedAccessType(objectType, indexType, accessFlags, aliasSymbol, aliasTypeArguments) {
-          const type = createType(
+          const type = createType2(
             8388608
             /* IndexedAccess */
           );
@@ -73537,7 +73537,7 @@ ${lanes.join("\n")}
                 break;
               }
             }
-            result2 = createType(
+            result2 = createType2(
               16777216
               /* Conditional */
             );
@@ -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 = "1769170720";
+var buildId = "1769988906";
 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{1F387}";
-var version = "4.41.3";
+var vermoji = "\u{1F691}";
+var version = "4.42.0";
 var versions = {
   stencil: version,
   parse5: parse5Version,
@@ -245812,6 +245812,7 @@ var DOCS_CUSTOM = "docs-custom";
 var DOCS_JSON = "docs-json";
 var DOCS_README = "docs-readme";
 var DOCS_VSCODE = "docs-vscode";
+var DOCS_CUSTOM_ELEMENTS_MANIFEST = "docs-custom-elements-manifest";
 var STATS = "stats";
 var WWW = "www";
 var VALID_CONFIG_OUTPUT_TARGETS = [
@@ -245827,6 +245828,7 @@ var VALID_CONFIG_OUTPUT_TARGETS = [
   DOCS_README,
   DOCS_VSCODE,
   DOCS_CUSTOM,
+  DOCS_CUSTOM_ELEMENTS_MANIFEST,
   // MISC
   COPY,
   CUSTOM,
@@ -248210,11 +248212,12 @@ var isOutputTargetDistLazyLoader = (o) => o.type === DIST_LAZY_LOADER;
 var isOutputTargetDistGlobalStyles = (o) => o.type === DIST_GLOBAL_STYLES;
 var isOutputTargetHydrate = (o) => o.type === DIST_HYDRATE_SCRIPT;
 var isOutputTargetCustom = (o) => o.type === CUSTOM;
-var isOutputTargetDocs = (o) => o.type === DOCS_README || o.type === DOCS_JSON || o.type === DOCS_CUSTOM || o.type === DOCS_VSCODE;
+var isOutputTargetDocs = (o) => o.type === DOCS_README || o.type === DOCS_JSON || o.type === DOCS_CUSTOM || o.type === DOCS_VSCODE || o.type === DOCS_CUSTOM_ELEMENTS_MANIFEST;
 var isOutputTargetDocsReadme = (o) => o.type === DOCS_README;
 var isOutputTargetDocsJson = (o) => o.type === DOCS_JSON;
 var isOutputTargetDocsCustom = (o) => o.type === DOCS_CUSTOM;
 var isOutputTargetDocsVscode = (o) => o.type === DOCS_VSCODE;
+var isOutputTargetDocsCustomElementsManifest = (o) => o.type === DOCS_CUSTOM_ELEMENTS_MANIFEST;
 var isOutputTargetWww = (o) => o.type === WWW;
 var isOutputTargetStats = (o) => o.type === STATS;
 var isOutputTargetDistTypes = (o) => o.type === DIST_TYPES;
@@ -249739,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(
@@ -268035,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
@@ -270016,18 +270062,19 @@ var writeHydrateOutput = async (config, compilerCtx, buildCtx, outputTarget, rol
   const hydrateCoreIndexPath = join(hydrateAppDirPath, "index.js");
   const hydrateCoreIndexPathESM = join(hydrateAppDirPath, "index.mjs");
   const hydrateCoreIndexDtsFilePath = join(hydrateAppDirPath, "index.d.ts");
-  const pkgJsonPath = join(hydrateAppDirPath, "package.json");
-  const pkgJsonCode = getHydratePackageJson(
-    config,
-    hydrateCoreIndexPath,
-    hydrateCoreIndexPathESM,
-    hydrateCoreIndexDtsFilePath,
-    hydratePackageName
-  );
-  await Promise.all([
-    copyHydrateRunnerDts(config, compilerCtx, hydrateAppDirPath),
-    compilerCtx.fs.writeFile(pkgJsonPath, pkgJsonCode)
-  ]);
+  const writeOperations = [copyHydrateRunnerDts(config, compilerCtx, hydrateAppDirPath)];
+  if (outputTarget.generatePackageJson) {
+    const pkgJsonPath = join(hydrateAppDirPath, "package.json");
+    const pkgJsonCode = getHydratePackageJson(
+      config,
+      hydrateCoreIndexPath,
+      hydrateCoreIndexPathESM,
+      hydrateCoreIndexDtsFilePath,
+      hydratePackageName
+    );
+    writeOperations.push(compilerCtx.fs.writeFile(pkgJsonPath, pkgJsonCode));
+  }
+  await Promise.all(writeOperations);
   buildCtx.hydrateAppFilePath = hydrateCoreIndexPath;
   const minify2 = outputTarget.minify === true;
   await Promise.all(
@@ -271655,6 +271702,10 @@ var validateDocs = (config, diagnostics, userOutputs) => {
   vscodeDocsOutputs.forEach((vscodeDocsOutput) => {
     docsOutputs.push(validateVScodeDocsOutputTarget(diagnostics, vscodeDocsOutput));
   });
+  const customElementsManifestOutputs = userOutputs.filter(isOutputTargetDocsCustomElementsManifest);
+  customElementsManifestOutputs.forEach((cemOutput) => {
+    docsOutputs.push(validateCustomElementsManifestOutputTarget(config, cemOutput));
+  });
   return docsOutputs;
 };
 var validateReadmeOutputTarget = (config, outputTarget) => {
@@ -271699,6 +271750,14 @@ var validateVScodeDocsOutputTarget = (diagnostics, outputTarget) => {
   }
   return outputTarget;
 };
+var validateCustomElementsManifestOutputTarget = (config, outputTarget) => {
+  if (!isString(outputTarget.file)) {
+    outputTarget.file = "custom-elements.json";
+  }
+  outputTarget.file = join(config.rootDir, outputTarget.file);
+  outputTarget.strict = !!outputTarget.strict;
+  return outputTarget;
+};
 
 // src/compiler/config/outputs/validate-hydrate-script.ts
 init_import_meta_url();
@@ -271738,6 +271797,9 @@ var validateHydrateScript = (config, userOutputs) => {
     if (!isBoolean(outputTarget.minify)) {
       outputTarget.minify = false;
     }
+    if (!isBoolean(outputTarget.generatePackageJson)) {
+      outputTarget.generatePackageJson = true;
+    }
     outputTarget.external = outputTarget.external || [];
     outputTarget.external.push("fs");
     outputTarget.external.push("path");
@@ -273065,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)
       }));
     })
@@ -273263,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(" - ");
@@ -273375,6 +273451,190 @@ var generateCustomDocs = async (config, docsData, outputTargets) => {
   );
 };
 
+// src/compiler/docs/cem/index.ts
+init_import_meta_url();
+var generateCustomElementsManifestDocs = async (compilerCtx, docsData, outputTargets) => {
+  const cemOutputTargets = outputTargets.filter(isOutputTargetDocsCustomElementsManifest);
+  if (cemOutputTargets.length === 0) {
+    return;
+  }
+  const manifest = generateManifest(docsData);
+  const jsonContent = JSON.stringify(manifest, null, 2);
+  await Promise.all(cemOutputTargets.map((outputTarget) => compilerCtx.fs.writeFile(outputTarget.file, jsonContent)));
+};
+var generateManifest = (docsData) => {
+  const componentsByFile = /* @__PURE__ */ new Map();
+  for (const component of docsData.components) {
+    const filePath = component.filePath;
+    if (!componentsByFile.has(filePath)) {
+      componentsByFile.set(filePath, []);
+    }
+    componentsByFile.get(filePath).push(component);
+  }
+  const modules = [];
+  for (const [filePath, components] of componentsByFile) {
+    const declarations = components.map((component) => componentToDeclaration(component));
+    const exports2 = components.flatMap((component) => {
+      const className = dashToPascalCase(component.tag);
+      return [
+        {
+          kind: "js",
+          name: className,
+          declaration: {
+            name: className
+          }
+        },
+        {
+          kind: "custom-element-definition",
+          name: component.tag,
+          declaration: {
+            name: className
+          }
+        }
+      ];
+    });
+    modules.push({
+      kind: "javascript-module",
+      path: filePath,
+      declarations,
+      exports: exports2
+    });
+  }
+  return {
+    schemaVersion: "2.1.0",
+    modules
+  };
+};
+var convertTypeReferences = (references) => {
+  if (!references || Object.keys(references).length === 0) {
+    return void 0;
+  }
+  return Object.entries(references).map(([name, ref]) => ({
+    name,
+    // Global types (like HTMLElement, Array) get 'global:' package
+    ...ref.location === "global" && { package: "global:" },
+    // Imported types get their module path
+    ...ref.location === "import" && ref.path && { module: ref.path }
+    // Local types don't need package or module (they're in the same module)
+  }));
+};
+var createType = (text, references) => {
+  const typeRefs = convertTypeReferences(references);
+  return {
+    text,
+    ...typeRefs && { references: typeRefs }
+  };
+};
+var componentToDeclaration = (component) => {
+  const className = dashToPascalCase(component.tag);
+  const attributes = component.props.filter((prop) => prop.attr !== void 0).map((prop) => {
+    var _a2;
+    return {
+      name: prop.attr,
+      ...prop.docs && { description: prop.docs },
+      ...prop.type && { type: createType(prop.type, (_a2 = prop.complexType) == null ? void 0 : _a2.references) },
+      ...prop.default !== void 0 && { default: prop.default },
+      fieldName: prop.name,
+      ...prop.deprecation !== void 0 && { deprecated: prop.deprecation || true }
+    };
+  });
+  const members = [
+    // Fields (properties)
+    ...component.props.map(
+      (prop) => {
+        var _a2;
+        return {
+          kind: "field",
+          name: prop.name,
+          ...prop.docs && { description: prop.docs },
+          ...prop.type && { type: createType(prop.type, (_a2 = prop.complexType) == null ? void 0 : _a2.references) },
+          ...prop.default !== void 0 && { default: prop.default },
+          ...prop.deprecation !== void 0 && { deprecated: prop.deprecation || true },
+          ...!prop.mutable && { readonly: true },
+          ...prop.attr && { attribute: prop.attr },
+          ...prop.reflectToAttr && { reflects: true }
+        };
+      }
+    ),
+    // Methods
+    ...component.methods.map(
+      (method) => {
+        var _a2;
+        return {
+          kind: "method",
+          name: method.name,
+          ...method.docs && { description: method.docs },
+          ...method.deprecation !== void 0 && { deprecated: method.deprecation || true },
+          ...method.parameters && method.parameters.length > 0 && {
+            parameters: method.parameters.map((param) => {
+              var _a3;
+              return {
+                name: param.name,
+                ...param.docs && { description: param.docs },
+                ...param.type && { type: createType(param.type, (_a3 = method.complexType) == null ? void 0 : _a3.references) }
+              };
+            })
+          },
+          ...method.returns && {
+            return: {
+              ...method.returns.type && { type: createType(method.returns.type, (_a2 = method.complexType) == null ? void 0 : _a2.references) },
+              ...method.returns.docs && { description: method.returns.docs }
+            }
+          }
+        };
+      }
+    )
+  ];
+  const events = component.events.map((event) => {
+    var _a2;
+    return {
+      name: event.event,
+      ...event.docs && { description: event.docs },
+      type: createType(event.detail ? `CustomEvent<${event.detail}>` : "CustomEvent", (_a2 = event.complexType) == null ? void 0 : _a2.references),
+      ...event.deprecation !== void 0 && { deprecated: event.deprecation || true }
+    };
+  });
+  const slots = component.slots.map((slot) => ({
+    name: slot.name,
+    ...slot.docs && { description: slot.docs }
+  }));
+  const cssParts = component.parts.map((part) => ({
+    name: part.name,
+    ...part.docs && { description: part.docs }
+  }));
+  const cssProperties = component.styles.filter((style) => style.annotation === "prop").map((style) => ({
+    name: style.name,
+    ...style.docs && { description: style.docs }
+  }));
+  const demos = Object.entries(component.usage || {}).map(([name, content]) => ({
+    // Create relative URL from usagesDir + filename
+    url: component.usagesDir ? `${component.usagesDir}/${name}.md` : `${name}.md`,
+    ...content && { description: content }
+  }));
+  return {
+    kind: "class",
+    customElement: true,
+    tagName: component.tag,
+    name: className,
+    ...component.docs && { description: component.docs },
+    ...component.deprecation !== void 0 && { deprecated: component.deprecation || true },
+    ...attributes.length > 0 && { attributes },
+    ...members.length > 0 && { members },
+    ...events.length > 0 && { events },
+    ...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 }
+  };
+};
+
 // src/compiler/docs/json/index.ts
 init_import_meta_url();
 var generateJsonDocs = async (config, compilerCtx, docsData, outputTargets) => {
@@ -273411,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,
@@ -273457,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) => {
@@ -273757,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,
     `----------------------------------------------`,
@@ -273883,7 +274165,7 @@ var outputDocs = async (config, compilerCtx, buildCtx) => {
     return;
   }
   const docsOutputTargets = config.outputTargets.filter(
-    (o) => isOutputTargetDocsReadme(o) || isOutputTargetDocsJson(o) || isOutputTargetDocsCustom(o) || isOutputTargetDocsVscode(o)
+    (o) => isOutputTargetDocsReadme(o) || isOutputTargetDocsJson(o) || isOutputTargetDocsCustom(o) || isOutputTargetDocsVscode(o) || isOutputTargetDocsCustomElementsManifest(o)
   );
   if (docsOutputTargets.length === 0) {
     return;
@@ -273894,7 +274176,8 @@ var outputDocs = async (config, compilerCtx, buildCtx) => {
     generateReadmeDocs(config, compilerCtx, docsData, docsOutputTargets),
     generateJsonDocs(config, compilerCtx, docsData, docsOutputTargets),
     generateVscodeDocs(compilerCtx, docsData, docsOutputTargets),
-    generateCustomDocs(config, docsData, docsOutputTargets)
+    generateCustomDocs(config, docsData, docsOutputTargets),
+    generateCustomElementsManifestDocs(compilerCtx, docsData, docsOutputTargets)
   ]);
 };
 
@@ -274477,6 +274760,22 @@ 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) => {
+    var _a2, _b;
+    const propMeta = cmp.properties.find((p) => p.name === prop.name);
+    const simpleType = (_a2 = propMeta == null ? void 0 : propMeta.type) == null ? void 0 : _a2.trim();
+    let attrType;
+    if (simpleType && ["string", "number", "boolean"].includes(simpleType)) {
+      attrType = ((_b = propMeta == null ? void 0 : propMeta.complexType) == null ? void 0 : _b.original) || simpleType;
+    } else {
+      attrType = "string";
+    }
+    return `        "${prop.name}": ${attrType};`;
+  }).join("\n");
   return {
     isDep,
     tagName,
@@ -274487,7 +274786,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) {
@@ -274563,7 +274871,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
   };
 };
 
@@ -274752,14 +275063,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 };`);
@@ -274770,7 +275110,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
       );
@@ -275953,9 +276293,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;
@@ -275967,8 +276308,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();
@@ -277771,6 +278156,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();
@@ -278431,6 +278830,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,