3x-ui/docs/scripts/gen-openapi.ts

import { readFileSync } from 'node:fs';
import { basename } from 'node:path';
import { generateFiles } from 'fumadocs-openapi';
import { openapi } from '../lib/openapi.ts';

// Map a slugified tag name back to its clean display name, so generated page
// titles read "API Tokens" instead of the auto-split "A P I Tokens".
const spec = JSON.parse(readFileSync('./public/openapi.json', 'utf8')) as {
  tags?: { name: string }[];
};
const titleBySlug = new Map(
  (spec.tags ?? []).map((t) => [t.name.toLowerCase().replace(/\s+/g, '-'), t.name]),
);

// Generate one MDX page per tag into the English reference/api folder.
// Other locales fall back to English for the API reference.
await generateFiles({
  input: openapi,
  output: './content/docs/en/reference/api',
  per: 'tag',
  beforeWrite(files) {
    for (const file of files) {
      const slug = basename(file.path).replace(/\.mdx$/, '');
      const title = titleBySlug.get(slug);
      if (title) {
        file.content = file.content.replace(/^title:.*$/m, `title: ${title}`);
      }
    }
  },
});

console.log('Generated API reference pages.');