react-test/packages/api-docs-builder/utils/generateApiTranslation.ts

import { mkdirSync } from 'fs';
import path from 'path';
import { kebabCase } from 'es-toolkit/string';
import { writePrettifiedFile } from '../buildApiUtils';
import { HooksTranslations, PropsTranslations } from '../types/ApiBuilder.types';

interface MinimalReactAPI {
  name: string;
  apiDocsTranslationFolder?: string;
  translations: PropsTranslations | HooksTranslations;
}

export default async function generateApiTranslations<ReactApi extends MinimalReactAPI>(
  outputDirectory: string,
  reactApi: ReactApi,
  languages: string[],
) {
  const definitionName = reactApi.name;
  const apiDocsTranslationPath = path.resolve(outputDirectory, kebabCase(definitionName));
  function resolveApiDocsTranslationsComponentLanguagePath(
    language: (typeof languages)[0],
  ): string {
    const languageSuffix = language === 'en' ? '' : `-${language}`;

    return path.join(apiDocsTranslationPath, `${kebabCase(definitionName)}${languageSuffix}.json`);
  }

  mkdirSync(apiDocsTranslationPath, {
    mode: 0o777,
    recursive: true,
  });
  reactApi.apiDocsTranslationFolder = apiDocsTranslationPath;

  await writePrettifiedFile(
    resolveApiDocsTranslationsComponentLanguagePath('en'),
    JSON.stringify(reactApi.translations),
  );

  await Promise.all(
    languages.map(async (language) => {
      if (language !== 'en') {
        try {
          await writePrettifiedFile(
            resolveApiDocsTranslationsComponentLanguagePath(language),
            JSON.stringify(reactApi.translations),
            undefined,
            { flag: 'wx' },
          );
        } catch (error) {
          // File exists
        }
      }
    }),
  );
}