typedoc.config.cjs

// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)
// SPDX-License-Identifier: Apache-2.0
/* eslint-disable @typescript-eslint/no-require-imports */
const { readFileSync } = require("fs");
const { sync: fastGlobSync } = require("fast-glob");
const { dirname } = require("path");
const DEFAULT_HIGHLIGHT_LANGS = require("typedoc").OptionDefaults.highlightLanguages;

const documentedPackages = getPackageDirectories().sort();
console.info("Creating documentation for packages:", documentedPackages);

/**
 * See https://typedoc.org/options/
 *
 * @type {import("typedoc").TypeDocOptions}
 */
module.exports = {
    name: "Open Pioneer Trails Packages",
    readme: "none",
    out: "dist/docs",
    entryPointStrategy: "packages",
    entryPoints: documentedPackages,
    skipErrorChecking: true,
    validation: {
        notExported: false,
        invalidLink: true,
        notDocumented: true
    },

    // 'tsx' is in default, but 'jsx' is not..
    highlightLanguages: [...DEFAULT_HIGHLIGHT_LANGS, "jsx"]
};

function getPackageDirectories() {
    const packageJsonPaths = fastGlobSync("./src/packages/**/package.json", {
        ignore: ["**/dist/**", "**/node_modules/**"],
        followSymbolicLinks: false
    });
    const packageDirectories = packageJsonPaths
        .filter((path) => {
            const packageJsonContent = JSON.parse(readFileSync(path, "utf-8"));
            const isPrivate = !!packageJsonContent.private;
            return !isPrivate;
        })
        .map((path) => dirname(path));
    return packageDirectories;
}