JSDoc Builder

JSDoc Builder is a CLI tool for automatically generating JSDoc comments for JavaScript and TypeScript files. It parses functions and variables to infer parameter types, return types, and descriptions, and then inserts JSDoc comments directly into the source code.

Features

• Automatically generates JSDoc comments for:
  • Function declarations
  • Arrow functions
  • TypeScript types and interfaces
• Infers parameter and return types from TypeScript annotations.
• Outputs clean and structured JSDoc comments.

Installation

Install the library globally or locally via npm:

npm install jsdoc-builder -g

or

npm install jsdoc-builder --save-dev

Usage

CLI Command

Run the following command to generate JSDoc comments for a file:

jsdoc-builder <file-path>

Replace <file-path> with the path to the JavaScript or TypeScript file you want to process.

Example

Input File (example.ts):

function add(a: number, b: number) {
  return a + b;
}

const multiply = (a: number, b: number): number => {
  return a * b;
};

Command:

jsdoc-builder example.ts

Output File (example.ts):

/**
 * @description Press Your { Function add } Description
 * @param {number} a
 * @param {number} b
 * @returns {void}
 */
function add(a: number, b: number) {
  return a + b;
}

/**
 * @description Press Your { Function multiply } Description
 * @param {number} a
 * @param {number} b
 * @returns {number}
 */
const multiply = (a: number, b: number): number => {
  return a * b;
};

API

generateJSDoc(filePath: string): void

• Description: Processes the specified file to add JSDoc comments.
• Parameters:
  • filePath (string): The path to the file to be processed.
• Returns: void

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch: git checkout -b feature-name.
3. Commit your changes: git commit -m 'Add feature-name'.
4. Push to the branch: git push origin feature-name.
5. Submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.