@wc-toolkit/cem-generator-svelte 0.1.17 → 0.1.19

package/dist/index.js

@@ -1,5 +1,7 @@
 import path from "node:path";
+import ts from "typescript";
 import { parseCssMetadata, } from "@wc-toolkit/cem-generator";
+import { parseCemClassTags } from "@wc-toolkit/cem-generator-utils";
 /** Detects Svelte components compiled as custom elements. */
 export function sveltePlugin() {
     return {
@@ -38,6 +40,7 @@ export function sveltePlugin() {
                 cssParts: mergeNamed(discoverParts(source), metadata.cssParts),
                 cssProperties: mergeNamed(discoverCssProperties(source), metadata.cssProperties),
                 cssStates: metadata.cssStates,
+                customJsDocTags: metadata.customJsDocTags,
             };
             return { [fragment.name]: fragment };
         },
@@ -56,18 +59,23 @@ function getProps(source) {
     const props = [];
     const script = source.match(/<script\b[^>]*>([\s\S]*?)<\/script>/)?.[1] ?? "";
     const interfaces = new Map();
-    for (const match of script.matchAll(/(?:\/\*\*([\s\S]*?)\*\/\s*)?(\w+)\??\s*:\s*([^;\n,}]+)/g)) {
-        interfaces.set(match[2], { type: match[3].trim(), description: cleanComment(match[1]) });
+    for (const match of script.matchAll(/(?:\/\*\*((?:(?!\*\/)[\s\S])*)\*\/\s*)?(\w+)\??\s*:\s*([^;\n,}]+)/g)) {
+        interfaces.set(match[2], {
+            type: match[3].trim(),
+            description: getDescription(match[1]),
+            customJsDocTags: parseCustomJsDocTags(match[1]),
+        });
     }
-    for (const match of script.matchAll(/(?:\/\*\*([\s\S]*?)\*\/\s*)?export\s+let\s+(\w+)\s*(?::\s*([^=;]+))?\s*(?:=\s*([^;\n]+))?/g)) {
+    for (const match of script.matchAll(/(?:\/\*\*((?:(?!\*\/)[\s\S])*)\*\/\s*)?export\s+let\s+(\w+)\s*(?::\s*([^=;]+))?\s*(?:=\s*([^;\n]+))?/g)) {
         const [, comment, name, type, defaultValue] = match;
         props.push({
             name,
             kind: "field",
             type: type?.trim() ?? inferType(defaultValue),
-            description: cleanComment(comment),
+            description: getDescription(comment),
             default: defaultValue?.trim(),
             attribute: name.toLowerCase(),
+            customJsDocTags: parseCustomJsDocTags(comment),
         });
     }
     const runeProps = script.match(/\b(?:let|const)\s*\{([\s\S]*?)\}\s*(?::\s*(\w+))?\s*=\s*\$props\s*\(\s*\)/)?.[1];
@@ -83,6 +91,7 @@ function getProps(source) {
             description: info?.description,
             default: match[2]?.trim(),
             attribute: match[1].toLowerCase(),
+            customJsDocTags: info?.customJsDocTags,
         });
     }
     const options = source.match(/<svelte:options\b([\s\S]*?)\/>/)?.[1] ?? "";
@@ -108,8 +117,17 @@ function getComponentMetadata(source, tagName) {
         cssParts: parseNamedTags(comment, "csspart"),
         cssProperties: parseCssTags(comment),
         cssStates: parseNamedTags(comment, "cssState"),
+        customJsDocTags: parseCustomJsDocTags(comment),
     };
 }
+/** Reuses the shared JSDoc parser by wrapping a Svelte comment body as a JSDoc block. */
+function parseCustomJsDocTags(comment) {
+    if (!comment)
+        return undefined;
+    const sourceFile = ts.createSourceFile("comment.ts", `/**${comment}*/\nclass Doc {}`, ts.ScriptTarget.Latest, true);
+    const node = sourceFile.statements.find(ts.isClassDeclaration);
+    return node ? parseCemClassTags(node).customJsDocTags : undefined;
+}
 function discoverSlots(source) {
     return [...source.matchAll(/<slot(?:\s+name\s*=\s*["']([^"']+)["'])?[^>]*>/g)].map((match) => ({
         name: match[1] ?? "",
@@ -159,6 +177,9 @@ function parseCssTags(comment) {
 function getTagDescription(comment, tag) {
     return comment.match(new RegExp(`@${tag}\\s+([^\\n]*)`))?.[1]?.trim() || undefined;
 }
+function getDescription(comment) {
+    return cleanComment(comment?.replace(/(^|\s)@\w[\s\S]*/, "$1"));
+}
 function cleanComment(value) {
     if (!value)
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wc-toolkit/cem-generator-svelte",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Svelte detector plugin for generating Custom Elements Manifests.",
   "keywords": [
     "custom-elements",
@@ -30,8 +30,8 @@
   },
   "dependencies": {
     "typescript": "6.0.3",
-    "@wc-toolkit/cem-generator": "0.2.4",
-    "@wc-toolkit/cem-generator-utils": "0.1.6"
+    "@wc-toolkit/cem-generator": "0.2.5",
+    "@wc-toolkit/cem-generator-utils": "0.1.7"
   },
   "devDependencies": {
     "svelte": "^5.0.0"