@riligar/eslint-config 1.0.0

package/README.md

@@ -0,0 +1,34 @@
+# @riligar/eslint-config
+
+A config de ESLint dos painéis React da RiLiGar.
+
+```bash
+bun add -d @riligar/eslint-config eslint
+```
+
+```js
+// eslint.config.js
+import dashboard from '@riligar/eslint-config/dashboard'
+
+export default dashboard
+```
+
+Uma regra específica do seu projeto entra espalhando a base primeiro:
+
+```js
+export default [...dashboard, { files: ['src/x.jsx'], rules: { /* ... */ } }]
+```
+
+## O que ela carrega
+
+Além de `js.configs.recommended`, `react-hooks` e `react-refresh`, três
+exceções — cada uma escrita depois de um falso positivo que travou um deploy.
+O porquê de cada uma está em comentário no próprio [`dashboard.js`](dashboard.js):
+
+- **`no-unused-vars` com `argsIgnorePattern: '^[A-Z_]'`** — sem o plugin react,
+  o linter não enxerga `<Icon />` no JSX e acusa todo componente que recebe um
+  ícone por prop no padrão `{ icon: Icon }`.
+- **`react-hooks/set-state-in-effect` como aviso** — a regra não distingue uma
+  carga inicial no mount de uma cascata de renders.
+- **`react-hooks/preserve-manual-memoization` como aviso** — é o React Compiler
+  relatando uma otimização que não pôde manter, não um defeito.

package/dashboard.js

@@ -0,0 +1,91 @@
+/**
+ * Config de ESLint dos sete painéis.
+ *
+ * Antes do monorepo isto era SETE arquivos `eslint.config.js`, um por
+ * dashboard, com cinco conteúdos diferentes entre eles — a divergência era
+ * só de comentário e de uma exceção a mais num deles, mas nada garantia
+ * que continuasse assim. Agora é um arquivo, e cada painel o estende.
+ *
+ * Uso, em `apps/<produto>/dashboard/eslint.config.js`:
+ *
+ *     import dashboard from '@riligar/eslint-config/dashboard'
+ *     export default dashboard
+ *
+ * Uma regra específica de um painel se acrescenta assim:
+ *
+ *     export default [...dashboard, { files: ['src/x.jsx'], rules: {...} }]
+ */
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+    globalIgnores(['dist']),
+    {
+        files: ['**/*.{js,jsx}'],
+        extends: [
+            js.configs.recommended,
+            reactHooks.configs.flat.recommended,
+            reactRefresh.configs.vite,
+        ],
+        languageOptions: {
+            ecmaVersion: 2020,
+            globals: globals.browser,
+            parserOptions: {
+                ecmaVersion: 'latest',
+                ecmaFeatures: { jsx: true },
+                sourceType: 'module',
+            },
+        },
+        rules: {
+            /*
+             * `varsIgnorePattern` cobre variáveis; `argsIgnorePattern` cobre
+             * parâmetros — e é aí que caem os aliases de componente do padrão
+             * `{ icon: Icon }`, usados só dentro do JSX. Sem o plugin react (que
+             * lê JSX), o linter não enxerga `<Icon />` e acusa falso positivo em
+             * todo componente que recebe um ícone por prop.
+             *
+             * A inicial maiúscula é o que distingue componente de valor comum, e é
+             * exatamente o mesmo critério que já valia para as variáveis.
+             */
+            'no-unused-vars': [
+                'error',
+                { varsIgnorePattern: '^[A-Z_]', argsIgnorePattern: '^[A-Z_]' },
+            ],
+
+            /*
+             * `set-state-in-effect` as a WARNING, not an error.
+             *
+             * The occurrences across this stack are initial data loads on mount or
+             * syncing a prop into local state — the correct React pattern. The rule
+             * does not tell that apart from a render cascade: it sees a synchronous
+             * `setState` and flags it.
+             *
+             * It stays a warning so it keeps showing up in new code, where it may be
+             * a real defect, without blocking the deploy over a false positive.
+             */
+            'react-hooks/set-state-in-effect': 'warn',
+
+            /*
+             * `preserve-manual-memoization` as a WARNING.
+             *
+             * This is the React Compiler reporting that it could not keep an existing
+             * `useCallback`/`useMemo` while compiling — a missed optimisation, not a
+             * defect: the code behaves exactly as written either way.
+             */
+            'react-hooks/preserve-manual-memoization': 'warn',
+        },
+    },
+    {
+        /*
+         * The entrypoint mounts the tree and is reused by nobody: Fast Refresh does
+         * not apply to it, and forcing the component out of here would create a file
+         * just to satisfy a rule that protects nothing in this case. The rule still
+         * holds everywhere else.
+         */
+        files: ['src/main.jsx'],
+        rules: { 'react-refresh/only-export-components': 'off' },
+    },
+])

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@riligar/eslint-config",
+  "version": "1.0.0",
+  "license": "MIT",
+  "type": "module",
+  "description": "A config de ESLint dos painéis React da RiLiGar: as três exceções que o linter precisa para não acusar falso positivo em código correto.",
+  "exports": {
+    "./dashboard": "./dashboard.js"
+  },
+  "files": [
+    "dashboard.js",
+    "README.md"
+  ],
+  "dependencies": {
+    "@eslint/js": "^9.39.4",
+    "eslint-plugin-react-hooks": "7.1.1",
+    "eslint-plugin-react-refresh": "^0.4.26",
+    "globals": "^16.5.0"
+  },
+  "peerDependencies": {
+    "eslint": "^9.39.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/riligar/packages.git",
+    "directory": "eslint-config"
+  }
+}