@elenajs/plugin-cem-tag 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ariel Salminen https://arielsalminen.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@elenajs/plugin-cem-tag",
+  "version": "0.0.2",
+  "description": "CEM analyzer plugin that copies custom JSDoc tags into the manifest.",
+  "author": "Elena <hi@elenajs.com>",
+  "homepage": "https://elenajs.com/",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src"
+  ],
+  "engines": {
+    "node": ">= 22"
+  },
+  "peerDependencies": {
+    "@custom-elements-manifest/analyzer": ">=0.10.0"
+  },
+  "gitHead": "0dc35402bc75dbe3bb71732f970548ca73e3cd1b"
+}

package/src/index.js

@@ -0,0 +1,54 @@
+/**
+ * Returns the CEM class declaration and resolved tag name for a class node,
+ * or `undefined` if the node is not a registered custom element.
+ *
+ * @param {Partial<import("@custom-elements-manifest/analyzer").JavaScriptModule>} moduleDoc
+ * @param {import("typescript").ClassDeclaration} node
+ * @returns {{ class: import("@custom-elements-manifest/analyzer").Declaration; tagName: string } | undefined}
+ */
+function getElenaElementDetails(moduleDoc, node) {
+  const declaration = moduleDoc.declarations?.find(d => d.name === node.name?.getText());
+  if (!declaration) {
+    return undefined;
+  }
+
+  const customElement = moduleDoc.exports?.find(
+    e => e.kind === "js" && e.declaration.name === declaration.name
+  );
+
+  if (!customElement) {
+    return undefined;
+  }
+
+  return { class: declaration, tagName: customElement.name };
+}
+
+/**
+ * CEM analyzer plugin that reads a non-standard JSDoc tag from each custom element class
+ * and writes its value onto the CEM class declaration under the same key.
+ *
+ * Used for Elena-specific tags like `@status` and `@displayName`.
+ *
+ * @see https://custom-elements-manifest.open-wc.org/analyzer/plugins/authoring/#example-plugin
+ * @param {string} tagName - The JSDoc tag name to extract (e.g. `"status"`, `"displayName"`).
+ * @returns {import("@custom-elements-manifest/analyzer").Plugin}
+ */
+export function elenaTagPlugin(tagName) {
+  return {
+    name: `${tagName}-tag`,
+
+    analyzePhase({ ts, node, moduleDoc }) {
+      if (!ts.isClassDeclaration(node)) {
+        return;
+      }
+
+      const details = getElenaElementDetails(moduleDoc, node);
+      if (!details) {
+        return;
+      }
+
+      const [tag] = ts.getAllJSDocTags(node, t => t.tagName.getText() === tagName);
+      details.class[tagName] = tag && ts.getTextOfJSDocComment(tag.comment);
+    },
+  };
+}