jsdoc-builder 0.0.5 → 0.0.6

package/dist/index.js

@@ -5,46 +5,48 @@ const ts = require("typescript");
 const fs = require("fs");
 /**
  * Parses a TypeScript or JavaScript file and adds JSDoc comments to functions.
+ * Skips functions that already have JSDoc comments.
  * @param filePath - The path of the file to process.
  */
 function generateJSDoc(filePath) {
     const sourceCode = fs.readFileSync(filePath, "utf-8");
     const sourceFile = ts.createSourceFile(filePath, sourceCode, ts.ScriptTarget.Latest, true);
     const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
-    // Visit function that processes each node
     function visit(node, context) {
-        if (ts.isFunctionDeclaration(node) && node.name) {
+        if (ts.isFunctionDeclaration(node) && node.name && !hasJSDoc(node)) {
             const jsDoc = createJSDoc(node.name.text, node.parameters, node.type);
             ts.addSyntheticLeadingComment(node, ts.SyntaxKind.MultiLineCommentTrivia, jsDoc.comment, true);
             return node;
         }
-        // Check for arrow functions assigned to a constant
         if (ts.isVariableDeclaration(node) &&
             node.initializer &&
-            ts.isArrowFunction(node.initializer)) {
+            ts.isArrowFunction(node.initializer) &&
+            !hasJSDoc(node.parent.parent) // VariableStatement에 JSDoc이 있는지 확인
+        ) {
             const jsDoc = createJSDoc(node.name.getText(), node.initializer.parameters, node.initializer.type);
-            // Add JSDoc to the entire variable statement for clarity
-            const parent = node.parent;
-            if (ts.isVariableDeclarationList(parent) &&
-                parent.declarations.length === 1) {
-                ts.addSyntheticLeadingComment(parent.parent, ts.SyntaxKind.MultiLineCommentTrivia, jsDoc.comment, true);
-            }
+            ts.addSyntheticLeadingComment(node.parent.parent, ts.SyntaxKind.MultiLineCommentTrivia, jsDoc.comment, true);
             return node;
         }
-        return ts.visitEachChild(node, (child) => visit(child, context), context); // Pass context to visit
+        return ts.visitEachChild(node, (child) => visit(child, context), context);
     }
-    // Create the transformer
     const transformer = (context) => {
         return (sourceFile) => {
-            return ts.visitNode(sourceFile, (node) => visit(node, context)); // Pass context to visit
+            return ts.visitNode(sourceFile, (node) => visit(node, context));
         };
     };
-    // Apply the transformer
     const result = ts.transform(sourceFile, [transformer]);
     const transformedSourceFile = result.transformed[0];
     const updatedCode = printer.printFile(transformedSourceFile);
     fs.writeFileSync(filePath, updatedCode, "utf-8");
 }
+/**
+ * Checks if a node already has JSDoc comments.
+ * @param node - The TypeScript AST node to check.
+ * @returns Whether the node has JSDoc.
+ */
+function hasJSDoc(node) {
+    return !!ts.getJSDocTags(node).length;
+}
 /**
  * Creates a JSDoc comment.
  * @param functionName - The name of the function.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsdoc-builder",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "author": "dori",
   "description": "Generate JSDoc comments for JavaScript and TypeScript files.",
   "publishConfig": {