From 8287c9217877505355db6f1ee0a5f7756047781b 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 f257de7c..d4c461d0 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 abe8e16157d46d6e31ffb386450e354e012c746f 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 6a6f6db4..d7590281 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;