From 94aba63a1d904fe01e19c6eda7d2363d0f09135f Mon Sep 17 00:00:00 2001
From: Florian Duros <florian.duros@ormaz.fr>
Date: Thu, 27 Nov 2025 18:04:26 +0100
Subject: [PATCH 1/2] feat(ew-api): add
 `builtins#RoomViewProps#enableReadReceiptsAndMarkersOnActivity`

For the multiroom module, we display several room views at the same
time. In order to avoid all the rooms to send read receipts and markers
automatically when we are interacting with the UI, we add
`enableReadReceiptsAndMarkersOnActivity` props.

When at false, the timeline doesn't listen to user activity to send
these receipts. Only when the room is focused, marker and read receipts
are updated.
---
 packages/element-web-module-api/src/api/builtins.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/element-web-module-api/src/api/builtins.ts b/packages/element-web-module-api/src/api/builtins.ts
index f257de7c20..d4c461d098 100644
--- a/packages/element-web-module-api/src/api/builtins.ts
+++ b/packages/element-web-module-api/src/api/builtins.ts
@@ -30,6 +30,12 @@ export interface RoomViewProps {
      * If true, the widgets will be hidden.
      */
     hideWidgets?: boolean;
+    /**
+     * If true, enable sending read receipts and markers on user activity in the room view. When the user interacts with the room view, read receipts and markers are sent.
+     * If false, the read receipts and markers are only send when the room view is focused. The user has to focus the room view in order to clear any unreads and to move the unread marker to the bottom of the view.
+     * @defaultValue true
+     */
+    enableReadReceiptsAndMarkersOnActivity?: boolean;
 }
 
 /**

From 0126cded9eaa72c6b81868fc01a71e35e5ce4db5 Mon Sep 17 00:00:00 2001
From: Florian Duros <florian.duros@ormaz.fr>
Date: Thu, 4 Dec 2025 12:22:45 +0100
Subject: [PATCH 2/2] doc: update api md doc

---
 packages/element-web-module-api/element-web-module-api.api.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/element-web-module-api/element-web-module-api.api.md b/packages/element-web-module-api/element-web-module-api.api.md
index 6a6f6db490..d7590281ea 100644
--- a/packages/element-web-module-api/element-web-module-api.api.md
+++ b/packages/element-web-module-api/element-web-module-api.api.md
@@ -357,6 +357,7 @@ export interface RoomListStoreApi {
 
 // @alpha
 export interface RoomViewProps {
+    enableReadReceiptsAndMarkersOnActivity?: boolean;
     hideComposer?: boolean;
     hideHeader?: boolean;
     hidePinnedMessageBanner?: boolean;