kebab-case-filenames

Impõe convenções consistentes de nomenclatura de arquivos em diretórios de código-fonte.

Detalhes da regra

Nomenclatura inconsistente de arquivos (misturando camelCase, PascalCase, snake_case e kebab-case) torna os arquivos mais difíceis de encontrar e causa problemas de sensibilidade a maiúsculas e minúsculas entre sistemas operacionais. Esta regra valida cada nome de arquivo no escopo contra um padrão regex e sugere correções.

Exemplos de código incorreto

src/
  helpers/
    pathUtils.ts        ← camelCase
    Git_Helper.ts       ← PascalCase + snake_case
    ADRWriter.ts        ← PascalCase

Exemplos de código correto

src/
  helpers/
    path-utils.ts
    git-helper.ts
    adr-writer.ts

Implementação da regra

/// <reference path="../rules.d.ts" />
import { basename } from "node:path";

const KEBAB_CASE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*\.(ts|tsx|js|jsx)$/;

export default {
  rules: {
    "kebab-case-filenames": {
      description: "Source files must use kebab-case naming",
      async check(ctx) {
        for (const file of ctx.scopedFiles) {
          const name = basename(file);

          // Skip test files and type declaration files
          if (name.endsWith(".test.ts") || name.endsWith(".d.ts")) continue;

          if (!KEBAB_CASE.test(name)) {
            ctx.report.violation({
              message: `File "${name}" does not follow kebab-case naming convention`,
              file,
              fix: `Rename to ${name.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase()}`,
            });
          }
        }
      },
    },
  },
} satisfies RuleSet;

Quando usar

Quando sua equipe padronizou uma convenção de nomenclatura e deseja aplicá-la automaticamente. Adapte o regex para sua convenção:

// PascalCase (React components)
const PASCAL_CASE = /^[A-Z][a-zA-Z0-9]*\.(ts|tsx)$/;

// camelCase
const CAMEL_CASE = /^[a-z][a-zA-Z0-9]*\.(ts|tsx|js|jsx)$/;

// snake_case (Python-style)
const SNAKE_CASE = /^[a-z][a-z0-9]*(_[a-z0-9]+)*\.(ts|tsx|js|jsx)$/;

Quando não usar

Quando seu projeto intencionalmente mistura convenções de nomenclatura (ex.: PascalCase para componentes React e kebab-case para utilitários), ou ao migrar uma base de código legada onde renomeações em massa não são viáveis.