eslint-plugin-i18n-guard/src/rules/i18n-no-missing-keys.js

ESLint plugin designed to help ensure that every key in your JSON i18n translation files has a corresponding translation. This can help avoid missing translations and ensure consistency across languages.

const {
  checkIfJsonHaveSameKeys,
} = require("../helpers/check-if-json-have-same-keys.js");
const fs = require("fs");
const { getJsonFiles } = require("../helpers/get-json-files.js");
const path = require("path");

const meta = {
  type: "problem",
  docs: {
    description:
      "Ensure consistency across i18n translation files by reporting missing keys.",
    category: "Best Practices",
    recommended: true,
  },
  messages: {
    missingKeys: "",
    noDirectories:
      "No valid translation directories were found. Please make sure you passed valid directory paths containing JSON files.",
    noEntryPoint:
      "No entry point was found. Please make sure you passed an existan file.",
  },
  schema: [
    {
      type: "object",
      properties: {
        directories: {
          type: "array",
          items: { type: "string" },
          description:
            "Array of directory paths containing JSON files to compare for key consistency.",
        },
        entryPoint: {
          type: "string",
          description:
            "The entry point file of the application (e.g., 'main.tsx' or 'App.tsx'). ESLint errors will appear in this file.",
        },
      },
      additionalProperties: false,
    },
  ],
};

function create(context) {
  const fileName = context.getFilename();
  const entryPoint = context.options[0]?.entryPoint;

  if (!entryPoint) {
    context.report({
      messageId: "noEntryPoint",
      loc: { line: 1, column: 0 },
    });
    return {};
  }

  if (!fileName.endsWith(entryPoint)) {
    return {};
  }

  const projectRoot = process.cwd();
  const directoriesInput = context.options[0]?.directories;

  if (!directoriesInput) {
    context.report({
      messageId: "noDirectories",
      loc: { line: 1, column: 0 },
    });
    return {};
  }

  const directories = directoriesInput.map(
    (dir) => path.resolve(projectRoot, dir) // Resolver la ruta desde la raíz del proyecto
  );

  const fileGroups = directories.map((dir) => {
    const files = getJsonFiles(dir);
    return files.map((file) => ({
      name: file,
      content: JSON.parse(fs.readFileSync(file, "utf8")),
    }));
  });

  fileGroups.forEach((fileGroup) => {
    const visited = {};
    fileGroup.map((file) => {
      visited[file.name]?.length
        ? visited[file.name].push(file.name)
        : (visited[file.name] = [file.name]);

      fileGroup.map((file2) => {
        if (!visited[file.name]?.includes(file2.name)) {
          visited[file2.name]?.length
            ? visited[file2.name].push(file.name)
            : (visited[file2.name] = [file.name]);

          const { res, wrongKeys } = checkIfJsonHaveSameKeys(file, file2);
          if (!res) {
            wrongKeys.map(({ key, file }) => {
              context.report({
                message: `"${key}" is missing in file: ${file}`,
                loc: { line: 1, column: 0 },
              });
            });
          }
        }
      });
    });
  });

  return {};
}

module.exports = {
  name: "i18n-no-missing-keys",
  meta: meta,
  create(context) {
    return create(context);
  },
};