animethemes-api-docs/docs/.vitepress/theme/graphql-warn-plugin.js

import path from "path";

export default function graphqlWarnPlugin() {
    return {
        name: "graphql-warn-plugin",
        enforce: "pre",
        transform(code, id) {
            if (!id.endsWith(".md")) return;

            const relativePath = path.relative(process.cwd(), id);
            if (!relativePath.includes("graphql")) return;

            const warningBlock = [
                "::: warning",
                "⚠️ The GraphQL API is experimental and subject to change without notice.",
                ":::",
                "",
            ].join("\n");

            if (code.startsWith("---")) {
                const endOfFrontmatter = code.indexOf("---", 3);
                if (endOfFrontmatter !== -1) {
                    const before = code.slice(0, endOfFrontmatter + 3);
                    const after = code.slice(endOfFrontmatter + 3);
                    return {
                        code: `${before}\n\n${warningBlock}${after}`,
                        map: null,
                    };
                }
            }

            return {
                code: warningBlock + code,
                map: null,
            };
        },
    };
}