@d-fischer/documen.ts 0.16.9 → 0.17.0

package/lib/generator/cli.js

@@ -1,15 +1,12 @@
 #!/usr/bin/env node
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const clime_1 = require("clime");
-const path_1 = tslib_1.__importDefault(require("path"));
+import { CLI, Shim } from 'clime';
+import path from 'path';
 // for dev with ts-node
 if (process.execArgv.some(s => s.includes('ts-node/register'))) {
-    clime_1.CLI.commandModuleExtension = '.ts';
+    CLI.commandModuleExtension = '.ts';
 }
-const cli = new clime_1.CLI('documen.ts', path_1.default.join(__dirname, 'commands'));
-const shim = new clime_1.Shim(cli);
+const cli = new CLI('documen.ts', path.join(__dirname, 'commands'));
+const shim = new Shim(cli);
 // eslint-disable-next-line no-console
 shim.execute(process.argv).catch(err => console.error(err));
 //# sourceMappingURL=cli.js.map

package/lib/generator/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/generator/cli.ts"],"names":[],"mappings":";;;;AAEA,iCAAkC;AAClC,wDAAwB;AAExB,uBAAuB;AACvB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,EAAE;IAC/D,WAAG,CAAC,sBAAsB,GAAG,KAAK,CAAC;CACnC;AAED,MAAM,GAAG,GAAG,IAAI,WAAG,CAAC,YAAY,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AACpE,MAAM,IAAI,GAAG,IAAI,YAAI,CAAC,GAAG,CAAC,CAAC;AAE3B,sCAAsC;AACtC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/generator/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,uBAAuB;AACvB,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;IAChE,GAAG,CAAC,sBAAsB,GAAG,KAAK,CAAC;AACpC,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AACpE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;AAE3B,sCAAsC;AACtC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/lib/generator/commands/default.js

@@ -1,307 +1,308 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLICommandOptions = void 0;
-const tslib_1 = require("tslib");
+import { __decorate, __metadata } from "tslib";
 /* eslint-disable no-console,max-classes-per-file */
-const clime_1 = require("clime");
-const fs_1 = tslib_1.__importStar(require("fs"));
-const path_1 = tslib_1.__importDefault(require("path"));
-const tmp_promise_1 = tslib_1.__importDefault(require("tmp-promise"));
-const Util_1 = require("../../common/config/Util");
-const FileTools_1 = require("../../common/tools/FileTools");
-const StringTools_1 = require("../../common/tools/StringTools");
-const HtmlGenerator_1 = tslib_1.__importDefault(require("../modes/HtmlGenerator"));
-const MonorepoGenerator_1 = tslib_1.__importDefault(require("../modes/MonorepoGenerator"));
-// eslint-disable-next-line @typescript-eslint/naming-convention
-class CLICommandOptions extends clime_1.Options {
+import { Command, command, ExpectedError, metadata, option, Options } from 'clime';
+import fs, { promises as fsp } from 'fs';
+import path from 'path';
+import tmp from 'tmp-promise';
+import { getConfigValue } from '../../common/config/Util.js';
+import { fileExists } from '../../common/tools/FileTools.js';
+import { removeSlash } from '../../common/tools/StringTools.js';
+import HtmlGenerator from '../modes/HtmlGenerator.js';
+import MonorepoGenerator from '../modes/MonorepoGenerator.js';
+export class CLICommandOptions extends Options {
+    dev;
+    prettier;
+    baseDir;
+    configDir;
+    outDir;
+    routerMode;
+    baseUrl;
+    mono;
+    repoUser;
+    repoName;
+    repoBranch;
+    indexFile;
+    indexTitle;
 }
-tslib_1.__decorate([
-    (0, clime_1.option)({ description: 'development mode; disable some optimizations in favor of speed' }),
-    tslib_1.__metadata("design:type", Boolean)
+__decorate([
+    option({ description: 'development mode; disable some optimizations in favor of speed' }),
+    __metadata("design:type", Boolean)
 ], CLICommandOptions.prototype, "dev", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ description: 'use prettier on all HTML files; defaults to value of dev flag' }),
-    tslib_1.__metadata("design:type", Boolean)
+__decorate([
+    option({ description: 'use prettier on all HTML files; defaults to value of dev flag' }),
+    __metadata("design:type", Boolean)
 ], CLICommandOptions.prototype, "prettier", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ description: 'base directory' }),
-    tslib_1.__metadata("design:type", String)
+__decorate([
+    option({ description: 'base directory' }),
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "baseDir", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({
+__decorate([
+    option({
         flag: 'd',
         description: 'configuration directory',
-        validator: (value) => fs_1.default.existsSync(path_1.default.resolve(process.cwd(), value))
+        validator: (value) => fs.existsSync(path.resolve(process.cwd(), value))
     }),
-    tslib_1.__metadata("design:type", String)
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "configDir", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ flag: 'o', description: 'output directory' }),
-    tslib_1.__metadata("design:type", String)
+__decorate([
+    option({ flag: 'o', description: 'output directory' }),
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "outDir", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({
+__decorate([
+    option({
         flag: 'r',
         description: 'render mode',
         default: 'htmlSuffix',
         validator: value => ['htmlSuffix', 'subDirectories', 'htaccess'].includes(value)
     }),
-    tslib_1.__metadata("design:type", String)
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "routerMode", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ flag: 'b', description: 'base URL', default: '' }),
-    tslib_1.__metadata("design:type", String)
+__decorate([
+    option({ flag: 'b', description: 'base URL', default: '' }),
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "baseUrl", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ description: 'set monorepo package root', default: '' }),
-    tslib_1.__metadata("design:type", String)
+__decorate([
+    option({ description: 'set monorepo package root', default: '' }),
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "mono", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ description: 'repo user name', default: '' }),
-    tslib_1.__metadata("design:type", String)
+__decorate([
+    option({ description: 'repo user name', default: '' }),
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "repoUser", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ description: 'repo name', default: '' }),
-    tslib_1.__metadata("design:type", String)
+__decorate([
+    option({ description: 'repo name', default: '' }),
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "repoName", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ description: 'git branch' }),
-    tslib_1.__metadata("design:type", String)
+__decorate([
+    option({ description: 'git branch' }),
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "repoBranch", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ description: 'index file' }),
-    tslib_1.__metadata("design:type", String)
+__decorate([
+    option({ description: 'index file' }),
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "indexFile", void 0);
-tslib_1.__decorate([
-    (0, clime_1.option)({ description: 'index title' }),
-    tslib_1.__metadata("design:type", String)
+__decorate([
+    option({ description: 'index title' }),
+    __metadata("design:type", String)
 ], CLICommandOptions.prototype, "indexTitle", void 0);
-exports.CLICommandOptions = CLICommandOptions;
-let CLICommand = 
-// eslint-disable-next-line @typescript-eslint/naming-convention
-class CLICommand extends clime_1.Command {
-    execute(options) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            process.env.NODE_ENV = 'production';
-            const baseDir = options.baseDir || process.cwd();
-            let configDir = null;
-            if (options.configDir) {
-                // check already made in validator
-                configDir = path_1.default.resolve(baseDir, options.configDir);
+let CLICommand = class CLICommand extends Command {
+    async execute(options) {
+        process.env.NODE_ENV = 'production';
+        const baseDir = options.baseDir || process.cwd();
+        let configDir = null;
+        if (options.configDir) {
+            // check already made in validator
+            configDir = path.resolve(baseDir, options.configDir);
+        }
+        else {
+            const defaultConfigDir = path.resolve(baseDir, 'docs');
+            if (await fileExists(defaultConfigDir)) {
+                configDir = defaultConfigDir;
             }
-            else {
-                const defaultConfigDir = path_1.default.resolve(baseDir, 'docs');
-                if (yield (0, FileTools_1.fileExists)(defaultConfigDir)) {
-                    configDir = defaultConfigDir;
-                }
+        }
+        let importedConfig = null;
+        let indexFile = null;
+        if (configDir) {
+            const configFile = path.join(configDir, 'config.json');
+            if (!(await fileExists(configFile))) {
+                throw new ExpectedError('configuration directory was found but there is no config.json file in it');
             }
-            let importedConfig = null;
-            let indexFile = null;
-            if (configDir) {
-                const configFile = path_1.default.join(configDir, 'config.json');
-                if (!(yield (0, FileTools_1.fileExists)(configFile))) {
-                    throw new clime_1.ExpectedError('configuration directory was found but there is no config.json file in it');
-                }
-                try {
-                    const fileContents = yield fs_1.promises.readFile(configFile, 'utf-8');
-                    importedConfig = JSON.parse(fileContents);
-                }
-                catch (e) {
-                    throw new clime_1.ExpectedError(`error reading ${configFile} as JSON: ${e.message}`);
-                }
-                indexFile = options.indexFile || (0, Util_1.getConfigValue)(importedConfig, 'indexFile');
-                if (indexFile) {
-                    indexFile = path_1.default.join(configDir, indexFile);
-                    if (!(yield (0, FileTools_1.fileExists)(indexFile))) {
-                        throw new clime_1.ExpectedError('given index file does not exist in configuration directory');
-                    }
-                }
+            try {
+                const fileContents = await fsp.readFile(configFile, 'utf-8');
+                importedConfig = JSON.parse(fileContents);
             }
-            if (!indexFile) {
-                indexFile = path_1.default.join(baseDir, 'README.md');
-                if (!(yield (0, FileTools_1.fileExists)(indexFile))) {
-                    throw new clime_1.ExpectedError('there was neither a given index file nor a README.md in the root of the project');
-                }
+            catch (e) {
+                throw new ExpectedError(`error reading ${configFile} as JSON: ${e.message}`);
             }
-            const monorepoRoot = (_a = (options.mono || (0, Util_1.getConfigValue)(importedConfig, 'monorepoRoot'))) !== null && _a !== void 0 ? _a : undefined;
-            const ignoredPackages = (_b = (0, Util_1.getConfigValue)(importedConfig, 'ignoredPackages')) !== null && _b !== void 0 ? _b : undefined;
-            const packageDirNames = monorepoRoot ? yield fs_1.promises.readdir(path_1.default.join(baseDir, monorepoRoot)) : null;
-            let needsManifest = false;
-            let versionAware = false;
-            const rootOutputDir = options.outDir || (0, Util_1.getConfigValue)(importedConfig, 'outputDir', true);
-            const mainBranchName = (_c = (0, Util_1.getConfigValue)(importedConfig, 'mainBranchName')) !== null && _c !== void 0 ? _c : 'master';
-            const versionBranchPrefix = (_d = (0, Util_1.getConfigValue)(importedConfig, 'versionBranchPrefix')) !== null && _d !== void 0 ? _d : undefined;
-            const versionFolder = (_e = (0, Util_1.getConfigValue)(importedConfig, 'versionFolder')) !== null && _e !== void 0 ? _e : undefined;
-            const defaultVersion = (_f = (0, Util_1.getConfigValue)(importedConfig, 'defaultVersion')) !== null && _f !== void 0 ? _f : mainBranchName;
-            let outputDir = rootOutputDir;
-            let version = undefined;
-            const rootUrl = (0, StringTools_1.removeSlash)(options.baseUrl || (0, Util_1.getConfigValue)(importedConfig, 'baseUrl', true) || '/');
-            let baseUrl = rootUrl;
-            if (versionBranchPrefix && versionFolder) {
-                if (!options.repoBranch) {
-                    console.error('This project is version aware; please supply the branch name using the CLI option `--repo-branch`.');
-                    process.exit(1);
-                }
-                if (options.repoBranch.startsWith(versionBranchPrefix)) {
-                    version = options.repoBranch.substr(versionBranchPrefix.length);
+            indexFile = options.indexFile || getConfigValue(importedConfig, 'indexFile');
+            if (indexFile) {
+                indexFile = path.join(configDir, indexFile);
+                if (!(await fileExists(indexFile))) {
+                    throw new ExpectedError('given index file does not exist in configuration directory');
                 }
-                else if (options.repoBranch === mainBranchName) {
-                    version = mainBranchName;
-                }
-                else {
-                    console.error(`This project is version aware and can only build docs for the branch "${mainBranchName}" and branches starting with "${versionBranchPrefix}."`);
-                    process.exit(1);
-                }
-                if (version !== defaultVersion) {
-                    outputDir = path_1.default.join(rootOutputDir, versionFolder, version);
-                    baseUrl = path_1.default.posix.join(baseUrl, versionFolder, version);
-                }
-                needsManifest = true;
-                versionAware = true;
             }
-            else if (versionBranchPrefix || versionFolder) {
-                console.error('Please either specify both the "versionBranchPrefix" and "versionFolder" options, or neither. Specifying only one of them is not supported.');
+        }
+        if (!indexFile) {
+            indexFile = path.join(baseDir, 'README.md');
+            if (!(await fileExists(indexFile))) {
+                throw new ExpectedError('there was neither a given index file nor a README.md in the root of the project');
+            }
+        }
+        const monorepoRoot = (options.mono || getConfigValue(importedConfig, 'monorepoRoot')) ?? undefined;
+        const ignoredPackages = getConfigValue(importedConfig, 'ignoredPackages') ?? undefined;
+        const packageDirNames = monorepoRoot ? await fsp.readdir(path.join(baseDir, monorepoRoot)) : null;
+        let needsManifest = false;
+        let versionAware = false;
+        const rootOutputDir = options.outDir || getConfigValue(importedConfig, 'outputDir', true);
+        const mainBranchName = getConfigValue(importedConfig, 'mainBranchName') ?? 'master';
+        const versionBranchPrefix = getConfigValue(importedConfig, 'versionBranchPrefix') ?? undefined;
+        const versionFolder = getConfigValue(importedConfig, 'versionFolder') ?? undefined;
+        const defaultVersion = getConfigValue(importedConfig, 'defaultVersion') ?? mainBranchName;
+        let outputDir = rootOutputDir;
+        let version = undefined;
+        const rootUrl = removeSlash(options.baseUrl || getConfigValue(importedConfig, 'baseUrl', true) || '/');
+        let baseUrl = rootUrl;
+        if (versionBranchPrefix && versionFolder) {
+            if (!options.repoBranch) {
+                console.error('This project is version aware; please supply the branch name using the CLI option `--repo-branch`.');
                 process.exit(1);
             }
-            const categories = (_g = (0, Util_1.getConfigValue)(importedConfig, 'categories')) === null || _g === void 0 ? void 0 : _g.filter(cat => {
-                if (cat.indexFile) {
-                    return true;
-                }
-                console.warn(`Expected indexFile property for category ${cat.name}`);
-                return false;
-            });
-            const generatorConfig = {
-                dev: (_h = options.dev) !== null && _h !== void 0 ? _h : false,
-                prettier: (_l = (_k = (_j = (0, Util_1.getConfigValue)(importedConfig, 'prettier')) !== null && _j !== void 0 ? _j : options.prettier) !== null && _k !== void 0 ? _k : options.dev) !== null && _l !== void 0 ? _l : false,
-                configDir,
-                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-                routerMode: options.routerMode || (0, Util_1.getConfigValue)(importedConfig, 'routerMode') || 'htmlSuffix',
-                outputDir,
-                baseUrl,
-                baseDir,
-                packageScope: (_o = (_m = (0, Util_1.getConfigValue)(importedConfig, 'packageScope')) === null || _m === void 0 ? void 0 : _m.replace(/^@/, '')) !== null && _o !== void 0 ? _o : undefined,
-                monorepoRoot,
-                packageDirNames,
-                mainPackage: (_p = (0, Util_1.getConfigValue)(importedConfig, 'mainPackage')) !== null && _p !== void 0 ? _p : undefined,
-                mainBranchName,
-                versionBranchPrefix,
-                versionFolder,
-                version,
-                defaultVersion,
-                ignoredPackages,
-                title: (0, Util_1.getConfigValue)(importedConfig, 'title'),
-                repoUser: options.repoUser || (0, Util_1.getConfigValue)(importedConfig, 'repoUser'),
-                repoName: options.repoName || (0, Util_1.getConfigValue)(importedConfig, 'repoName'),
-                repoBaseFolder: (0, Util_1.getConfigValue)(importedConfig, 'repoBaseFolder'),
-                repoBranch: options.repoBranch || mainBranchName,
-                indexTitle: (_q = (options.indexTitle || (0, Util_1.getConfigValue)(importedConfig, 'indexTitle'))) !== null && _q !== void 0 ? _q : 'Welcome',
-                indexFile,
-                categories: categories !== null && categories !== void 0 ? categories : undefined,
-                referenceConfig: (_r = (0, Util_1.getConfigValue)(importedConfig, 'referenceConfig')) !== null && _r !== void 0 ? _r : undefined,
-                shouldEnhance: true
-            };
-            const generator = this._getGeneratorForConfig(generatorConfig);
-            if (versionAware) {
-                console.log(`Cleaning up generated files for ${version === mainBranchName ? `branch ${mainBranchName}` : `version ${version}`}`);
-                if (version === defaultVersion) {
-                    const [versionsRoot] = versionFolder.split('/');
-                    const rootFolderContents = yield fs_1.promises.readdir(rootOutputDir);
-                    const ignoredFiles = [
-                        versionsRoot,
-                        'manifest.json',
-                        ...((_s = (0, Util_1.getConfigValue)(importedConfig, 'persistentFiles')) !== null && _s !== void 0 ? _s : [])
-                    ];
-                    yield Promise.all(rootFolderContents
-                        .filter(f => !f.startsWith('.') && !ignoredFiles.includes(f))
-                        .map((f) => tslib_1.__awaiter(this, void 0, void 0, function* () {
-                        const filePath = path_1.default.join(rootOutputDir, f);
-                        if ((yield fs_1.promises.lstat(filePath)).isDirectory()) {
-                            yield fs_1.promises.rm(filePath, { recursive: true });
-                        }
-                        else {
-                            yield fs_1.promises.unlink(filePath);
-                        }
-                    })));
-                }
-                else {
-                    yield fs_1.promises.rm(outputDir, { force: true, recursive: true });
-                    yield fs_1.promises.mkdir(outputDir, { recursive: true });
-                }
+            if (options.repoBranch.startsWith(versionBranchPrefix)) {
+                version = options.repoBranch.substr(versionBranchPrefix.length);
+            }
+            else if (options.repoBranch === mainBranchName) {
+                version = mainBranchName;
             }
             else {
-                console.log('Cleaning up generated files');
-                yield fs_1.promises.rm(outputDir, { force: true, recursive: true });
-                yield fs_1.promises.mkdir(outputDir, { recursive: true });
+                console.error(`This project is version aware and can only build docs for the branch "${mainBranchName}" and branches starting with "${versionBranchPrefix}."`);
+                process.exit(1);
             }
-            const reference = yield generator.createReferenceStructure();
-            if (process.env.DOCTS_WRITE_JSON) {
-                const jsonPath = path_1.default.join(baseDir, outputDir, 'data.json');
-                const json = JSON.stringify(reference, null, 2);
-                console.log(`Writing raw data to ${jsonPath}`);
-                yield fs_1.promises.writeFile(jsonPath, json);
-                if (process.env.DOCTS_WRITE_JSON === 'only') {
-                    return;
-                }
+            if (version !== defaultVersion) {
+                outputDir = path.join(rootOutputDir, versionFolder, version);
+                baseUrl = path.posix.join(baseUrl, versionFolder, version);
             }
-            const tmpResult = yield tmp_promise_1.default.dir({ unsafeCleanup: true });
-            const paths = {
-                projectBase: baseDir,
-                tmpDir: tmpResult.path,
-                rootUrl
-            };
-            try {
-                yield generator.generate(reference, paths);
+            needsManifest = true;
+            versionAware = true;
+            // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+        }
+        else if (versionBranchPrefix || versionFolder) {
+            console.error('Please either specify both the "versionBranchPrefix" and "versionFolder" options, or neither. Specifying only one of them is not supported.');
+            process.exit(1);
+        }
+        const categories = getConfigValue(importedConfig, 'categories')?.filter(cat => {
+            if (cat.indexFile) {
+                return true;
             }
-            catch (e) {
-                process.stderr.write('\nerror building the documentation:\n');
-                console.error(e);
-                process.exit(1);
+            console.warn(`Expected indexFile property for category ${cat.name}`);
+            return false;
+        });
+        const generatorConfig = {
+            dev: options.dev ?? false,
+            prettier: getConfigValue(importedConfig, 'prettier') ?? options.prettier ?? options.dev ?? false,
+            configDir,
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            routerMode: options.routerMode || getConfigValue(importedConfig, 'routerMode') || 'htmlSuffix',
+            outputDir,
+            baseUrl,
+            baseDir,
+            packageScope: getConfigValue(importedConfig, 'packageScope')?.replace(/^@/, '') ?? undefined,
+            monorepoRoot,
+            packageDirNames,
+            mainPackage: getConfigValue(importedConfig, 'mainPackage') ?? undefined,
+            mainBranchName,
+            versionBranchPrefix,
+            versionFolder,
+            version,
+            defaultVersion,
+            ignoredPackages,
+            title: getConfigValue(importedConfig, 'title'),
+            repoUser: options.repoUser || getConfigValue(importedConfig, 'repoUser'),
+            repoName: options.repoName || getConfigValue(importedConfig, 'repoName'),
+            repoBaseFolder: getConfigValue(importedConfig, 'repoBaseFolder'),
+            repoBranch: options.repoBranch || mainBranchName,
+            indexTitle: (options.indexTitle || getConfigValue(importedConfig, 'indexTitle')) ?? 'Welcome',
+            indexFile,
+            categories: categories ?? undefined,
+            referenceConfig: getConfigValue(importedConfig, 'referenceConfig') ?? undefined,
+            shouldEnhance: true
+        };
+        const generator = this._getGeneratorForConfig(generatorConfig);
+        if (versionAware) {
+            console.log(`Cleaning up generated files for ${version === mainBranchName ? `branch ${mainBranchName}` : `version ${version}`}`);
+            if (version === defaultVersion) {
+                const [versionsRoot] = versionFolder.split('/');
+                const rootFolderContents = await fsp.readdir(rootOutputDir);
+                const ignoredFiles = [
+                    versionsRoot,
+                    'manifest.json',
+                    ...(getConfigValue(importedConfig, 'persistentFiles') ?? [])
+                ];
+                await Promise.all(rootFolderContents
+                    .filter(f => !f.startsWith('.') && !ignoredFiles.includes(f))
+                    .map(async (f) => {
+                    const filePath = path.join(rootOutputDir, f);
+                    if ((await fsp.lstat(filePath)).isDirectory()) {
+                        await fsp.rm(filePath, { recursive: true });
+                    }
+                    else {
+                        await fsp.unlink(filePath);
+                    }
+                }));
             }
-            finally {
-                yield tmpResult.cleanup();
+            else {
+                await fsp.rm(outputDir, { force: true, recursive: true });
+                await fsp.mkdir(outputDir, { recursive: true });
             }
-            if (needsManifest) {
-                const manifestPath = path_1.default.join(baseDir, rootOutputDir, 'manifest.json');
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                let manifest = {};
-                try {
-                    const manifestJson = yield fs_1.promises.readFile(manifestPath, 'utf-8');
-                    console.log(`Read existing manifest from ${manifestPath}`);
-                    manifest = JSON.parse(manifestJson);
-                }
-                catch (_u) {
-                    console.log(`Manifest not found, creating new one at ${manifestPath}`);
-                }
-                const versionsSet = new Set((_t = manifest.versions) !== null && _t !== void 0 ? _t : []);
-                if (version) {
-                    versionsSet.add(version);
-                }
-                // eslint-disable-next-line @typescript-eslint/require-array-sort-compare
-                manifest.versions = [...versionsSet].sort();
-                manifest.defaultVersion = defaultVersion;
-                manifest.rootUrl = rootUrl;
-                console.log(`Writing manifest to ${manifestPath}`);
-                yield fs_1.promises.writeFile(manifestPath, JSON.stringify(manifest, null, 2));
+        }
+        else {
+            console.log('Cleaning up generated files');
+            await fsp.rm(outputDir, { force: true, recursive: true });
+            await fsp.mkdir(outputDir, { recursive: true });
+        }
+        const reference = await generator.createReferenceStructure();
+        if (process.env.DOCTS_WRITE_JSON) {
+            const jsonPath = path.join(baseDir, outputDir, 'data.json');
+            const json = JSON.stringify(reference, null, 2);
+            console.log(`Writing raw data to ${jsonPath}`);
+            await fsp.writeFile(jsonPath, json);
+            if (process.env.DOCTS_WRITE_JSON === 'only') {
+                return;
             }
-        });
+        }
+        const tmpResult = await tmp.dir({ unsafeCleanup: true });
+        const paths = {
+            projectBase: baseDir,
+            tmpDir: tmpResult.path,
+            rootUrl
+        };
+        try {
+            await generator.generate(reference, paths);
+        }
+        catch (e) {
+            process.stderr.write('\nerror building the documentation:\n');
+            console.error(e);
+            process.exit(1);
+        }
+        finally {
+            await tmpResult.cleanup();
+        }
+        if (needsManifest) {
+            const manifestPath = path.join(baseDir, rootOutputDir, 'manifest.json');
+            let manifest = {};
+            try {
+                const manifestJson = await fsp.readFile(manifestPath, 'utf-8');
+                console.log(`Read existing manifest from ${manifestPath}`);
+                manifest = JSON.parse(manifestJson);
+            }
+            catch {
+                console.log(`Manifest not found, creating new one at ${manifestPath}`);
+            }
+            const versionsSet = new Set(manifest.versions ?? []);
+            if (version) {
+                versionsSet.add(version);
+            }
+            manifest.versions = [...versionsSet].sort();
+            manifest.defaultVersion = defaultVersion;
+            manifest.rootUrl = rootUrl;
+            console.log(`Writing manifest to ${manifestPath}`);
+            await fsp.writeFile(manifestPath, JSON.stringify(manifest, null, 2));
+        }
     }
     _getGeneratorForConfig(config) {
         if (config.monorepoRoot) {
-            return new MonorepoGenerator_1.default(config);
+            return new MonorepoGenerator(config);
         }
-        return new HtmlGenerator_1.default(config);
+        return new HtmlGenerator(config);
     }
 };
-tslib_1.__decorate([
-    clime_1.metadata,
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [CLICommandOptions]),
-    tslib_1.__metadata("design:returntype", Promise)
+__decorate([
+    metadata,
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [CLICommandOptions]),
+    __metadata("design:returntype", Promise)
 ], CLICommand.prototype, "execute", null);
-CLICommand = tslib_1.__decorate([
-    (0, clime_1.command)()
-    // eslint-disable-next-line @typescript-eslint/naming-convention
+CLICommand = __decorate([
+    command()
 ], CLICommand);
-exports.default = CLICommand;
+export default CLICommand;
 //# sourceMappingURL=default.js.map