eslint-config-maedow-arch 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jean-Marc
+
+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,63 @@
+# eslint-config-maedow-arch
+
+Règles ESLint officielles de [Maedow Arch](https://github.com/maedow-arch/maedow-arch-docs) : enforce les frontières entre `app`, `features`, `core`, `components` et `lib` via [`eslint-plugin-boundaries`](https://www.jsboundaries.dev/).
+
+## Installation
+
+```bash
+npm install --save-dev eslint-config-maedow-arch eslint-plugin-boundaries eslint-import-resolver-typescript
+```
+
+> **`eslint-import-resolver-typescript` n'est pas optionnel.** Sans résolveur TypeScript, les imports `.ts`/`.tsx` sont classés « unknown » par le plugin et **aucune règle ne se déclenche** : le lint passe au vert sans rien vérifier. C'est le mode de défaillance le plus sournois de ce type de configuration.
+
+## Usage
+
+```js
+// eslint.config.mjs
+import maedowArchConfig from "eslint-config-maedow-arch";
+
+export default [
+  ...maedowArchConfig,
+  // tes règles additionnelles ici
+];
+```
+
+La config n'impose pas de parser : apporte le tien (`typescript-eslint` dans un projet TypeScript).
+
+## Ce que ça enforce
+
+Le flux de dépendance est unidirectionnel — `app → features → core → lib` :
+
+| Depuis | Peut importer |
+| :--- | :--- |
+| `app/` | tout |
+| `features/<x>/` | `features/_shared/`, `core/`, `components/`, `lib/`, et **sa propre feature** |
+| `features/_shared/` | `core/`, `components/`, `lib/` — jamais une feature |
+| `core/` | `core/`, `lib/` — **zéro dépendance UI** |
+| `components/` | `components/`, `lib/` |
+| `lib/` | `lib/` uniquement |
+
+Une violation produit un message explicite :
+
+```
+Maedow Arch : core ne peut pas importer components. Voir architecture.md §6.
+```
+
+## Dispositions supportées
+
+Les patterns ne sont pas ancrés à la racine du projet : `core/` et `src/core/` fonctionnent tous les deux, sans configuration supplémentaire.
+
+## Vérifier que les frontières sont bien actives
+
+Une config de frontières qui ne matche rien passe au vert. Le seul test qui prouve quelque chose est le test **négatif** : ajoute temporairement un import interdit et vérifie qu'ESLint échoue.
+
+```ts
+// src/core/billing/service.ts
+import { Button } from "../../components/ui/Button"; // doit lever une erreur
+```
+
+Ce package embarque ce test — voir `test/run.mjs`, lancé par `npm run test:boundaries` à la racine du dépôt.
+
+## Licence
+
+MIT

package/index.js

@@ -0,0 +1,112 @@
+import boundaries from "eslint-plugin-boundaries";
+
+/**
+ * Configuration ESLint officielle de Maedow Arch.
+ * Enforce le flux de dépendance unidirectionnel :
+ *
+ *   app → features → core → lib
+ *
+ * Usage dans eslint.config.mjs :
+ *   import maedowArchConfig from "eslint-config-maedow-arch";
+ *   export default [...maedowArchConfig];
+ *
+ * ⚠️ Deux points qui font échouer silencieusement une config boundaries :
+ *
+ * 1. L'ORDRE des éléments compte — le premier pattern qui matche gagne.
+ *    `shared-feature` doit précéder `feature`, sinon `features/_shared/`
+ *    serait classé comme une feature ordinaire et sa règle serait morte.
+ *
+ * 2. La RÉSOLUTION des imports doit connaître TypeScript. Sans résolveur TS,
+ *    les imports `.ts`/`.tsx` sont classés « unknown » et AUCUNE règle ne se
+ *    déclenche — le lint passe au vert sans rien vérifier. D'où la
+ *    peerDependency `eslint-import-resolver-typescript`.
+ *
+ * Les patterns ne sont pas ancrés à la racine : ils matchent le segment
+ * correspondant où qu'il soit. `core` couvre donc aussi bien `core/` que
+ * `src/core/`.
+ */
+export default [
+  {
+    files: ["**/*.{js,jsx,ts,tsx,mjs,cjs}"],
+    plugins: { boundaries },
+    settings: {
+      "import/resolver": {
+        typescript: { alwaysTryTypes: true },
+        node: { extensions: [".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs"] },
+      },
+      "boundaries/elements": [
+        { type: "shared-feature", pattern: "features/_shared" },
+        { type: "feature", pattern: "features/*", capture: ["feature"] },
+        { type: "app", pattern: "app" },
+        { type: "core", pattern: "core" },
+        { type: "components", pattern: "components" },
+        { type: "lib", pattern: "lib" },
+      ],
+    },
+    rules: {
+      "boundaries/dependencies": [
+        "error",
+        {
+          default: "disallow",
+          message:
+            "Maedow Arch : {{from.type}} ne peut pas importer {{to.type}}. Voir architecture.md §6.",
+          policies: [
+            // app/ orchestre : il peut tout importer.
+            {
+              from: { element: { type: "app" } },
+              allow: {
+                to: {
+                  element: {
+                    types: {
+                      anyOf: ["app", "feature", "shared-feature", "core", "components", "lib"],
+                    },
+                  },
+                },
+              },
+            },
+            // Une feature descend la pile, mais n'atteint jamais une autre feature.
+            {
+              from: { element: { type: "feature" } },
+              allow: {
+                to: {
+                  element: { types: { anyOf: ["shared-feature", "core", "components", "lib"] } },
+                },
+              },
+            },
+            // ...sauf elle-même : les imports internes à la feature sont libres.
+            {
+              from: { element: { type: "feature" } },
+              allow: {
+                to: { element: { type: "feature", captured: { feature: "{{from.feature}}" } } },
+              },
+            },
+            // features/_shared/ est transverse : il ne connaît aucune feature.
+            {
+              from: { element: { type: "shared-feature" } },
+              allow: {
+                to: {
+                  element: { types: { anyOf: ["shared-feature", "core", "components", "lib"] } },
+                },
+              },
+            },
+            // core/ est le domaine métier : zéro dépendance UI, zéro feature.
+            {
+              from: { element: { type: "core" } },
+              allow: { to: { element: { types: { anyOf: ["core", "lib"] } } } },
+            },
+            // components/ est présentationnel pur.
+            {
+              from: { element: { type: "components" } },
+              allow: { to: { element: { types: { anyOf: ["components", "lib"] } } } },
+            },
+            // lib/ est la feuille de l'arbre : il ne dépend que de lui-même.
+            {
+              from: { element: { type: "lib" } },
+              allow: { to: { element: { type: "lib" } } },
+            },
+          ],
+        },
+      ],
+    },
+  },
+];

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "eslint-config-maedow-arch",
+  "version": "0.1.0",
+  "description": "Règles ESLint de Maedow Arch — enforce les frontières app/features/core/components/lib via eslint-plugin-boundaries",
+  "main": "index.js",
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "keywords": [
+    "eslint",
+    "eslintconfig",
+    "maedow-arch",
+    "architecture",
+    "boundaries",
+    "clean-architecture",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Jean-Marc",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maedow-arch/maedow-arch-docs.git",
+    "directory": "packages/eslint-config-maedow-arch"
+  },
+  "homepage": "https://github.com/maedow-arch/maedow-arch-docs#readme",
+  "bugs": {
+    "url": "https://github.com/maedow-arch/maedow-arch-docs/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "eslint": ">=9",
+    "eslint-import-resolver-typescript": ">=4",
+    "eslint-plugin-boundaries": ">=7"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ]
+}