From 879390f016b312a0e90c83f96b69e4ba81c02f2d Mon Sep 17 00:00:00 2001
From: Julien Gautier <julien.gautier@apf.asso.fr>
Date: Fri, 15 May 2026 12:05:16 +0200
Subject: [PATCH] chore(workspace): tsconfig composite refs + axe-linter
 false-positive config
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Three editor-noise sources, three matching tame:

* Add `composite: true` to lib tsconfig.lib.json files (shared/ui,
  shared/state, feature/auth) and let `nx sync` redirect consumer
  references in apps/portal-{shell,admin}/tsconfig.app.json to point
  at the .lib.json directly. Silences TS6306 ("Referenced project
  must have setting composite: true") that the TS service raises on
  the project references our Nx 22 lib generator emits.

* Add `ignoreDeprecations: "5.0"` on apps/portal-bff/tsconfig.{app,
  spec}.json. Both inherit `moduleResolution: node` / `node10` which
  TS 7.0 will remove; the diagnostic itself suggests the opt-out
  knob. The TS 5.9 we run only accepts "5.0" as the value (the
  warning text mentions "6.0" but TS rejects it). Migration to
  nodenext/node16 is a separate chantier — too entangled with Nest
  CJS semantics for a drive-by.

* Add a repo-level .axe-linter.yml that disables the `list` rule
  globally. axe Linter (VS Code) doesn't understand Angular 17+
  `@for` blocks and flags `@for (...) { <li>… }` as a non-<li>
  child of <ul>/<ol>. Compiler erases the syntax at build time;
  axe-playwright (ADR-0016) operates on the rendered DOM and is
  unaffected.
---
 .axe-linter.yml                     | 14 ++++++++++++++
 apps/portal-admin/tsconfig.app.json |  4 ++--
 apps/portal-bff/tsconfig.app.json   |  3 ++-
 apps/portal-bff/tsconfig.spec.json  |  1 +
 apps/portal-shell/tsconfig.app.json |  6 +++---
 libs/feature/auth/tsconfig.lib.json |  1 +
 libs/shared/state/tsconfig.lib.json |  1 +
 libs/shared/ui/tsconfig.lib.json    |  1 +
 8 files changed, 25 insertions(+), 6 deletions(-)
 create mode 100644 .axe-linter.yml

diff --git a/.axe-linter.yml b/.axe-linter.yml
new file mode 100644
index 0000000..62130ae
--- /dev/null
+++ b/.axe-linter.yml
@@ -0,0 +1,14 @@
+# Deque axe Linter config — silences false positives the static
+# HTML scanner emits against Angular 17+ control-flow blocks
+# (`@for`, `@if`, `@switch`) used inline in templates.
+#
+# The `list` rule (WCAG 1.3.1) flags `@for (item of …) { <li>… }`
+# constructs as if the `@for` text were a non-<li> child of <ul>/<ol>.
+# At build time, the Angular compiler erases those tokens — the
+# rendered DOM only contains <li> children. The axe-playwright suite
+# wired into CI per ADR-0016 runs against the rendered DOM, so the
+# real accessibility contract is enforced there; this file only
+# tames the editor-side noise.
+
+global-disable:
+  - list
diff --git a/apps/portal-admin/tsconfig.app.json b/apps/portal-admin/tsconfig.app.json
index 66d8e42..4ff1d86 100644
--- a/apps/portal-admin/tsconfig.app.json
+++ b/apps/portal-admin/tsconfig.app.json
@@ -8,10 +8,10 @@
   "exclude": ["src/**/*.spec.ts", "src/**/*.test.ts"],
   "references": [
     {
-      "path": "../../libs/shared/ui"
+      "path": "../../libs/shared/ui/tsconfig.lib.json"
     },
     {
-      "path": "../../libs/feature/auth"
+      "path": "../../libs/feature/auth/tsconfig.lib.json"
     }
   ]
 }
diff --git a/apps/portal-bff/tsconfig.app.json b/apps/portal-bff/tsconfig.app.json
index 2106ce4..800bc44 100644
--- a/apps/portal-bff/tsconfig.app.json
+++ b/apps/portal-bff/tsconfig.app.json
@@ -7,7 +7,8 @@
     "experimentalDecorators": true,
     "emitDecoratorMetadata": true,
     "target": "es2021",
-    "moduleResolution": "node"
+    "moduleResolution": "node",
+    "ignoreDeprecations": "5.0"
   },
   "include": ["src/**/*.ts"],
   "exclude": ["jest.config.ts", "jest.config.cts", "src/**/*.spec.ts", "src/**/*.test.ts"]
diff --git a/apps/portal-bff/tsconfig.spec.json b/apps/portal-bff/tsconfig.spec.json
index 01c59b6..062d0ab 100644
--- a/apps/portal-bff/tsconfig.spec.json
+++ b/apps/portal-bff/tsconfig.spec.json
@@ -4,6 +4,7 @@
     "outDir": "../../dist/out-tsc",
     "module": "commonjs",
     "moduleResolution": "node10",
+    "ignoreDeprecations": "5.0",
     "types": ["jest", "node"]
   },
   "include": [
diff --git a/apps/portal-shell/tsconfig.app.json b/apps/portal-shell/tsconfig.app.json
index 804362f..989c317 100644
--- a/apps/portal-shell/tsconfig.app.json
+++ b/apps/portal-shell/tsconfig.app.json
@@ -8,13 +8,13 @@
   "exclude": ["src/**/*.spec.ts", "src/**/*.test.ts"],
   "references": [
     {
-      "path": "../../libs/shared/state"
+      "path": "../../libs/shared/state/tsconfig.lib.json"
     },
     {
-      "path": "../../libs/shared/ui"
+      "path": "../../libs/shared/ui/tsconfig.lib.json"
     },
     {
-      "path": "../../libs/feature/auth"
+      "path": "../../libs/feature/auth/tsconfig.lib.json"
     }
   ]
 }
diff --git a/libs/feature/auth/tsconfig.lib.json b/libs/feature/auth/tsconfig.lib.json
index a9b98ba..a89f7da 100644
--- a/libs/feature/auth/tsconfig.lib.json
+++ b/libs/feature/auth/tsconfig.lib.json
@@ -1,6 +1,7 @@
 {
   "extends": "./tsconfig.json",
   "compilerOptions": {
+    "composite": true,
     "outDir": "../../../dist/out-tsc",
     "declaration": true,
     "declarationMap": true,
diff --git a/libs/shared/state/tsconfig.lib.json b/libs/shared/state/tsconfig.lib.json
index a9b98ba..a89f7da 100644
--- a/libs/shared/state/tsconfig.lib.json
+++ b/libs/shared/state/tsconfig.lib.json
@@ -1,6 +1,7 @@
 {
   "extends": "./tsconfig.json",
   "compilerOptions": {
+    "composite": true,
     "outDir": "../../../dist/out-tsc",
     "declaration": true,
     "declarationMap": true,
diff --git a/libs/shared/ui/tsconfig.lib.json b/libs/shared/ui/tsconfig.lib.json
index a9b98ba..a89f7da 100644
--- a/libs/shared/ui/tsconfig.lib.json
+++ b/libs/shared/ui/tsconfig.lib.json
@@ -1,6 +1,7 @@
 {
   "extends": "./tsconfig.json",
   "compilerOptions": {
+    "composite": true,
     "outDir": "../../../dist/out-tsc",
     "declaration": true,
     "declarationMap": true,