Files
homarr/apps/docs/scripts/validate-docs-coverage.ts
T

35 lines
1.1 KiB
TypeScript

import fs from "node:fs";
import path from "node:path";
import { widgetDocSlugs } from "@homarr/definitions/docs/widget-doc-slugs";
import { getIntegrationDocumentationSlug, integrationKinds } from "@homarr/definitions/integration";
const docsDir = path.resolve(import.meta.dirname, "../docs");
const documentationEntries = [
{
label: "Integration",
folder: "integrations",
entries: integrationKinds.map((kind) => [kind, getIntegrationDocumentationSlug(kind)] as const),
},
{ label: "Widget", folder: "widgets", entries: Object.entries(widgetDocSlugs) },
] as const;
const missing: string[] = [];
for (const { label, folder, entries } of documentationEntries) {
for (const [kind, slug] of entries) {
if (!slug) continue;
if (!fs.existsSync(path.join(docsDir, folder, slug, "index.mdx"))) {
missing.push(`${label} "${kind}" -> docs/${folder}/${slug}/index.mdx`);
}
}
}
if (missing.length > 0) {
throw new Error(
`Missing documentation for ${missing.length} feature(s):\n${missing.map((item) => ` - ${item}`).join("\n")}`,
);
}
console.log("Integration and widget documentation coverage passed");