@elenajs/plugin-cem-define 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-define",
+  "version": "0.0.2",
+  "description": "CEM analyzer plugin that extracts tagName from Elena() mixin calls.",
+  "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,93 @@
+/**
+ * CEM analyzer plugin that reads `tagName` from the options object passed to
+ * `Elena(superClass, { tagName: "...", ... })` and registers the element in the manifest.
+ *
+ * Supports both inline objects and variable references:
+ * - `Elena(HTMLElement, { tagName: "elena-button", ... })`
+ * - `const options = { tagName: "elena-button", ... }; Elena(HTMLElement, options)`
+ *
+ * @returns {import("@custom-elements-manifest/analyzer").Plugin}
+ */
+export function elenaDefinePlugin() {
+  /** @type {Map<string, string>} variable name → tag name */
+  const optionsMap = new Map();
+
+  return {
+    name: "define-element",
+
+    analyzePhase({ ts, node, moduleDoc }) {
+      // Collect variable declarations: const options = { tagName: "...", ... }
+      if (
+        ts.isVariableDeclaration(node) &&
+        node.initializer &&
+        ts.isObjectLiteralExpression(node.initializer)
+      ) {
+        const varName = node.name.getText();
+        const tagNameProp = node.initializer.properties.find(
+          p => ts.isPropertyAssignment(p) && p.name.getText() === "tagName"
+        );
+        if (tagNameProp && ts.isStringLiteral(tagNameProp.initializer)) {
+          optionsMap.set(varName, tagNameProp.initializer.text);
+        }
+        return;
+      }
+
+      if (!ts.isClassDeclaration(node)) {
+        return;
+      }
+
+      const className = node.name?.getText();
+      if (!className) {
+        return;
+      }
+
+      const heritageClause = node.heritageClauses?.[0];
+      if (!heritageClause) {
+        return;
+      }
+
+      for (const type of heritageClause.types) {
+        const expr = type.expression;
+        if (!ts.isCallExpression(expr) || expr.expression.getText() !== "Elena") {
+          continue;
+        }
+
+        const optionsArg = expr.arguments[1];
+        if (!optionsArg) {
+          continue;
+        }
+
+        let tagName;
+
+        if (ts.isObjectLiteralExpression(optionsArg)) {
+          // Inline: Elena(HTMLElement, { tagName: "...", ... })
+          const tagNameProp = optionsArg.properties.find(
+            p => ts.isPropertyAssignment(p) && p.name.getText() === "tagName"
+          );
+          if (tagNameProp && ts.isStringLiteral(tagNameProp.initializer)) {
+            tagName = tagNameProp.initializer.text;
+          }
+        } else if (ts.isIdentifier(optionsArg)) {
+          // Variable reference: Elena(HTMLElement, options)
+          tagName = optionsMap.get(optionsArg.getText());
+        }
+
+        if (!tagName) {
+          continue;
+        }
+
+        const declaration = moduleDoc.declarations?.find(d => d.name === className);
+        if (declaration) {
+          declaration.tagName = tagName;
+        }
+
+        moduleDoc.exports ??= [];
+        moduleDoc.exports.push({
+          kind: "custom-element-definition",
+          name: tagName,
+          declaration: { name: className, module: moduleDoc.path },
+        });
+      }
+    },
+  };
+}