vitepress-jsdoc/dist/commonjs/classes/file-watcher.js

A bridge between Vitepress and JSDoc-style commented codebases for hassle-free documentation.

"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const node_readline_1 = __importDefault(require("node:readline"));
const chokidar_1 = __importDefault(require("chokidar"));
const file_js_1 = require("../parsers/file.js");
const plugin_options_js_1 = require("../parsers/plugin-options.js");
const file_operations_js_1 = require("../utilities/file-operations.js");
const create_readme_js_1 = require("../utilities/create-readme.js");
const directory_tree_builder_js_1 = require("./directory-tree-builder.js");
/**
 * The `FileWatcher` class provides functionalities to monitor files and directories
 * for changes. It leverages the `chokidar` library to efficiently watch files and
 * react to changes by updating the documentation accordingly.
 */
class FileWatcher {
    options;
    parsedArgs;
    /**
     * Initializes a new instance of the FileWatcher class.
     *
     * @param {PluginOptions} options - Configuration options and plugin options.
     */
    constructor(options) {
        this.options = options;
        this.options = options;
        this.parsedArgs = (0, plugin_options_js_1.parsePluginOptions)(options);
    }
    /**
     * Starts the file watching process if the "watch" argument is provided.
     * Outputs a message to the console indicating the start of the watching process.
     */
    watch() {
        if (!this.options.watch)
            return;
        console.log('\n---\n\n👀 watching files...');
        const watcher = this.setupFileWatcher();
        watcher.on('change', async (path) => {
            await this.handleFileChange(path);
        });
    }
    /**
     * Configures and returns a file watcher instance targeting the source folder
     * and README files.
     *
     * @returns {chokidar.FSWatcher} An instance of the file watcher.
     */
    setupFileWatcher() {
        const { srcFolder } = this.parsedArgs;
        return chokidar_1.default.watch([srcFolder, this.options.readme, `${srcFolder}/README.md`].filter(Boolean), {
            ignored: /(^|[/\\])\../,
            persistent: true,
        });
    }
    /**
     * Handles events when a file changes. It updates the documentation and
     * outputs relevant messages to the console.
     *
     * @param {string} path - The path of the file that changed.
     */
    async handleFileChange(path) {
        const { srcFolder, include, exclude } = this.parsedArgs;
        const directoryTree = new directory_tree_builder_js_1.DirectoryTreeBuilder({
            srcPath: srcFolder,
            include,
            exclude,
        });
        const lsFolder = await directoryTree.build();
        const file = lsFolder.paths.find((p) => p.path === path);
        await this.clearConsole();
        if (this.isReadmeFile(path, srcFolder)) {
            await (0, create_readme_js_1.createReadmeFile)(this.options);
        }
        if (file) {
            console.log(`update ${file.name + file.ext}`);
            await this.updateDocumentationFile(file);
        }
    }
    /**
     * Clears the console to provide a clean output for subsequent messages.
     */
    async clearConsole() {
        node_readline_1.default.clearLine(process.stdout, 0);
        node_readline_1.default.cursorTo(process.stdout, 0);
    }
    /**
     * Determines if the specified file is a README file.
     *
     * @param {string} path - The path of the file to check.
     * @param {string} srcFolder - The source directory path.
     * @returns {boolean} True if the file is a README file, otherwise false.
     */
    isReadmeFile(path, srcFolder) {
        return path === 'README.md' || path === `${srcFolder}/README.md`;
    }
    /**
     * Processes and updates the documentation for the specified file.
     *
     * @param {DirectoryFile} file - Details of the file to update.
     */
    async updateDocumentationFile(file) {
        const data = await (0, file_js_1.parseDirectoryFile)(file, this.options);
        if (data) {
            await (0, file_operations_js_1.writeContentToFile)(data, data.relativePathDest);
        }
    }
}
exports.default = FileWatcher;
//# sourceMappingURL=file-watcher.js.map