hard-lint 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 naylsonferreira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,225 @@
+# hard-lint
+
+⚙️ Configuração **rigorosa** de ESLint para projetos TypeScript.
+
+[![npm version](https://img.shields.io/npm/v/hard-lint.svg)](https://www.npmjs.com/package/hard-lint)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/naylsonferreira/hard-lint/actions/workflows/ci.yml/badge.svg)](https://github.com/naylsonferreira/hard-lint/actions/workflows/ci.yml)
+
+## O que é?
+
+`hard-lint` é uma biblioteca de configuração ESLint que implementa regras **rigorosas** para garantir:
+
+- ✅ **Tipagem forte** - Proibição de `any`, tipos explícitos
+- ✅ **Code quality** - Proibição de console, comentários
+- ✅ **Acessibilidade** - Seletores semânticos em testes
+- ✅ **Manutenibilidade** - Limites de complexidade, sintaxe consistente
+- ✅ **Segurança** - Evita eval, scripts dinâmicos
+
+## Instalação
+
+```bash
+npm install --save-dev hard-lint eslint typescript
+```
+
+## Requisitos
+
+- **Node.js** >= 18.0.0
+- **npm** >= 9.0.0
+- **ESLint** >= 9.0.0
+- **TypeScript** >= 5.0.0
+
+## O que Está Incluído
+
+- ✅ **eslint.config.mjs** - Configuração ESLint 9 flat config
+- ✅ **20+ regras rigorosas** - TypeScript, console, comentários, segurança
+- ✅ **Pre-commit hooks** - Husky + lint-staged para validação automática
+- ✅ **Commit validation** - Commitlint com Conventional Commits
+- ✅ **Tipos TypeScript** - Para customizações
+- ✅ **Documentação completa** - README, guias de contribuição
+
+## Uso Rápido
+
+### Em `eslint.config.mjs`:
+
+```javascript
+import hardlint from 'hard-lint';
+
+export default [...hardlint];
+```
+
+## Regras Implementadas
+
+### 📋 TypeScript
+
+| Regra | Severidade | Config |
+|-------|-----------|--------|
+| `@typescript-eslint/no-explicit-any` | ❌ Error | Proíbe tipo `any` |
+| `@typescript-eslint/no-unused-vars` | ❌ Error | Detecta variáveis não usadas (permite `_var`) |
+
+### 🚫 Console & Comentários
+
+| Regra | Severidade | Config |
+|-------|-----------|--------|
+| `no-console` | ❌ Error | Proíbe console.log, debug, warn, info |
+| `no-inline-comments` | ❌ Error | Proíbe comentários na mesma linha |
+| `no-warning-comments` | ❌ Error | Proíbe `todo`, `fixme`, `hack`, `xxx`, `note`, `debug`, `review` |
+
+### 🎨 Code Style
+
+| Regra | Severidade | Config |
+|-------|-----------|--------|
+| `no-var` | ❌ Error | Use `const`/`let` obrigatoriamente |
+| `prefer-const` | ❌ Error | Use `const` sempre que possível |
+| `prefer-arrow-callback` | ❌ Error | Prefira arrow functions em callbacks |
+| `no-nested-ternary` | ❌ Error | Proíbe ternários aninhados |
+| `sort-imports` | ❌ Error | Imports devem estar ordenados |
+| `complexity` | ❌ Error | Máximo 10 de complexidade ciclomática |
+| `max-depth` | ❌ Error | Máximo 3 níveis de aninhamento |
+| `max-nested-callbacks` | ❌ Error | Máximo 3 callbacks aninhados |
+
+### 🔒 Segurança
+
+| Regra | Severidade | Config |
+|-------|-----------|--------|
+| `no-eval` | ❌ Error | Proíbe `eval()` |
+| `no-implied-eval` | ❌ Error | Proíbe eval implícito (setTimeout com string) |
+| `no-new-func` | ❌ Error | Proíbe `new Function()` |
+| `no-script-url` | ❌ Error | Proíbe `javascript:` URLs |
+
+### 🎭 Seletores Semânticos (E2E)
+
+Validators customizados para garantir testes E2E que se comportam como usuários reais:
+
+| Padrão | Mensagem |
+|--------|----------|
+| `.locator('button').nth()` | Use `getByRole('button')` para seletores semânticos |
+| `.locator('button').filter()` | Use `getByRole('button', { name: /texto/i })` |
+| `.locator('h1\|h2\|h3...')` | Use `getByRole('heading', { name: /texto/i })` |
+| `.locator('button').first()` | Use `getByRole()` ou `getByLabel()` |
+
+**Rodar manualmente:**
+```bash
+npm run validate-e2e [arquivos...]
+```
+
+**Automático no pre-commit:** Valida todos os `.e2e.ts` e `.test.ts` antes de commitar.
+
+**Objetivo:** Testes que clicam em **palavras**, não em divs. Seletores que representam o que o usuário vê e interage.
+
+## Exemplos
+
+### ❌ PROIBIDO
+
+```typescript
+const data: any = fetch('/api');
+
+console.log('Debug:', value);
+console.debug('Debug info');
+console.warn('warning');
+
+const count = 0; // contador
+```
+
+### ✅ CORRETO
+
+```typescript
+const data: Promise<Response> = fetch('/api');
+
+const count = 0;
+
+const initializeUserCount = 0;
+```
+
+## Scripts
+
+```bash
+npm run build       # Build da biblioteca
+npm run dev         # Watch mode
+npm run lint        # Lint este projeto
+npm run type-check  # Type check
+```
+
+## Git Hooks (Husky + Commitlint)
+
+Este projeto usa **Husky** + **lint-staged** + **commitlint** para validar código e commits:
+
+### Pre-Commit Hook
+
+Executado **automaticamente** antes de cada commit:
+
+```bash
+git add .
+git commit -m "feat: adiciona nova feature"
+# ↓ Valida automaticamente
+# - Roda ESLint (proíbe comentários, console, etc)
+# - Detecta e bloqueia violations
+```
+
+**Se houver erro:**
+- ❌ Commit é bloqueado
+- 📋 Erro é exibido
+- 🔧 Corrija o código antes de committar
+
+### Commit-Msg Hook
+
+Valida o **formato da mensagem**:
+
+```bash
+# ✅ Formato correto (max 100 chars)
+git commit -m "feat: add new validation rule"
+
+# ❌ Formato inválido
+git commit -m "blablabla"
+```
+
+**Tipos permitidos:**
+- `feat` - Nova feature
+- `fix` - Bug fix
+- `docs` - Documentação
+- `style` - Formatação
+- `refactor` - Refatoração
+- `perf` - Performance
+- `test` - Testes
+- `chore` - Manutenção
+- `revert` - Revert
+- `ci` - CI/CD
+
+Veja [PRE_COMMIT.md](./PRE_COMMIT.md) para documentação completa.
+
+## Configuração Avançada
+
+Para customizar ou estender a config:
+
+```javascript
+import hardlint from 'hard-lint';
+
+export default [
+  ...hardlint,
+  {
+    files: ['src/**/*.ts'],
+    rules: {
+      'no-console': 'warn'
+    }
+  }
+];
+```
+
+## Contribuindo
+
+1. Fork o repositório (https://github.com/naylsonferreira/hard-lint)
+2. Crie uma branch (`git checkout -b feature/improvement`)
+3. Commit suas mudanças (`git commit -m 'Add: melhoria'`)
+4. Push para a branch (`git push origin feature/improvement`)
+5. Abra um Pull Request
+
+## Publicação no NPM
+
+1. Faça login: `npm login`
+2. Incremente versão: `npm version patch|minor|major`
+3. Build: `npm run build`
+4. Publique: `npm publish --access public`
+
+## Licença
+
+MIT © 2026 naylsonferreira

package/dist/config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Funções para criar configurações hard-lint customizadas
+ */
+import type { HardLintConfig, ESLintConfig } from './types';
+/**
+ * Cria uma configuração hard-lint customizada
+ *
+ * @param options - Opções de configuração
+ * @returns Array de configurações ESLint
+ */
+export declare function createHardLintConfig(): ESLintConfig[];
+/**
+ * Tipos de severidade recomendados
+ */
+export declare const SEVERITY: {
+    ERROR: "error";
+    WARN: "warn";
+    OFF: "off";
+};
+/**
+ * Predefinições de configuração
+ */
+export declare const PRESETS: {
+    /**
+     * Máxima rigorosidade - todas as regras ativadas
+     */
+    strict: () => HardLintConfig;
+    /**
+     * Moderado - algumas regras como warn
+     */
+    moderate: () => HardLintConfig;
+    /**
+     * Apenas regras críticas
+     */
+    minimal: () => HardLintConfig;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,YAAY,EAAE,CAkBrD;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;CAIpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB;;OAEG;kBACS,cAAc;IAM1B;;OAEG;oBACW,cAAc;IAM5B;;OAEG;mBACU,cAAc;CAK5B,CAAC"}

package/dist/config.js

@@ -0,0 +1,62 @@
+/**
+ * Funções para criar configurações hard-lint customizadas
+ */
+/**
+ * Cria uma configuração hard-lint customizada
+ *
+ * @param options - Opções de configuração
+ * @returns Array de configurações ESLint
+ */
+export function createHardLintConfig() {
+    const configs = [];
+    // Configurações base (importadas dinamicamente do eslint.config.mjs)
+    // Esta função é um helper que permite customizar a configuração
+    /**
+     * Exemplo de uso:
+     * const config = createHardLintConfig({
+     *   nextRules: false,
+     *   overrides: {
+     *     'no-console': 'warn'
+     *   }
+     * });
+     */
+    return configs;
+}
+/**
+ * Tipos de severidade recomendados
+ */
+export const SEVERITY = {
+    ERROR: 'error',
+    WARN: 'warn',
+    OFF: 'off'
+};
+/**
+ * Predefinições de configuração
+ */
+export const PRESETS = {
+    /**
+     * Máxima rigorosidade - todas as regras ativadas
+     */
+    strict: () => ({
+        e2eRules: true,
+        nextRules: true,
+        defaultSeverity: 'error'
+    }),
+    /**
+     * Moderado - algumas regras como warn
+     */
+    moderate: () => ({
+        e2eRules: true,
+        nextRules: true,
+        defaultSeverity: 'warn'
+    }),
+    /**
+     * Apenas regras críticas
+     */
+    minimal: () => ({
+        e2eRules: false,
+        nextRules: false,
+        defaultSeverity: 'warn'
+    })
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAElC,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,qEAAqE;IACrE,gEAAgE;IAEhE;;;;;;;;OAQG;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,OAAgB;IACvB,IAAI,EAAE,MAAe;IACrB,GAAG,EAAE,KAAc;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB;;OAEG;IACH,MAAM,EAAE,GAAmB,EAAE,CAAC,CAAC;QAC7B,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,eAAe,EAAE,OAAO;KACzB,CAAC;IAEF;;OAEG;IACH,QAAQ,EAAE,GAAmB,EAAE,CAAC,CAAC;QAC/B,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,eAAe,EAAE,MAAM;KACxB,CAAC;IAEF;;OAEG;IACH,OAAO,EAAE,GAAmB,EAAE,CAAC,CAAC;QAC9B,QAAQ,EAAE,KAAK;QACf,SAAS,EAAE,KAAK;QAChB,eAAe,EAAE,MAAM;KACxB,CAAC;CACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * hard-lint
+ * Configuração rigorosa de ESLint para projetos TypeScript
+ */
+export type { HardLintConfig } from './types';
+export { createHardLintConfig } from './config';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * hard-lint
+ * Configuração rigorosa de ESLint para projetos TypeScript
+ */
+export { createHardLintConfig } from './config';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tipos para a configuração hard-lint
+ */
+import type { Linter } from 'eslint';
+export interface HardLintConfig {
+    /**
+     * Habilita regras rigorosas para testes E2E
+     * @default true
+     */
+    e2eRules?: boolean;
+    /**
+     * Habilita regras do Next.js
+     * @default true
+     */
+    nextRules?: boolean;
+    /**
+     * Sobrescreve regras específicas
+     */
+    overrides?: Record<string, 'error' | 'warn' | 'off'>;
+    /**
+     * Severidade padrão para regras personalizadas
+     * @default 'error'
+     */
+    defaultSeverity?: 'error' | 'warn' | 'off';
+}
+export type ESLintConfig = Linter.Config;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;IAErD;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;CAC5C;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Tipos para a configuração hard-lint
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/eslint.config.mjs

@@ -0,0 +1,83 @@
+import js from '@eslint/js';
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+
+export default [
+  // Configuração global
+  {
+    ignores: ['node_modules/', 'dist/', '.next/', 'coverage/', 'examples/', 'scripts/']
+  },
+
+  // Base: JavaScript/TypeScript
+  js.configs.recommended,
+
+  // Configuração para todos os arquivos
+  {
+    files: ['**/*.{ts,tsx,js,jsx}'],
+    plugins: {
+      '@typescript-eslint': tseslint
+    },
+    languageOptions: {
+      parser: tsparser,
+      globals: {
+        module: 'readonly',
+        require: 'readonly'
+      },
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+        ecmaFeatures: {
+          jsx: true
+        }
+      }
+    },
+    rules: {
+      // Regras TypeScript rigorosas
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_'
+        }
+      ],
+
+      // Regras de console
+      'no-console': 'error',
+
+      // Regras de comentários
+      'no-inline-comments': 'error',
+      'no-warning-comments': [
+        'error',
+        {
+          terms: ['todo', 'fixme', 'hack', 'xxx', 'note', 'debug', 'review'],
+          location: 'anywhere'
+        }
+      ],
+
+      // Regras de code style
+      'no-var': 'error',
+      'prefer-const': 'error',
+      'prefer-arrow-callback': 'error',
+      'no-nested-ternary': 'error',
+      'complexity': ['error', 10],
+      'max-depth': ['error', 3],
+      'max-nested-callbacks': ['error', 3],
+
+      // Regras de segurança
+      'no-eval': 'error',
+      'no-implied-eval': 'error',
+      'no-new-func': 'error',
+      'no-script-url': 'error',
+
+      // Regras de imports
+      'sort-imports': [
+        'error',
+        {
+          ignoreCase: true,
+          ignoreMemberSort: true
+        }
+      ]
+    }
+  }
+];

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "hard-lint",
+  "version": "0.2.0",
+  "description": "Configuração rigorosa de ESLint para projetos TypeScript",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "eslint.config.mjs"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint .",
+    "type-check": "tsc --noEmit",
+    "validate-e2e": "node scripts/validate-e2e-selectors.js",
+    "prepare": "npm run build && husky install"
+  },
+  "keywords": [
+    "eslint",
+    "config",
+    "typescript",
+    "linting",
+    "code-quality"
+  ],
+  "author": "naylsonferreira",
+  "license": "MIT",
+  "peerDependencies": {
+    "eslint": ">=8.56.0",
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.4.1",
+    "@commitlint/config-conventional": "^20.4.1",
+    "@eslint/js": "^9.0.0",
+    "@types/eslint": "^8.56.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^8.56.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/naylsonferreira/hard-lint.git"
+  },
+  "bugs": {
+    "url": "https://github.com/naylsonferreira/hard-lint/issues"
+  },
+  "homepage": "https://github.com/naylsonferreira/hard-lint#readme",
+  "lint-staged": {
+    "**/*.{ts,tsx,js,jsx}": [
+      "eslint --fix",
+      "eslint"
+    ],
+    "**/*.{e2e,test}.{ts,tsx,js,jsx}": [
+      "node scripts/validate-e2e-selectors.js"
+    ]
+  }
+}