@precisa-saude/eslint-config 1.0.3 → 1.1.0

package/base.js

@@ -77,6 +77,13 @@ const base = [
       'no-throw-literal': 'error',
       'no-undef': 'off',
 
+      // Size limits — forcing decomposition before files/functions get
+      // unreadable. Thresholds are warns, not errors, so one-off
+      // offenders don't block landing. Data/mapping files should be
+      // ignored via `overrides` or per-repo `ignores`.
+      'max-lines': ['warn', { max: 400, skipBlankLines: true, skipComments: true }],
+      'max-lines-per-function': ['warn', { max: 300, skipBlankLines: true, skipComments: true }],
+
       'perfectionist/sort-interfaces': [
         'error',
         {

package/html.js

@@ -0,0 +1,34 @@
+// @ts-nocheck
+import html from '@html-eslint/eslint-plugin';
+
+/**
+ * ESLint preset for HTML files.
+ *
+ * Applies `@html-eslint` rules to `**\/*.html` with sensible defaults.
+ * Separate from `base` because not every repo has HTML files and the
+ * plugin pulls in its own parser.
+ *
+ * Usage:
+ *   import htmlConfig from '@precisa-saude/eslint-config/html';
+ *   export default [...base, ...htmlConfig];
+ *
+ * If you need to tighten or relax rules, add another block after this
+ * one in your config array.
+ */
+const htmlConfig = [
+  {
+    files: ['**/*.html'],
+    ignores: ['**/node_modules/**', '**/dist/**', '**/coverage/**'],
+    plugins: {
+      '@html-eslint': html,
+    },
+    languageOptions: {
+      parser: html.configs['flat/recommended'].languageOptions.parser,
+    },
+    rules: {
+      '@html-eslint/sort-attrs': 'error',
+    },
+  },
+];
+
+export default htmlConfig;

package/node-backend.js

@@ -0,0 +1,71 @@
+// @ts-nocheck
+import typescript from '@typescript-eslint/eslint-plugin';
+import tsParser from '@typescript-eslint/parser';
+import globals from 'globals';
+
+import base from './base.js';
+
+/**
+ * ESLint preset for Node.js backends (Express/Fastify/Hono/etc.).
+ *
+ * Extends `base` with:
+ *   - Node globals (process, Buffer, __dirname, etc.)
+ *   - `no-console: off` — backends legitimately log to stdout
+ *   - Express-friendly `no-misused-promises` (async route handlers are
+ *     void-returning by convention)
+ *   - Relaxed type-safety warnings (external API surfaces pull in lots
+ *     of `any`; turning these to errors is hostile on day one)
+ *
+ * File patterns match the ecosystem's backend conventions. Override
+ * `BACKEND_PATHS` if you have a non-standard layout.
+ *
+ * Usage:
+ *   import nodeBackend from '@precisa-saude/eslint-config/node-backend';
+ *   export default [...nodeBackend];
+ *
+ * Platform-specific rules (e.g. restricted imports for LGPD compliance)
+ * go in the consumer repo's eslint.config.js, not here.
+ */
+export const BACKEND_PATHS = ['apps/api/**/*.ts', 'apps/server/**/*.ts', 'packages/api-*/**/*.ts'];
+
+const nodeBackend = [
+  ...base,
+
+  {
+    files: BACKEND_PATHS,
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+        project: true,
+      },
+      globals: {
+        ...globals.node,
+        ...globals.es2022,
+      },
+    },
+    plugins: {
+      '@typescript-eslint': typescript,
+    },
+    rules: {
+      'no-console': 'off',
+
+      // Express route handlers are async but void-returning. The
+      // recommended rule has false positives here.
+      '@typescript-eslint/no-misused-promises': [
+        'error',
+        { checksVoidReturn: { arguments: false } },
+      ],
+
+      // Backends pull types through lots of external API boundaries; full
+      // strictness on day one is hostile. Warn, don't error.
+      '@typescript-eslint/no-unsafe-assignment': 'warn',
+      '@typescript-eslint/no-unsafe-member-access': 'warn',
+      '@typescript-eslint/no-unsafe-argument': 'warn',
+      '@typescript-eslint/require-await': 'warn',
+    },
+  },
+];
+
+export default nodeBackend;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@precisa-saude/eslint-config",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "Shared flat ESLint config (9+/10) for Precisa Saúde repositories.",
   "keywords": [
     "eslint",
@@ -21,16 +21,21 @@
   "exports": {
     ".": "./base.js",
     "./base": "./base.js",
-    "./react": "./react.js"
+    "./react": "./react.js",
+    "./node-backend": "./node-backend.js",
+    "./html": "./html.js"
   },
   "main": "./base.js",
   "files": [
     "base.js",
     "react.js",
+    "node-backend.js",
+    "html.js",
     "README.md"
   ],
   "dependencies": {
     "@eslint/js": "^9.39.2",
+    "@html-eslint/eslint-plugin": "^0.52.1",
     "@typescript-eslint/eslint-plugin": "^8.57.2",
     "@typescript-eslint/parser": "^8.57.2",
     "eslint-config-prettier": "^9.1.2",

package/react.js

@@ -16,22 +16,48 @@ import base from './base.js';
  * React ESLint flat config. Extends `base` with React, React Hooks, JSX a11y,
  * React Refresh, and better-tailwindcss rules.
  *
- * Usage:
- *   import reactConfig from '@precisa-saude/eslint-config/react';
- *   export default [
- *     ...reactConfig,
- *     {
- *       settings: {
- *         'better-tailwindcss': { tailwindConfig: './tailwind.config.js' },
- *       },
- *     },
- *   ];
+ * Two usage patterns:
+ *
+ * 1) Default-scoped (most repos): import as the default export; it uses
+ *    `REACT_PATHS` covering apps/web, apps/landing, site, packages/ui.
+ *
+ *    import reactConfig from '@precisa-saude/eslint-config/react';
+ *    export default [...reactConfig];
+ *
+ * 2) Custom-scoped (repos with atypical layouts): import the `withFiles`
+ *    factory and pass your own glob patterns. Use this when you need
+ *    React rules to apply only to specific paths — typically because a
+ *    Node/Express backend lives in a different directory that must not
+ *    pick up React rules.
+ *
+ *    import { withFiles } from '@precisa-saude/eslint-config/react';
+ *    export default [
+ *      ...withFiles(['apps/{web,landing}/**\/*.{ts,tsx}', 'packages/ui/**\/*.{ts,tsx}']),
+ *    ];
+ */
+
+// Default file patterns matching the ecosystem's React conventions:
+//   - Platform: apps/web, apps/landing, packages/ui
+//   - OSS repos with a site: site/
+export const REACT_PATHS = [
+  'apps/{web,landing}/**/*.{ts,tsx,jsx}',
+  'site/**/*.{ts,tsx,jsx}',
+  'packages/ui/**/*.{ts,tsx,jsx}',
+];
+
+/**
+ * Build a React-rules block scoped to the given file globs. Returned as
+ * an array for spread-compatibility with base:
+ *
+ *   [...base, ...withFiles([...paths])]
  */
-const reactConfig = [
-  ...base,
+export function withFiles(files) {
+  return [...base, buildReactBlock(files)];
+}
 
-  {
-    files: ['**/*.{ts,tsx,jsx}'],
+function buildReactBlock(files) {
+  return {
+    files,
     languageOptions: {
       parser: tsParser,
       parserOptions: {
@@ -99,7 +125,9 @@ const reactConfig = [
         },
       ],
     },
-  },
-];
+  };
+}
+
+const reactConfig = [...base, buildReactBlock(REACT_PATHS)];
 
 export default reactConfig;