Add tabs to the right panel (#12672)

* Create new method for header button behaviour

With the introduction of tabs, the behaviour of the header buttons is
changed as follows:
- Close any right panel if open
- Open the correct right panel if no panel was open before

The old method (and behaviour) is retained as showOrHidePhase.

* Implement tabs in the right panel

There are three tabs: Info, People and Threads

* Remove unwanted code from RoomSummaryCard

- Remove the menu item for opening the memberlist since that is now
  taken of by the tabs.
- Remove the close button

* Remove code for focusing close button from tac item

See https://github.com/matrix-org/matrix-react-sdk/pull/12410

There's no longer a close button to focus so we instead focus the thread
tab. This is done in RightPaneltabs.tsx so we just need to remove this
code.

* Introduce a room info icon to the header

This was previously present in the legacy room header but not in the new
header.

* BaseCard changes

- Adds id, ariaLabelledBy and role props to implement tab accessibility.
- Adds hideHeaderButtons prop to hide header buttons (think back and
  close buttons).
- Change confusing header rendering code:
  header is not rendered ONLY when no header is passed AND
  hideHeaderButtons is true.

* Refactor repeated code into function

Created a new function createSpaceScopeHeader which returns the
component if the room is a space room. Previously this code was
duplicated in every component that uses SpaceScopeHeader component.

* Pass BaseCard attributes and use helper function

Actually using the code from the last two commits

* Add, update and remove tests/screenshots/snapshots

* Fix distance between search bar and tabs

* Update compound

* Update screenshots/snapshots

src/components/views/right_panel/RightPanelTabs.tsx

@@ -0,0 +1,86 @@
+/*
+Copyright 2024 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import React, { useRef } from "react";
+import { NavBar, NavItem } from "@vector-im/compound-web";
+
+import { _t } from "../../../languageHandler";
+import { RightPanelPhases } from "../../../stores/right-panel/RightPanelStorePhases";
+import RightPanelStore from "../../../stores/right-panel/RightPanelStore";
+import PosthogTrackers from "../../../PosthogTrackers";
+import { useDispatcher } from "../../../hooks/useDispatcher";
+import dispatcher from "../../../dispatcher/dispatcher";
+import { Action } from "../../../dispatcher/actions";
+
+function shouldShowTabsForPhase(phase?: RightPanelPhases): boolean {
+    const tabs = [RightPanelPhases.RoomSummary, RightPanelPhases.RoomMemberList, RightPanelPhases.ThreadPanel];
+    return !!phase && tabs.includes(phase);
+}
+
+type Props = {
+    phase: RightPanelPhases;
+};
+
+export const RightPanelTabs: React.FC<Props> = ({ phase }): JSX.Element | null => {
+    const threadsTabRef = useRef<HTMLButtonElement | null>(null);
+
+    useDispatcher(dispatcher, (payload) => {
+        // This actually focuses the threads tab, as its the only interactive element,
+        // but at least it puts the user in the right area of the app.
+        if (payload.action === Action.FocusThreadsPanel) {
+            threadsTabRef.current?.focus();
+        }
+    });
+
+    if (!shouldShowTabsForPhase(phase)) return null;
+
+    return (
+        <NavBar className="mx_RightPanelTabs" aria-label="right panel" role="tablist">
+            <NavItem
+                aria-controls="room-summary-panel"
+                id="room-summary-panel-tab"
+                onClick={() => {
+                    RightPanelStore.instance.pushCard({ phase: RightPanelPhases.RoomSummary }, true);
+                }}
+                active={phase === RightPanelPhases.RoomSummary}
+            >
+                {_t("right_panel|info")}
+            </NavItem>
+            <NavItem
+                aria-controls="memberlist-panel"
+                id="memberlist-panel-tab"
+                onClick={(ev: React.MouseEvent<HTMLButtonElement, MouseEvent>) => {
+                    RightPanelStore.instance.pushCard({ phase: RightPanelPhases.RoomMemberList }, true);
+                    PosthogTrackers.trackInteraction("WebRightPanelRoomInfoPeopleButton", ev);
+                }}
+                active={phase === RightPanelPhases.RoomMemberList}
+            >
+                {_t("common|people")}
+            </NavItem>
+            <NavItem
+                aria-controls="thread-panel"
+                id="thread-panel-tab"
+                onClick={() => {
+                    RightPanelStore.instance.pushCard({ phase: RightPanelPhases.ThreadPanel }, true);
+                }}
+                active={phase === RightPanelPhases.ThreadPanel}
+                ref={threadsTabRef}
+            >
+                {_t("common|threads")}
+            </NavItem>
+        </NavBar>
+    );
+};