@duro-app/eslint-config 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Frederic Rousseau
+
+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,68 @@
+# @duro-app/eslint-config
+
+Shareable ESLint flat config for the Duro stack — the policies CLAUDE.md and
+agent memory can only suggest, wired into the linter so every consumer repo
+gates them at commit time (via amont's built-in `pre-commit-lint-js`, which
+activates on the presence of a root ESLint config) and in CI.
+
+Requires ESLint 9 or 10 (flat config). All plugins arrive as dependencies of
+this package — consumers install one package.
+
+## Usage
+
+```js
+// eslint.config.js (repo root — amont only detects a ROOT config)
+import {react, effect, tests} from '@duro-app/eslint-config'
+
+export default [
+  {ignores: ['**/dist/**', '**/build/**']},
+  ...react,
+  ...tests,
+  // Server-only packages in a monorepo can scope the effect preset:
+  ...effect.map((c) => ({...c, files: ['apps/api/**/*.ts']})),
+]
+```
+
+## Presets
+
+| Preset   | Composes                                                           | For                       |
+| -------- | ------------------------------------------------------------------ | ------------------------- |
+| `base`   | `@eslint/js` + `typescript-eslint` recommended, prettier interop   | every TypeScript package  |
+| `react`  | base + react-hooks + `@duro-app/eslint-plugin` + UI-library policy | RSD / `@duro-app/ui` apps |
+| `effect` | base + `@effect` plugin + server-stack policy                      | Effect services           |
+| `tests`  | accessibility-first selectors (self-scoped to test/e2e files)      | any repo with tests       |
+
+`react` and `effect` both include `base`; applying both just repeats
+identical entries, which flat config merges harmlessly. `tests` carries its
+own `files` scope, so it can be appended unconditionally.
+
+## What the policies enforce
+
+- **`react`** — UI primitives come from `@duro-app/ui` only (react-aria,
+  Spectrum, MUI, Radix, Chakra, headlessui, antd and `@frontjutsu/ui` are
+  banned with a message that says where to add missing components); rich
+  text goes through `@fredericrous/lexical-multi`, never raw `lexical`;
+  plus everything in `@duro-app/eslint-plugin` (html.\* elements, deep token
+  imports, token values, form kit, the RSD flexGrow trap).
+- **`effect`** — `@effect/sql` not Kysely; `@effect/opentelemetry` only via
+  subpath (the barrel statically imports the web SDK and crashes Node at
+  module load); barrel-import hygiene via `@effect/eslint-plugin`.
+- **`tests`** — no `getByTestId` family, no CSS class/id `locator()`
+  strings: select by role/label/text, gate readiness on `aria-busy`.
+
+Severity is the one gating line: `error` gates at commit and CI, `warn`
+informs everywhere. Don't add `--max-warnings=0` — promote a rule to
+`error` here instead if it earns gating.
+
+## Escape hatches
+
+Flat config is last-wins — scope an override after the preset:
+
+```js
+...react,
+{
+  // The one file allowed to import the raw engine reset:
+  files: ['packages/editor/src/usePageNode.ts'],
+  rules: {'no-restricted-imports': 'off'},
+}
+```

package/index.d.ts

@@ -0,0 +1,14 @@
+import type {Linter} from 'eslint'
+
+export declare const base: Linter.Config[]
+export declare const react: Linter.Config[]
+export declare const effect: Linter.Config[]
+export declare const tests: Linter.Config[]
+
+declare const presets: {
+  base: Linter.Config[]
+  react: Linter.Config[]
+  effect: Linter.Config[]
+  tests: Linter.Config[]
+}
+export default presets

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@duro-app/eslint-config",
+  "version": "1.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Shareable ESLint flat config for the Duro stack: base TS conventions, the design-system rules and UI-library policy for React apps, Effect server conventions, and accessibility-first test selectors.",
+  "keywords": [
+    "eslint",
+    "eslintconfig",
+    "eslint-config",
+    "react-strict-dom",
+    "design-system",
+    "effect"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fredericrous/duro-design-system",
+    "directory": "packages/eslint-config"
+  },
+  "homepage": "https://github.com/fredericrous/duro-design-system",
+  "bugs": {
+    "url": "https://github.com/fredericrous/duro-design-system/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "index.d.ts"
+  ],
+  "main": "src/index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./src/index.js",
+      "default": "./src/index.js"
+    }
+  },
+  "engines": {
+    "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0 || ^10.0.0"
+  },
+  "dependencies": {
+    "@effect/eslint-plugin": "^0.3.2",
+    "@eslint/js": "^9.20.0 || ^10.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "typescript-eslint": "^8.56.0",
+    "@duro-app/eslint-plugin": "^1.1.0"
+  },
+  "devDependencies": {
+    "eslint": "^9.20.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/index.js

@@ -0,0 +1,155 @@
+import js from '@eslint/js'
+import tseslint from 'typescript-eslint'
+import reactHooks from 'eslint-plugin-react-hooks'
+import effectPlugin from '@effect/eslint-plugin'
+import prettier from 'eslint-config-prettier'
+import duro from '@duro-app/eslint-plugin'
+
+/**
+ * Shareable flat config for the Duro stack. Four presets, each a plain flat
+ * config array:
+ *
+ * - `base`    — TS + prettier interop; every TypeScript package.
+ * - `react`   — base + react-hooks + the duro plugin + UI-library policy;
+ *               anything rendering with react-strict-dom / @duro-app/ui.
+ * - `effect`  — base + the @effect plugin + server-stack policy; Effect
+ *               services and API packages.
+ * - `tests`   — accessibility-first selectors; applies itself only to
+ *               test/e2e files, so it can sit in any config unconditionally.
+ *
+ * `react` and `effect` both include `base`, so either works alone; applying
+ * both in one repo just repeats identical entries, which flat config merges
+ * harmlessly. Policy bans carry their rationale in the message — the lint
+ * output is meant to teach the fix, not just refuse the code.
+ */
+
+export const base = tseslint.config(
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    name: 'duro-config/base',
+    rules: {
+      '@typescript-eslint/no-unused-vars': [
+        'warn',
+        {
+          argsIgnorePattern: '^_',
+          destructuredArrayIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+        },
+      ],
+      '@typescript-eslint/no-explicit-any': 'off',
+    },
+  },
+  prettier,
+)
+
+const FOREIGN_UI_MESSAGE =
+  'UI primitives come from @duro-app/ui only. If the component you need is missing, add it to duro-design-system instead of reaching for another library — `npx duro list` shows what exists.'
+
+const LEXICAL_MESSAGE =
+  'Rich text goes through @fredericrous/lexical-multi at the app layer, never raw Lexical — the wrapper carries the multi-editor state, native support, and edit-state accessibility.'
+
+export const react = tseslint.config(
+  ...base,
+  reactHooks.configs.flat.recommended,
+  duro.configs.recommended,
+  {
+    name: 'duro-config/react-policy',
+    rules: {
+      'no-restricted-imports': [
+        'error',
+        {
+          patterns: [
+            {
+              group: [
+                'react-aria',
+                'react-aria-components',
+                '@react-aria/*',
+                '@adobe/react-spectrum',
+                '@react-spectrum/*',
+                '@mui/*',
+                '@material-ui/*',
+                '@radix-ui/*',
+                '@chakra-ui/*',
+                '@headlessui/*',
+                'antd',
+                'antd/*',
+                '@frontjutsu/ui',
+                '@frontjutsu/ui/*',
+              ],
+              message: FOREIGN_UI_MESSAGE,
+            },
+            {
+              group: ['lexical', '@lexical/*'],
+              message: LEXICAL_MESSAGE,
+            },
+          ],
+        },
+      ],
+    },
+  },
+)
+
+const KYSELY_MESSAGE =
+  'DB access in this stack is @effect/sql (SqlClient + Migrator + SqlSchema) — Kysely duplicates it outside the Effect runtime.'
+
+const OTEL_BARREL_MESSAGE =
+  'Import the subpath you need (e.g. @effect/opentelemetry/NodeSdk) — the barrel re-exports WebSdk, which statically imports @opentelemetry/sdk-trace-web and crashes a Node service at module load.'
+
+export const effect = tseslint.config(...base, {
+  name: 'duro-config/effect-policy',
+  plugins: {'@effect': effectPlugin},
+  rules: {
+    '@effect/no-import-from-barrel-package': 'warn',
+    'no-restricted-imports': [
+      'error',
+      {
+        paths: [{name: '@effect/opentelemetry', message: OTEL_BARREL_MESSAGE}],
+        patterns: [
+          {
+            group: ['kysely', 'kysely-*', '@kysely/*'],
+            message: KYSELY_MESSAGE,
+          },
+        ],
+      },
+    ],
+  },
+})
+
+const TESTID_MESSAGE =
+  'Select by what users and assistive tech perceive — getByRole/getByLabel/getByText — not test ids. If nothing selectable exists, the control is not accessible; fix the component.'
+
+const CSS_LOCATOR_MESSAGE =
+  'CSS class/id locators are implementation details that drift. Use getByRole/getByLabel/getByText; gate readiness on aria-busy over a named region, not a class hook.'
+
+export const tests = [
+  {
+    name: 'duro-config/tests',
+    files: [
+      '**/*.test.{ts,tsx,js,jsx}',
+      '**/*.spec.{ts,tsx,js,jsx}',
+      '**/e2e/**/*.{ts,tsx,js,jsx}',
+      '**/__tests__/**/*.{ts,tsx,js,jsx}',
+    ],
+    rules: {
+      'no-restricted-syntax': [
+        'error',
+        {
+          selector: 'CallExpression[callee.property.name=/^(get|query|find)(All)?ByTestId$/]',
+          message: TESTID_MESSAGE,
+        },
+        {
+          selector: 'CallExpression[callee.name=/^(get|query|find)(All)?ByTestId$/]',
+          message: TESTID_MESSAGE,
+        },
+        {
+          selector:
+            'CallExpression[callee.property.name="locator"] > Literal.arguments:first-child[value=/^[.#]/]',
+          message: CSS_LOCATOR_MESSAGE,
+        },
+      ],
+    },
+  },
+]
+
+export default {base, react, effect, tests}