From 0747c9f0e88e1f15be8300a3b77c27393be689a1 Mon Sep 17 00:00:00 2001
From: Florian Duros <florianduros@element.io>
Date: Mon, 15 Sep 2025 18:10:15 +0200
Subject: [PATCH] chore: add storybook a11y plugin (#30763)

---
 .storybook/main.ts     |  2 +-
 .storybook/preview.tsx |  7 +++++++
 package.json           |  1 +
 yarn.lock              | 10 +++++++++-
 4 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/.storybook/main.ts b/.storybook/main.ts
index fc4daac88a..fd1338404f 100644
--- a/.storybook/main.ts
+++ b/.storybook/main.ts
@@ -13,7 +13,7 @@ import { mergeConfig } from "vite";
 const config: StorybookConfig = {
     stories: ["../src/shared-components/**/*.stories.@(js|jsx|mjs|ts|tsx)"],
     staticDirs: ["../webapp"],
-    addons: ["@storybook/addon-docs", "@storybook/addon-designs"],
+    addons: ["@storybook/addon-docs", "@storybook/addon-designs", "@storybook/addon-a11y"],
     framework: "@storybook/react-vite",
     core: {
         disableTelemetry: true,
diff --git a/.storybook/preview.tsx b/.storybook/preview.tsx
index b7f05badf3..aace77bf40 100644
--- a/.storybook/preview.tsx
+++ b/.storybook/preview.tsx
@@ -100,6 +100,13 @@ const preview: Preview = {
                 method: "alphabetical",
             },
         },
+        a11y: {
+            /*
+             * Configure test behavior
+             * See: https://storybook.js.org/docs/next/writing-tests/accessibility-testing#test-behavior
+             */
+            test: "error",
+        },
     },
 };
 
diff --git a/package.json b/package.json
index 52fee35bb8..cad743895b 100644
--- a/package.json
+++ b/package.json
@@ -191,6 +191,7 @@
         "@principalstudio/html-webpack-inject-preload": "^1.2.7",
         "@rrweb/types": "^2.0.0-alpha.18",
         "@sentry/webpack-plugin": "^4.0.0",
+        "@storybook/addon-a11y": "^9.0.18",
         "@storybook/addon-designs": "^10.0.1",
         "@storybook/addon-docs": "^9.0.12",
         "@storybook/icons": "^1.4.0",
diff --git a/yarn.lock b/yarn.lock
index 913f1d8c73..d4d193357f 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -3504,6 +3504,14 @@
   dependencies:
     "@sinonjs/commons" "^3.0.0"
 
+"@storybook/addon-a11y@^9.0.18":
+  version "9.1.6"
+  resolved "https://registry.yarnpkg.com/@storybook/addon-a11y/-/addon-a11y-9.1.6.tgz#a7e253c5a1a381eb4aaeecd47345e935f54cdda4"
+  integrity sha512-jpuzbZlT8G1hx4N6nhhmxy6Lu+Xnz1oeGb2/pm+rKx2fZ4oy7yGRliRNOvpTy8MbkpnfMoLLrcqc66s/kfdf3A==
+  dependencies:
+    "@storybook/global" "^5.0.0"
+    axe-core "^4.2.0"
+
 "@storybook/addon-designs@^10.0.1":
   version "10.0.2"
   resolved "https://registry.yarnpkg.com/@storybook/addon-designs/-/addon-designs-10.0.2.tgz#b889a3b67d88f1cf7a4744865241ea61b88cd760"
@@ -5437,7 +5445,7 @@ axe-core@^4.10.0:
   resolved "https://registry.yarnpkg.com/axe-core/-/axe-core-4.10.2.tgz#85228e3e1d8b8532a27659b332e39b7fa0e022df"
   integrity sha512-RE3mdQ7P3FRSe7eqCWoeQ/Z9QXrtniSjp1wUjt5nRC3WIpz5rSCve6o3fsZ2aCpJtrZjSZgjwXAoTO5k4tEI0w==
 
-axe-core@~4.10.3:
+axe-core@^4.2.0, axe-core@~4.10.3:
   version "4.10.3"
   resolved "https://registry.yarnpkg.com/axe-core/-/axe-core-4.10.3.tgz#04145965ac7894faddbac30861e5d8f11bfd14fc"
   integrity sha512-Xm7bpRXnDSX2YE2YFfBk2FnF0ep6tmG7xPh8iHee8MIcrgq762Nkce856dYtJYLkuIoYZvGfTs/PbZhideTcEg==