tobspr_shapez.io/gulp/docs.js

import path from "path/posix";
import fs from "fs";

import gulpRename from "gulp-rename";
import stripJsonComments from "strip-json-comments";

export default function gulptasksDocs(gulp, buildFolder) {
    gulp.task("docs.convertJsToTs", () => {
        return gulp
            .src(path.join("..", "src", "js", "**", "*.js"))
            .pipe(
                gulpRename(path => {
                    path.extname = ".ts";
                })
            )
            .pipe(gulp.dest(path.join("..", "tsc_temp")));
    });

    gulp.task("docs.copyTsconfigForHints", cb => {
        const src = fs.readFileSync(path.join("..", "src", "js", "tsconfig.json")).toString();
        const baseConfig = JSON.parse(stripJsonComments(src));

        baseConfig.allowJs = false;
        baseConfig.checkJs = false;
        baseConfig.declaration = true;
        baseConfig.noEmit = false;
        baseConfig.strict = false;
        baseConfig.strictFunctionTypes = false;
        baseConfig.strictBindCallApply = false;
        baseConfig.alwaysStrict = false;
        baseConfig.composite = true;
        baseConfig.outFile = "bundled-ts.js";
        fs.writeFileSync(path.join("..", "tsc_temp", "tsconfig.json"), JSON.stringify(baseConfig));
        cb();
    });

    gulp.task("main.prepareDocs", gulp.series("docs.convertJsToTs", "docs.copyTsconfigForHints"));
}