From 966e2cad7ee1587f3d1118b2645c73ccb674ea6c Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Thu, 11 Jun 2020 16:52:47 -0600
Subject: [PATCH 1/7] Update documentation for how this refactoring will go

---
 src/stores/room-list/README.md          |  43 +++++++++++++++---------
 src/stores/room-list/RoomListStore2.png | Bin 0 -> 76264 bytes
 2 files changed, 27 insertions(+), 16 deletions(-)
 create mode 100644 src/stores/room-list/RoomListStore2.png

diff --git a/src/stores/room-list/README.md b/src/stores/room-list/README.md
index ba34691d34..4608570ae9 100644
--- a/src/stores/room-list/README.md
+++ b/src/stores/room-list/README.md
@@ -2,20 +2,31 @@
 
 It's so complicated it needs its own README.
 
+![](./RoomListStore2.png)
+
+Legend:
+* Orange = External event.
+* Purple = Deterministic flow. 
+* Green = Algorithm definition.
+* Red = Exit condition/point.
+* Blue = Process definition.
+
 ## Algorithms involved
 
 There's two main kinds of algorithms involved in the room list store: list ordering and tag sorting.
 Throughout the code an intentional decision has been made to call them the List Algorithm and Sorting
-Algorithm respectively. The list algorithm determines the behaviour of the room list whereas the sorting
-algorithm determines how rooms get ordered within tags affected by the list algorithm.
+Algorithm respectively. The list algorithm determines the primary ordering of a given tag whereas the
+tag sorting defines how rooms within that tag get sorted, at the discretion of the list ordering.
+
+Behaviour of the overall room list (sticky rooms, etc) are determined by the generically-named Algorithm
+class. Here is where much of the coordination from the room list store is done to figure out which list
+algorithm to call, instead of having all the logic in the room list store itself.
 
-Behaviour of the room list takes the shape of determining what features the room list supports, as well
-as determining where and when to apply the sorting algorithm in a tag. The importance algorithm, which
-is described later in this doc, is an example of an algorithm which makes heavy behavioural changes
-to the room list.
 
 Tag sorting is effectively the comparator supplied to the list algorithm. This gives the list algorithm
-the power to decide when and how to apply the tag sorting, if at all.
+the power to decide when and how to apply the tag sorting, if at all. For example, The importance algorithm, 
+later described in this document, heavily uses the list ordering behaviour to break the tag into categories. 
+Each category then gets sorted by the appropriate tag sorting algorithm.
 
 ### Tag sorting algorithm: Alphabetical
 
@@ -70,11 +81,11 @@ Conveniently, each tag gets ordered by those categories as presented: red rooms
 above bold, etc.
 
 Once the algorithm has determined which rooms belong in which categories, the tag sorting algorithm
-gets applied to each category in a sub-sub-list fashion. This should result in the red rooms (for example)
+gets applied to each category in a sub-list fashion. This should result in the red rooms (for example)
 being sorted alphabetically amongst each other as well as the grey rooms sorted amongst each other, but 
 collectively the tag will be sorted into categories with red being at the top.
 
-### Sticky rooms
+## Sticky rooms
 
 When the user visits a room, that room becomes 'sticky' in the list, regardless of ordering algorithm.
 From a code perspective, the underlying algorithm is not aware of a sticky room and instead the base class
@@ -128,13 +139,13 @@ maintain the caching behaviour described above.
 
 ## Class breakdowns
 
-The `RoomListStore` is the major coordinator of various `Algorithm` implementations, which take care 
-of the various `ListAlgorithm` and `SortingAlgorithm` options. The `Algorithm` superclass is also 
-responsible for figuring out which tags get which rooms, as Matrix specifies them as a reverse map: 
-tags get defined on rooms and are not defined as a collection of rooms (unlike how they are presented 
-to the user). Various list-specific utilities are also included, though they are expected to move 
-somewhere more general when needed. For example, the `membership` utilities could easily be moved 
-elsewhere as needed.
+The `RoomListStore` is the major coordinator of various algorithm implementations, which take care 
+of the various `ListAlgorithm` and `SortingAlgorithm` options. The `Algorithm` class is responsible 
+for figuring out which tags get which rooms, as Matrix specifies them as a reverse map: tags get 
+defined on rooms and are not defined as a collection of rooms (unlike how they are presented to the 
+user). Various list-specific utilities are also included, though they are expected to move somewhere 
+more general when needed. For example, the `membership` utilities could easily be moved elsewhere 
+as needed.
 
 The various bits throughout the room list store should also have jsdoc of some kind to help describe
 what they do and how they work.
diff --git a/src/stores/room-list/RoomListStore2.png b/src/stores/room-list/RoomListStore2.png
new file mode 100644
index 0000000000000000000000000000000000000000..9952d1c910f15eb2e8aebbe02b627204dc12d126
GIT binary patch
literal 76264
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

literal 0
HcmV?d00001


From 52b26deb2e281ac57f22d7054233b3c28c8688b8 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Thu, 11 Jun 2020 16:56:12 -0600
Subject: [PATCH 2/7] Move room list store docs to docs directory

This pulls it away from the code, but the code is sufficiently involved enough where it doesn't need another file near it.
---
 .../room-list => docs/img}/RoomListStore2.png       | Bin
 .../room-list/README.md => docs/room-list-store.md  |   2 +-
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename {src/stores/room-list => docs/img}/RoomListStore2.png (100%)
 rename src/stores/room-list/README.md => docs/room-list-store.md (99%)

diff --git a/src/stores/room-list/RoomListStore2.png b/docs/img/RoomListStore2.png
similarity index 100%
rename from src/stores/room-list/RoomListStore2.png
rename to docs/img/RoomListStore2.png
diff --git a/src/stores/room-list/README.md b/docs/room-list-store.md
similarity index 99%
rename from src/stores/room-list/README.md
rename to docs/room-list-store.md
index 4608570ae9..82c83d3593 100644
--- a/src/stores/room-list/README.md
+++ b/docs/room-list-store.md
@@ -2,7 +2,7 @@
 
 It's so complicated it needs its own README.
 
-![](./RoomListStore2.png)
+![](img/RoomListStore2.png)
 
 Legend:
 * Orange = External event.

From fd029e8e8021cdf475d95ed13f65058900695d82 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Thu, 11 Jun 2020 21:24:25 -0600
Subject: [PATCH 3/7] Dumb down list algorithms in favour of smarter tags

This commit is a bit involved, as it factors the tag specific handling out of `/list-ordering` (and moves the `Algorithm` class one higher as a result), leaving it in the `Algorithm`. The algorithms for list ordering now only know how to handle a single tag, and this is managed by the `Algorithm` class - which is also no longer the base class for the list ordering. The list ordering algorithms now inherit from a generic `OrderingAlgorithm` base class which handles some rudimentary things.

Overall the logic hasn't changed much: the tag-specific stuff has been moved into the `Algorithm`, and the list ordering algorithms essentially just removed the iteration on tags. The `RoomListStore2` still shovels a bunch of information over to the `Algorithm`, which can lead to an awkward code flow however this commit is meant to keep the number of surfaces touched to a minimum.

The RoomListStore has also gained the ability to set per-list (tag) ordering and sorting, which is required for the new room list. The assumption that it defaults from the account-level settings is not reviewed by design, yet. This decision is deferred.
---
 src/stores/room-list/RoomListStore2.ts        |  98 +++++---
 .../{list-ordering => }/Algorithm.ts          | 153 ++++++++++---
 .../list-ordering/ImportanceAlgorithm.ts      | 210 +++++++-----------
 .../list-ordering/NaturalAlgorithm.ts         |  43 ++--
 .../list-ordering/OrderingAlgorithm.ts        |  72 ++++++
 .../algorithms/list-ordering/index.ts         |  21 +-
 src/stores/room-list/algorithms/models.ts     |  11 +
 7 files changed, 374 insertions(+), 234 deletions(-)
 rename src/stores/room-list/algorithms/{list-ordering => }/Algorithm.ts (76%)
 create mode 100644 src/stores/room-list/algorithms/list-ordering/OrderingAlgorithm.ts

diff --git a/src/stores/room-list/RoomListStore2.ts b/src/stores/room-list/RoomListStore2.ts
index 63a06dcf81..1c4e66c4b0 100644
--- a/src/stores/room-list/RoomListStore2.ts
+++ b/src/stores/room-list/RoomListStore2.ts
@@ -17,25 +17,21 @@ limitations under the License.
 
 import { MatrixClient } from "matrix-js-sdk/src/client";
 import SettingsStore from "../../settings/SettingsStore";
-import { DefaultTagID, OrderedDefaultTagIDs, RoomUpdateCause, TagID } from "./models";
-import { Algorithm, LIST_UPDATED_EVENT } from "./algorithms/list-ordering/Algorithm";
+import { OrderedDefaultTagIDs, RoomUpdateCause, TagID } from "./models";
 import TagOrderStore from "../TagOrderStore";
 import { AsyncStore } from "../AsyncStore";
 import { Room } from "matrix-js-sdk/src/models/room";
-import { ITagMap, ITagSortingMap, ListAlgorithm, SortAlgorithm } from "./algorithms/models";
-import { getListAlgorithmInstance } from "./algorithms/list-ordering";
+import { IListOrderingMap, ITagMap, ITagSortingMap, ListAlgorithm, SortAlgorithm } from "./algorithms/models";
 import { ActionPayload } from "../../dispatcher/payloads";
 import defaultDispatcher from "../../dispatcher/dispatcher";
 import { readReceiptChangeIsFor } from "../../utils/read-receipts";
 import { IFilterCondition } from "./filters/IFilterCondition";
 import { TagWatcher } from "./TagWatcher";
 import RoomViewStore from "../RoomViewStore";
+import { Algorithm, LIST_UPDATED_EVENT } from "./algorithms/Algorithm";
 
 interface IState {
     tagsEnabled?: boolean;
-
-    preferredSort?: SortAlgorithm;
-    preferredAlgorithm?: ListAlgorithm;
 }
 
 /**
@@ -48,7 +44,7 @@ export class RoomListStore2 extends AsyncStore<ActionPayload> {
     private _matrixClient: MatrixClient;
     private initialListsGenerated = false;
     private enabled = false;
-    private algorithm: Algorithm;
+    private algorithm = new Algorithm();
     private filterConditions: IFilterCondition[] = [];
     private tagWatcher = new TagWatcher(this);
 
@@ -64,6 +60,7 @@ export class RoomListStore2 extends AsyncStore<ActionPayload> {
         this.checkEnabled();
         for (const settingName of this.watchedSettings) SettingsStore.monitorSetting(settingName, null);
         RoomViewStore.addListener(this.onRVSUpdate);
+        this.algorithm.on(LIST_UPDATED_EVENT, this.onAlgorithmListUpdated);
     }
 
     public get orderedLists(): ITagMap {
@@ -85,14 +82,10 @@ export class RoomListStore2 extends AsyncStore<ActionPayload> {
 
     private async readAndCacheSettingsFromStore() {
         const tagsEnabled = SettingsStore.isFeatureEnabled("feature_custom_tags");
-        const orderByImportance = SettingsStore.getValue("RoomList.orderByImportance");
-        const orderAlphabetically = SettingsStore.getValue("RoomList.orderAlphabetically");
         await this.updateState({
             tagsEnabled,
-            preferredSort: orderAlphabetically ? SortAlgorithm.Alphabetic : SortAlgorithm.Recent,
-            preferredAlgorithm: orderByImportance ? ListAlgorithm.Importance : ListAlgorithm.Natural,
         });
-        this.setAlgorithmClass();
+        await this.updateAlgorithmInstances();
     }
 
     private onRVSUpdate = () => {
@@ -259,17 +252,57 @@ export class RoomListStore2 extends AsyncStore<ActionPayload> {
         }
     }
 
-    private getSortAlgorithmFor(tagId: TagID): SortAlgorithm {
-        switch (tagId) {
-            case DefaultTagID.Invite:
-            case DefaultTagID.Untagged:
-            case DefaultTagID.Archived:
-            case DefaultTagID.LowPriority:
-            case DefaultTagID.DM:
-                return this.state.preferredSort;
-            case DefaultTagID.Favourite:
-            default:
-                return SortAlgorithm.Manual;
+    public async setTagSorting(tagId: TagID, sort: SortAlgorithm) {
+        await this.algorithm.setTagSorting(tagId, sort);
+        localStorage.setItem(`mx_tagSort_${tagId}`, sort);
+    }
+
+    public getTagSorting(tagId: TagID): SortAlgorithm {
+        return this.algorithm.getTagSorting(tagId);
+    }
+
+    // noinspection JSMethodCanBeStatic
+    private getStoredTagSorting(tagId: TagID): SortAlgorithm {
+        return <SortAlgorithm>localStorage.getItem(`mx_tagSort_${tagId}`);
+    }
+
+    public async setListOrder(tagId: TagID, order: ListAlgorithm) {
+        await this.algorithm.setListOrdering(tagId, order);
+        localStorage.setItem(`mx_listOrder_${tagId}`, order);
+    }
+
+    public getListOrder(tagId: TagID): ListAlgorithm {
+        return this.algorithm.getListOrdering(tagId);
+    }
+
+    // noinspection JSMethodCanBeStatic
+    private getStoredListOrder(tagId: TagID): ListAlgorithm {
+        return <ListAlgorithm>localStorage.getItem(`mx_listOrder_${tagId}`);
+    }
+
+    private async updateAlgorithmInstances() {
+        const orderByImportance = SettingsStore.getValue("RoomList.orderByImportance");
+        const orderAlphabetically = SettingsStore.getValue("RoomList.orderAlphabetically");
+
+        const defaultSort = orderAlphabetically ? SortAlgorithm.Alphabetic : SortAlgorithm.Recent;
+        const defaultOrder = orderByImportance ? ListAlgorithm.Importance : ListAlgorithm.Natural;
+
+        for (const tag of Object.keys(this.orderedLists)) {
+            const definedSort = this.getTagSorting(tag);
+            const definedOrder = this.getListOrder(tag);
+
+            const storedSort = this.getStoredTagSorting(tag);
+            const storedOrder = this.getStoredListOrder(tag);
+
+            const tagSort = storedSort ? storedSort : (definedSort ? definedSort : defaultSort);
+            const listOrder = storedOrder ? storedOrder : (definedOrder ? definedOrder : defaultOrder);
+
+            if (tagSort !== definedSort) {
+                await this.setTagSorting(tag, tagSort);
+            }
+            if (listOrder !== definedOrder) {
+                await this.setListOrder(tag, listOrder);
+            }
         }
     }
 
@@ -279,15 +312,6 @@ export class RoomListStore2 extends AsyncStore<ActionPayload> {
         await super.updateState(newState);
     }
 
-    private setAlgorithmClass() {
-        if (this.algorithm) {
-            this.algorithm.off(LIST_UPDATED_EVENT, this.onAlgorithmListUpdated);
-        }
-        this.algorithm = getListAlgorithmInstance(this.state.preferredAlgorithm);
-        this.algorithm.setFilterConditions(this.filterConditions);
-        this.algorithm.on(LIST_UPDATED_EVENT, this.onAlgorithmListUpdated);
-    }
-
     private onAlgorithmListUpdated = () => {
         console.log("Underlying algorithm has triggered a list update - refiring");
         this.emit(LISTS_UPDATE_EVENT, this);
@@ -296,9 +320,11 @@ export class RoomListStore2 extends AsyncStore<ActionPayload> {
     private async regenerateAllLists() {
         console.warn("Regenerating all room lists");
 
-        const tags: ITagSortingMap = {};
+        const sorts: ITagSortingMap = {};
+        const orders: IListOrderingMap = {};
         for (const tagId of OrderedDefaultTagIDs) {
-            tags[tagId] = this.getSortAlgorithmFor(tagId);
+            sorts[tagId] = this.getStoredTagSorting(tagId) || SortAlgorithm.Alphabetic;
+            orders[tagId] = this.getStoredListOrder(tagId) || ListAlgorithm.Natural;
         }
 
         if (this.state.tagsEnabled) {
@@ -307,7 +333,7 @@ export class RoomListStore2 extends AsyncStore<ActionPayload> {
             console.log("rtags", roomTags);
         }
 
-        await this.algorithm.populateTags(tags);
+        await this.algorithm.populateTags(sorts, orders);
         await this.algorithm.setKnownRooms(this.matrixClient.getRooms());
 
         this.initialListsGenerated = true;
diff --git a/src/stores/room-list/algorithms/list-ordering/Algorithm.ts b/src/stores/room-list/algorithms/Algorithm.ts
similarity index 76%
rename from src/stores/room-list/algorithms/list-ordering/Algorithm.ts
rename to src/stores/room-list/algorithms/Algorithm.ts
index a8512c0bd6..438ef78e7e 100644
--- a/src/stores/room-list/algorithms/list-ordering/Algorithm.ts
+++ b/src/stores/room-list/algorithms/Algorithm.ts
@@ -14,17 +14,25 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
-import { DefaultTagID, RoomUpdateCause, TagID } from "../../models";
 import { Room } from "matrix-js-sdk/src/models/room";
 import { isNullOrUndefined } from "matrix-js-sdk/src/utils";
-import { EffectiveMembership, splitRoomsByMembership } from "../../membership";
-import { ITagMap, ITagSortingMap } from "../models";
-import DMRoomMap from "../../../../utils/DMRoomMap";
-import { FILTER_CHANGED, FilterPriority, IFilterCondition } from "../../filters/IFilterCondition";
+import DMRoomMap from "../../../utils/DMRoomMap";
 import { EventEmitter } from "events";
-import { UPDATE_EVENT } from "../../../AsyncStore";
-import { ArrayUtil } from "../../../../utils/arrays";
-import { getEnumValues } from "../../../../utils/enums";
+import { arrayHasDiff, ArrayUtil } from "../../../utils/arrays";
+import { getEnumValues } from "../../../utils/enums";
+import { DefaultTagID, RoomUpdateCause, TagID } from "../models";
+import {
+    IListOrderingMap,
+    IOrderingAlgorithmMap,
+    ITagMap,
+    ITagSortingMap,
+    ListAlgorithm,
+    SortAlgorithm
+} from "./models";
+import { FILTER_CHANGED, FilterPriority, IFilterCondition } from "../filters/IFilterCondition";
+import { EffectiveMembership, splitRoomsByMembership } from "../membership";
+import { OrderingAlgorithm } from "./list-ordering/OrderingAlgorithm";
+import { getListAlgorithmInstance } from "./list-ordering";
 
 // TODO: Add locking support to avoid concurrent writes?
 
@@ -44,21 +52,22 @@ interface IStickyRoom {
  * management (which rooms go in which tags) and ask the implementation to
  * deal with ordering mechanics.
  */
-export abstract class Algorithm extends EventEmitter {
+export class Algorithm extends EventEmitter {
     private _cachedRooms: ITagMap = {};
     private _cachedStickyRooms: ITagMap = {}; // a clone of the _cachedRooms, with the sticky room
     private filteredRooms: ITagMap = {};
     private _stickyRoom: IStickyRoom = null;
-
-    protected sortAlgorithms: ITagSortingMap;
-    protected rooms: Room[] = [];
-    protected roomIdsToTags: {
+    private sortAlgorithms: ITagSortingMap;
+    private listAlgorithms: IListOrderingMap;
+    private algorithms: IOrderingAlgorithmMap;
+    private rooms: Room[] = [];
+    private roomIdsToTags: {
         [roomId: string]: TagID[];
     } = {};
-    protected allowedByFilter: Map<IFilterCondition, Room[]> = new Map<IFilterCondition, Room[]>();
-    protected allowedRoomsByFilters: Set<Room> = new Set<Room>();
+    private allowedByFilter: Map<IFilterCondition, Room[]> = new Map<IFilterCondition, Room[]>();
+    private allowedRoomsByFilters: Set<Room> = new Set<Room>();
 
-    protected constructor() {
+    public constructor() {
         super();
     }
 
@@ -68,6 +77,7 @@ export abstract class Algorithm extends EventEmitter {
 
     public set stickyRoom(val: Room) {
         // setters can't be async, so we call a private function to do the work
+        // noinspection JSIgnoredPromiseFromCall
         this.updateStickyRoom(val);
     }
 
@@ -89,14 +99,38 @@ export abstract class Algorithm extends EventEmitter {
         return this._cachedRooms;
     }
 
-    /**
-     * Sets the filter conditions the Algorithm should use.
-     * @param filterConditions The filter conditions to use.
-     */
-    public setFilterConditions(filterConditions: IFilterCondition[]): void {
-        for (const filter of filterConditions) {
-            this.addFilterCondition(filter);
-        }
+    public getTagSorting(tagId: TagID): SortAlgorithm {
+        return this.sortAlgorithms[tagId];
+    }
+
+    public async setTagSorting(tagId: TagID, sort: SortAlgorithm) {
+        if (!tagId) throw new Error("Tag ID must be defined");
+        if (!sort) throw new Error("Algorithm must be defined");
+        this.sortAlgorithms[tagId] = sort;
+
+        const algorithm: OrderingAlgorithm = this.algorithms[tagId];
+        await algorithm.setSortAlgorithm(sort);
+        this._cachedRooms[tagId] = algorithm.orderedRooms;
+        this.recalculateFilteredRoomsForTag(tagId); // update filter to re-sort the list
+        this.recalculateStickyRoom(tagId); // update sticky room to make sure it appears if needed
+    }
+
+    public getListOrdering(tagId: TagID): ListAlgorithm {
+        return this.listAlgorithms[tagId];
+    }
+
+    public async setListOrdering(tagId: TagID, order: ListAlgorithm) {
+        if (!tagId) throw new Error("Tag ID must be defined");
+        if (!order) throw new Error("Algorithm must be defined");
+        this.listAlgorithms[tagId] = order;
+
+        const algorithm = getListAlgorithmInstance(order, tagId, this.sortAlgorithms[tagId]);
+        this.algorithms[tagId] = algorithm;
+
+        await algorithm.setRooms(this._cachedRooms[tagId])
+        this._cachedRooms[tagId] = algorithm.orderedRooms;
+        this.recalculateFilteredRoomsForTag(tagId); // update filter to re-sort the list
+        this.recalculateStickyRoom(tagId); // update sticky room to make sure it appears if needed
     }
 
     public addFilterCondition(filterCondition: IFilterCondition): void {
@@ -310,11 +344,21 @@ export abstract class Algorithm extends EventEmitter {
      * as reference for which lists to generate and which way to generate
      * them.
      * @param {ITagSortingMap} tagSortingMap The tags to generate.
+     * @param {IListOrderingMap} listOrderingMap The ordering of those tags.
      * @returns {Promise<*>} A promise which resolves when complete.
      */
-    public async populateTags(tagSortingMap: ITagSortingMap): Promise<any> {
-        if (!tagSortingMap) throw new Error(`Map cannot be null or empty`);
+    public async populateTags(tagSortingMap: ITagSortingMap, listOrderingMap: IListOrderingMap): Promise<any> {
+        if (!tagSortingMap) throw new Error(`Sorting map cannot be null or empty`);
+        if (!listOrderingMap) throw new Error(`Ordering ma cannot be null or empty`);
+        if (arrayHasDiff(Object.keys(tagSortingMap), Object.keys(listOrderingMap))) {
+            throw new Error(`Both maps must contain the exact same tags`);
+        }
         this.sortAlgorithms = tagSortingMap;
+        this.listAlgorithms = listOrderingMap;
+        this.algorithms = {};
+        for (const tag of Object.keys(tagSortingMap)) {
+            this.algorithms[tag] = getListAlgorithmInstance(this.listAlgorithms[tag], tag, this.sortAlgorithms[tag]);
+        }
         return this.setKnownRooms(this.rooms);
     }
 
@@ -428,7 +472,17 @@ export abstract class Algorithm extends EventEmitter {
      * be mutated in place.
      * @returns {Promise<*>} A promise which resolves when complete.
      */
-    protected abstract generateFreshTags(updatedTagMap: ITagMap): Promise<any>;
+    private async generateFreshTags(updatedTagMap: ITagMap): Promise<any> {
+        if (!this.algorithms) throw new Error("Not ready: no algorithms to determine tags from");
+
+        for (const tag of Object.keys(updatedTagMap)) {
+            const algorithm: OrderingAlgorithm = this.algorithms[tag];
+            if (!algorithm) throw new Error(`No algorithm for ${tag}`);
+
+            await algorithm.setRooms(updatedTagMap[tag]);
+            updatedTagMap[tag] = algorithm.orderedRooms;
+        }
+    }
 
     /**
      * Asks the Algorithm to update its knowledge of a room. For example, when
@@ -441,5 +495,48 @@ export abstract class Algorithm extends EventEmitter {
      * depending on whether or not getOrderedRooms() should be called after
      * processing.
      */
-    public abstract handleRoomUpdate(room: Room, cause: RoomUpdateCause): Promise<boolean>;
+    public async handleRoomUpdate(room: Room, cause: RoomUpdateCause): Promise<boolean> {
+        if (!this.algorithms) throw new Error("Not ready: no algorithms to determine tags from");
+
+        if (cause === RoomUpdateCause.PossibleTagChange) {
+            // TODO: Be smarter and splice rather than regen the planet.
+            // TODO: No-op if no change.
+            await this.setKnownRooms(this.rooms);
+            return true;
+        }
+
+        if (cause === RoomUpdateCause.NewRoom) {
+            // TODO: Be smarter and insert rather than regen the planet.
+            await this.setKnownRooms([room, ...this.rooms]);
+            return;
+        }
+
+        if (cause === RoomUpdateCause.RoomRemoved) {
+            // TODO: Be smarter and splice rather than regen the planet.
+            await this.setKnownRooms(this.rooms.filter(r => r !== room));
+            return true;
+        }
+
+        let tags = this.roomIdsToTags[room.roomId];
+        if (!tags) {
+            console.warn(`No tags known for "${room.name}" (${room.roomId})`);
+            return false;
+        }
+
+        let changed = false;
+        for (const tag of tags) {
+            const algorithm: OrderingAlgorithm = this.algorithms[tag];
+            if (!algorithm) throw new Error(`No algorithm for ${tag}`);
+
+            await algorithm.handleRoomUpdate(room, cause);
+            this.cachedRooms[tag] = algorithm.orderedRooms;
+
+            // Flag that we've done something
+            this.recalculateFilteredRoomsForTag(tag); // update filter to re-sort the list
+            this.recalculateStickyRoom(tag); // update sticky room to make sure it appears if needed
+            changed = true;
+        }
+
+        return true;
+    };
 }
diff --git a/src/stores/room-list/algorithms/list-ordering/ImportanceAlgorithm.ts b/src/stores/room-list/algorithms/list-ordering/ImportanceAlgorithm.ts
index 7cbcc504c2..2e24cb23f1 100644
--- a/src/stores/room-list/algorithms/list-ordering/ImportanceAlgorithm.ts
+++ b/src/stores/room-list/algorithms/list-ordering/ImportanceAlgorithm.ts
@@ -15,12 +15,12 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
-import { Algorithm } from "./Algorithm";
 import { Room } from "matrix-js-sdk/src/models/room";
 import { RoomUpdateCause, TagID } from "../../models";
-import { ITagMap, SortAlgorithm } from "../models";
+import { SortAlgorithm } from "../models";
 import { sortRoomsWithAlgorithm } from "../tag-sorting";
 import * as Unread from '../../../../Unread';
+import { OrderingAlgorithm } from "./OrderingAlgorithm";
 
 /**
  * The determined category of a room.
@@ -77,32 +77,16 @@ const CATEGORY_ORDER = [Category.Red, Category.Grey, Category.Bold, Category.Idl
  * within the same category. For more information, see the comments contained
  * within the class.
  */
-export class ImportanceAlgorithm extends Algorithm {
+export class ImportanceAlgorithm extends OrderingAlgorithm {
+    // This tracks the category for the tag it represents by tracking the index of
+    // each category within the list, where zero is the top of the list. This then
+    // tracks when rooms change categories and splices the orderedRooms array as
+    // needed, preventing many ordering operations.
 
-    // HOW THIS WORKS
-    // --------------
-    //
-    // This block of comments assumes you've read the README two levels higher.
-    // You should do that if you haven't already.
-    //
-    // Tags are fed into the algorithmic functions from the Algorithm superclass,
-    // which cause subsequent updates to the room list itself. Categories within
-    // those tags are tracked as index numbers within the array (zero = top), with
-    // each sticky room being tracked separately. Internally, the category index
-    // can be found from `this.indices[tag][category]`.
-    //
-    // The room list store is always provided with the `this.cachedRooms` results, which are
-    // updated as needed and not recalculated often. For example, when a room needs to
-    // move within a tag, the array in `this.cachedRooms` will be spliced instead of iterated.
-    // The `indices` help track the positions of each category to make splicing easier.
+    private indices: ICategoryIndex = {};
 
-    private indices: {
-        // @ts-ignore - TS wants this to be a string but we know better than it
-        [tag: TagID]: ICategoryIndex;
-    } = {};
-
-    constructor() {
-        super();
+    public constructor(tagId: TagID, initialSortingAlgorithm: SortAlgorithm) {
+        super(tagId, initialSortingAlgorithm);
         console.log("Constructed an ImportanceAlgorithm");
     }
 
@@ -143,122 +127,81 @@ export class ImportanceAlgorithm extends Algorithm {
         return Category.Idle;
     }
 
-    protected async generateFreshTags(updatedTagMap: ITagMap): Promise<any> {
-        for (const tagId of Object.keys(updatedTagMap)) {
-            const unorderedRooms = updatedTagMap[tagId];
-
-            const sortBy = this.sortAlgorithms[tagId];
-            if (!sortBy) throw new Error(`${tagId} does not have a sorting algorithm`);
-
-            if (sortBy === SortAlgorithm.Manual) {
-                // Manual tags essentially ignore the importance algorithm, so don't do anything
-                // special about them.
-                updatedTagMap[tagId] = await sortRoomsWithAlgorithm(unorderedRooms, tagId, sortBy);
-            } else {
-                // Every other sorting type affects the categories, not the whole tag.
-                const categorized = this.categorizeRooms(unorderedRooms);
-                for (const category of Object.keys(categorized)) {
-                    const roomsToOrder = categorized[category];
-                    categorized[category] = await sortRoomsWithAlgorithm(roomsToOrder, tagId, sortBy);
-                }
-
-                const newlyOrganized: Room[] = [];
-                const newIndices: ICategoryIndex = {};
-
-                for (const category of CATEGORY_ORDER) {
-                    newIndices[category] = newlyOrganized.length;
-                    newlyOrganized.push(...categorized[category]);
-                }
-
-                this.indices[tagId] = newIndices;
-                updatedTagMap[tagId] = newlyOrganized;
+    public async setRooms(rooms: Room[]): Promise<any> {
+        if (this.sortingAlgorithm === SortAlgorithm.Manual) {
+            this.cachedOrderedRooms = await sortRoomsWithAlgorithm(rooms, this.tagId, this.sortingAlgorithm);
+        } else {
+            // Every other sorting type affects the categories, not the whole tag.
+            const categorized = this.categorizeRooms(rooms);
+            for (const category of Object.keys(categorized)) {
+                const roomsToOrder = categorized[category];
+                categorized[category] = await sortRoomsWithAlgorithm(roomsToOrder, this.tagId, this.sortingAlgorithm);
             }
+
+            const newlyOrganized: Room[] = [];
+            const newIndices: ICategoryIndex = {};
+
+            for (const category of CATEGORY_ORDER) {
+                newIndices[category] = newlyOrganized.length;
+                newlyOrganized.push(...categorized[category]);
+            }
+
+            this.indices = newIndices;
+            this.cachedOrderedRooms = newlyOrganized;
         }
     }
 
     public async handleRoomUpdate(room: Room, cause: RoomUpdateCause): Promise<boolean> {
-        if (cause === RoomUpdateCause.PossibleTagChange) {
-            // TODO: Be smarter and splice rather than regen the planet.
-            // TODO: No-op if no change.
-            await this.setKnownRooms(this.rooms);
-            return;
-        }
-
-        if (cause === RoomUpdateCause.NewRoom) {
-            // TODO: Be smarter and insert rather than regen the planet.
-            await this.setKnownRooms([room, ...this.rooms]);
-            return;
-        }
-
-        if (cause === RoomUpdateCause.RoomRemoved) {
-            // TODO: Be smarter and splice rather than regen the planet.
-            await this.setKnownRooms(this.rooms.filter(r => r !== room));
-            return;
-        }
-
-        let tags = this.roomIdsToTags[room.roomId];
-        if (!tags) {
-            console.warn(`No tags known for "${room.name}" (${room.roomId})`);
-            return false;
-        }
         const category = this.getRoomCategory(room);
-        let changed = false;
-        for (const tag of tags) {
-            if (this.sortAlgorithms[tag] === SortAlgorithm.Manual) {
-                continue; // Nothing to do here.
-            }
-
-            const taggedRooms = this.cachedRooms[tag];
-            const indices = this.indices[tag];
-            let roomIdx = taggedRooms.indexOf(room);
-            if (roomIdx === -1) {
-                console.warn(`Degrading performance to find missing room in "${tag}": ${room.roomId}`);
-                roomIdx = taggedRooms.findIndex(r => r.roomId === room.roomId);
-            }
-            if (roomIdx === -1) {
-                throw new Error(`Room ${room.roomId} has no index in ${tag}`);
-            }
-
-            // Try to avoid doing array operations if we don't have to: only move rooms within
-            // the categories if we're jumping categories
-            const oldCategory = this.getCategoryFromIndices(roomIdx, indices);
-            if (oldCategory !== category) {
-                // Move the room and update the indices
-                this.moveRoomIndexes(1, oldCategory, category, indices);
-                taggedRooms.splice(roomIdx, 1); // splice out the old index (fixed position)
-                taggedRooms.splice(indices[category], 0, room); // splice in the new room (pre-adjusted)
-                // Note: if moveRoomIndexes() is called after the splice then the insert operation
-                // will happen in the wrong place. Because we would have already adjusted the index
-                // for the category, we don't need to determine how the room is moving in the list.
-                // If we instead tried to insert before updating the indices, we'd have to determine
-                // whether the room was moving later (towards IDLE) or earlier (towards RED) from its
-                // current position, as it'll affect the category's start index after we remove the
-                // room from the array.
-            }
-
-            // The room received an update, so take out the slice and sort it. This should be relatively
-            // quick because the room is inserted at the top of the category, and most popular sorting
-            // algorithms will deal with trying to keep the active room at the top/start of the category.
-            // For the few algorithms that will have to move the thing quite far (alphabetic with a Z room
-            // for example), the list should already be sorted well enough that it can rip through the
-            // array and slot the changed room in quickly.
-            const nextCategoryStartIdx = category === CATEGORY_ORDER[CATEGORY_ORDER.length - 1]
-                ? Number.MAX_SAFE_INTEGER
-                : indices[CATEGORY_ORDER[CATEGORY_ORDER.indexOf(category) + 1]];
-            const startIdx = indices[category];
-            const numSort = nextCategoryStartIdx - startIdx; // splice() returns up to the max, so MAX_SAFE_INT is fine
-            const unsortedSlice = taggedRooms.splice(startIdx, numSort);
-            const sorted = await sortRoomsWithAlgorithm(unsortedSlice, tag, this.sortAlgorithms[tag]);
-            taggedRooms.splice(startIdx, 0, ...sorted);
-
-            // Finally, flag that we've done something
-            this.recalculateFilteredRoomsForTag(tag); // update filter to re-sort the list
-            this.recalculateStickyRoom(tag); // update sticky room to make sure it appears if needed
-            changed = true;
+        if (this.sortingAlgorithm === SortAlgorithm.Manual) {
+            return; // Nothing to do here.
         }
-        return changed;
+
+        let roomIdx = this.cachedOrderedRooms.indexOf(room);
+        if (roomIdx === -1) { // can only happen if the js-sdk's store goes sideways.
+            console.warn(`Degrading performance to find missing room in "${this.tagId}": ${room.roomId}`);
+            roomIdx = this.cachedOrderedRooms.findIndex(r => r.roomId === room.roomId);
+        }
+        if (roomIdx === -1) {
+            throw new Error(`Room ${room.roomId} has no index in ${this.tagId}`);
+        }
+
+        // Try to avoid doing array operations if we don't have to: only move rooms within
+        // the categories if we're jumping categories
+        const oldCategory = this.getCategoryFromIndices(roomIdx, this.indices);
+        if (oldCategory !== category) {
+            // Move the room and update the indices
+            this.moveRoomIndexes(1, oldCategory, category, this.indices);
+            this.cachedOrderedRooms.splice(roomIdx, 1); // splice out the old index (fixed position)
+            this.cachedOrderedRooms.splice(this.indices[category], 0, room); // splice in the new room (pre-adjusted)
+            // Note: if moveRoomIndexes() is called after the splice then the insert operation
+            // will happen in the wrong place. Because we would have already adjusted the index
+            // for the category, we don't need to determine how the room is moving in the list.
+            // If we instead tried to insert before updating the indices, we'd have to determine
+            // whether the room was moving later (towards IDLE) or earlier (towards RED) from its
+            // current position, as it'll affect the category's start index after we remove the
+            // room from the array.
+        }
+
+        // The room received an update, so take out the slice and sort it. This should be relatively
+        // quick because the room is inserted at the top of the category, and most popular sorting
+        // algorithms will deal with trying to keep the active room at the top/start of the category.
+        // For the few algorithms that will have to move the thing quite far (alphabetic with a Z room
+        // for example), the list should already be sorted well enough that it can rip through the
+        // array and slot the changed room in quickly.
+        const nextCategoryStartIdx = category === CATEGORY_ORDER[CATEGORY_ORDER.length - 1]
+            ? Number.MAX_SAFE_INTEGER
+            : this.indices[CATEGORY_ORDER[CATEGORY_ORDER.indexOf(category) + 1]];
+        const startIdx = this.indices[category];
+        const numSort = nextCategoryStartIdx - startIdx; // splice() returns up to the max, so MAX_SAFE_INT is fine
+        const unsortedSlice = this.cachedOrderedRooms.splice(startIdx, numSort);
+        const sorted = await sortRoomsWithAlgorithm(unsortedSlice, this.tagId, this.sortingAlgorithm);
+        this.cachedOrderedRooms.splice(startIdx, 0, ...sorted);
+
+        return true; // change made
     }
 
+    // noinspection JSMethodCanBeStatic
     private getCategoryFromIndices(index: number, indices: ICategoryIndex): Category {
         for (let i = 0; i < CATEGORY_ORDER.length; i++) {
             const category = CATEGORY_ORDER[i];
@@ -274,6 +217,7 @@ export class ImportanceAlgorithm extends Algorithm {
         throw new Error("Programming error: somehow you've ended up with an index that isn't in a category");
     }
 
+    // noinspection JSMethodCanBeStatic
     private moveRoomIndexes(nRooms: number, fromCategory: Category, toCategory: Category, indices: ICategoryIndex) {
         // We have to update the index of the category *after* the from/toCategory variables
         // in order to update the indices correctly. Because the room is moving from/to those
diff --git a/src/stores/room-list/algorithms/list-ordering/NaturalAlgorithm.ts b/src/stores/room-list/algorithms/list-ordering/NaturalAlgorithm.ts
index d544b1196f..2302768fbf 100644
--- a/src/stores/room-list/algorithms/list-ordering/NaturalAlgorithm.ts
+++ b/src/stores/room-list/algorithms/list-ordering/NaturalAlgorithm.ts
@@ -14,49 +14,32 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
-import { Algorithm } from "./Algorithm";
-import { ITagMap } from "../models";
+import { SortAlgorithm } from "../models";
 import { sortRoomsWithAlgorithm } from "../tag-sorting";
+import { OrderingAlgorithm } from "./OrderingAlgorithm";
+import { TagID } from "../../models";
+import { Room } from "matrix-js-sdk/src/models/room";
 
 /**
  * Uses the natural tag sorting algorithm order to determine tag ordering. No
  * additional behavioural changes are present.
  */
-export class NaturalAlgorithm extends Algorithm {
+export class NaturalAlgorithm extends OrderingAlgorithm {
 
-    constructor() {
-        super();
+    public constructor(tagId: TagID, initialSortingAlgorithm: SortAlgorithm) {
+        super(tagId, initialSortingAlgorithm);
         console.log("Constructed a NaturalAlgorithm");
     }
 
-    protected async generateFreshTags(updatedTagMap: ITagMap): Promise<any> {
-        for (const tagId of Object.keys(updatedTagMap)) {
-            const unorderedRooms = updatedTagMap[tagId];
-
-            const sortBy = this.sortAlgorithms[tagId];
-            if (!sortBy) throw new Error(`${tagId} does not have a sorting algorithm`);
-
-            updatedTagMap[tagId] = await sortRoomsWithAlgorithm(unorderedRooms, tagId, sortBy);
-        }
+    public async setRooms(rooms: Room[]): Promise<any> {
+        this.cachedOrderedRooms = await sortRoomsWithAlgorithm(rooms, this.tagId, this.sortingAlgorithm);
     }
 
     public async handleRoomUpdate(room, cause): Promise<boolean> {
-        const tags = this.roomIdsToTags[room.roomId];
-        if (!tags) {
-            console.warn(`No tags known for "${room.name}" (${room.roomId})`);
-            return false;
-        }
-        let changed = false;
-        for (const tag of tags) {
-            // TODO: Optimize this loop to avoid useless operations
-            // For example, we can skip updates to alphabetic (sometimes) and manually ordered tags
-            this.cachedRooms[tag] = await sortRoomsWithAlgorithm(this.cachedRooms[tag], tag, this.sortAlgorithms[tag]);
+        // TODO: Optimize this to avoid useless operations
+        // For example, we can skip updates to alphabetic (sometimes) and manually ordered tags
+        this.cachedOrderedRooms = await sortRoomsWithAlgorithm(this.cachedOrderedRooms, this.tagId, this.sortingAlgorithm);
 
-            // Flag that we've done something
-            this.recalculateFilteredRoomsForTag(tag); // update filter to re-sort the list
-            this.recalculateStickyRoom(tag); // update sticky room to make sure it appears if needed
-            changed = true;
-        }
-        return changed;
+        return true;
     }
 }
diff --git a/src/stores/room-list/algorithms/list-ordering/OrderingAlgorithm.ts b/src/stores/room-list/algorithms/list-ordering/OrderingAlgorithm.ts
new file mode 100644
index 0000000000..263e8a4cd4
--- /dev/null
+++ b/src/stores/room-list/algorithms/list-ordering/OrderingAlgorithm.ts
@@ -0,0 +1,72 @@
+/*
+Copyright 2020 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 { Room } from "matrix-js-sdk/src/models/room";
+import { RoomUpdateCause, TagID } from "../../models";
+import { SortAlgorithm } from "../models";
+
+/**
+ * Represents a list ordering algorithm. Subclasses should populate the
+ * `cachedOrderedRooms` field.
+ */
+export abstract class OrderingAlgorithm {
+    protected cachedOrderedRooms: Room[];
+    protected sortingAlgorithm: SortAlgorithm;
+
+    protected constructor(protected tagId: TagID, initialSortingAlgorithm: SortAlgorithm) {
+        // noinspection JSIgnoredPromiseFromCall
+        this.setSortAlgorithm(initialSortingAlgorithm); // we use the setter for validation
+    }
+
+    /**
+     * The rooms as ordered by the algorithm.
+     */
+    public get orderedRooms(): Room[] {
+        return this.cachedOrderedRooms || [];
+    }
+
+    /**
+     * Sets the sorting algorithm to use within the list.
+     * @param newAlgorithm The new algorithm. Must be defined.
+     * @returns Resolves when complete.
+     */
+    public async setSortAlgorithm(newAlgorithm: SortAlgorithm) {
+        if (!newAlgorithm) throw new Error("A sorting algorithm must be defined");
+        this.sortingAlgorithm = newAlgorithm;
+
+        // Force regeneration of the rooms
+        await this.setRooms(this.orderedRooms);
+    }
+
+    /**
+     * Sets the rooms the algorithm should be handling, implying a reconstruction
+     * of the ordering.
+     * @param rooms The rooms to use going forward.
+     * @returns Resolves when complete.
+     */
+    public abstract setRooms(rooms: Room[]): Promise<any>;
+
+    /**
+     * Handle a room update. The Algorithm will only call this for causes which
+     * the list ordering algorithm can handle within the same tag. For example,
+     * tag changes will not be sent here.
+     * @param room The room where the update happened.
+     * @param cause The cause of the update.
+     * @returns True if the update requires the Algorithm to update the presentation layers.
+     */
+    // XXX: TODO: We assume this will only ever be a position update and NOT a NewRoom or RemoveRoom change!!
+    public abstract handleRoomUpdate(room: Room, cause: RoomUpdateCause): Promise<boolean>;
+}
diff --git a/src/stores/room-list/algorithms/list-ordering/index.ts b/src/stores/room-list/algorithms/list-ordering/index.ts
index bcccd150cd..8156c3a250 100644
--- a/src/stores/room-list/algorithms/list-ordering/index.ts
+++ b/src/stores/room-list/algorithms/list-ordering/index.ts
@@ -14,25 +14,32 @@ See the License for the specific language governing permissions and
 limitations under the License.
 */
 
-import { Algorithm } from "./Algorithm";
 import { ImportanceAlgorithm } from "./ImportanceAlgorithm";
-import { ListAlgorithm } from "../models";
+import { ListAlgorithm, SortAlgorithm } from "../models";
 import { NaturalAlgorithm } from "./NaturalAlgorithm";
+import { TagID } from "../../models";
+import { OrderingAlgorithm } from "./OrderingAlgorithm";
 
-const ALGORITHM_FACTORIES: { [algorithm in ListAlgorithm]: () => Algorithm } = {
-    [ListAlgorithm.Natural]: () => new NaturalAlgorithm(),
-    [ListAlgorithm.Importance]: () => new ImportanceAlgorithm(),
+interface AlgorithmFactory {
+    (tagId: TagID, initialSortingAlgorithm: SortAlgorithm): OrderingAlgorithm;
+}
+
+const ALGORITHM_FACTORIES: { [algorithm in ListAlgorithm]: AlgorithmFactory } = {
+    [ListAlgorithm.Natural]: (tagId, initSort) => new NaturalAlgorithm(tagId, initSort),
+    [ListAlgorithm.Importance]: (tagId, initSort) => new ImportanceAlgorithm(tagId, initSort),
 };
 
 /**
  * Gets an instance of the defined algorithm
  * @param {ListAlgorithm} algorithm The algorithm to get an instance of.
+ * @param {TagID} tagId The tag the algorithm is for.
+ * @param {SortAlgorithm} initSort The initial sorting algorithm for the ordering algorithm.
  * @returns {Algorithm} The algorithm instance.
  */
-export function getListAlgorithmInstance(algorithm: ListAlgorithm): Algorithm {
+export function getListAlgorithmInstance(algorithm: ListAlgorithm, tagId: TagID, initSort: SortAlgorithm): OrderingAlgorithm {
     if (!ALGORITHM_FACTORIES[algorithm]) {
         throw new Error(`${algorithm} is not a known algorithm`);
     }
 
-    return ALGORITHM_FACTORIES[algorithm]();
+    return ALGORITHM_FACTORIES[algorithm](tagId, initSort);
 }
diff --git a/src/stores/room-list/algorithms/models.ts b/src/stores/room-list/algorithms/models.ts
index 284600a776..943d833b67 100644
--- a/src/stores/room-list/algorithms/models.ts
+++ b/src/stores/room-list/algorithms/models.ts
@@ -16,6 +16,7 @@ limitations under the License.
 
 import { TagID } from "../models";
 import { Room } from "matrix-js-sdk/src/models/room";
+import { OrderingAlgorithm } from "./list-ordering/OrderingAlgorithm";
 
 export enum SortAlgorithm {
     Manual = "MANUAL",
@@ -36,6 +37,16 @@ export interface ITagSortingMap {
     [tagId: TagID]: SortAlgorithm;
 }
 
+export interface IListOrderingMap {
+    // @ts-ignore - TypeScript really wants this to be [tagId: string] but we know better.
+    [tagId: TagID]: ListAlgorithm;
+}
+
+export interface IOrderingAlgorithmMap {
+    // @ts-ignore - TypeScript really wants this to be [tagId: string] but we know better.
+    [tagId: TagID]: OrderingAlgorithm;
+}
+
 export interface ITagMap {
     // @ts-ignore - TypeScript really wants this to be [tagId: string] but we know better.
     [tagId: TagID]: Room[];

From 4aa15ee19187d4e8f9b9bc22176a1919ab28cd81 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Thu, 11 Jun 2020 22:04:10 -0600
Subject: [PATCH 4/7] Wire up the context menu to the room list store

Updates are passed along magically to the sublist, so we don't need to listen for the room list store's response to our changes.

This just hits the functions introduced in the last commit.
---
 res/css/views/rooms/_RoomSublist2.scss      | 10 +++++-
 src/components/views/rooms/RoomSublist2.tsx | 35 +++++++++++++++++----
 src/i18n/strings/en_EN.json                 |  2 ++
 3 files changed, 40 insertions(+), 7 deletions(-)

diff --git a/res/css/views/rooms/_RoomSublist2.scss b/res/css/views/rooms/_RoomSublist2.scss
index ed17c071b6..afedf64e32 100644
--- a/res/css/views/rooms/_RoomSublist2.scss
+++ b/res/css/views/rooms/_RoomSublist2.scss
@@ -240,6 +240,14 @@ limitations under the License.
         font-size: $font-15px;
         line-height: $font-20px;
         font-weight: 600;
-        margin-bottom: 12px;
+        margin-bottom: 4px;
+    }
+
+    .mx_RadioButton, .mx_Checkbox {
+        margin-top: 8px;
+    }
+
+    .mx_Checkbox {
+        margin-left: -8px; // to counteract the indent from the component
     }
 }
diff --git a/src/components/views/rooms/RoomSublist2.tsx b/src/components/views/rooms/RoomSublist2.tsx
index fa37eef975..91baf4ff81 100644
--- a/src/components/views/rooms/RoomSublist2.tsx
+++ b/src/components/views/rooms/RoomSublist2.tsx
@@ -27,8 +27,11 @@ import RoomTile2 from "./RoomTile2";
 import { ResizableBox, ResizeCallbackData } from "react-resizable";
 import { ListLayout } from "../../../stores/room-list/ListLayout";
 import NotificationBadge, { ListNotificationState } from "./NotificationBadge";
-import {ContextMenu, ContextMenuButton} from "../../structures/ContextMenu";
+import { ContextMenu, ContextMenuButton } from "../../structures/ContextMenu";
 import StyledCheckbox from "../elements/StyledCheckbox";
+import StyledRadioButton from "../elements/StyledRadioButton";
+import RoomListStore from "../../../stores/room-list/RoomListStore2";
+import { ListAlgorithm, SortAlgorithm } from "../../../stores/room-list/algorithms/models";
 
 /*******************************************************************
  *   CAUTION                                                       *
@@ -115,9 +118,14 @@ export default class RoomSublist2 extends React.Component<IProps, IState> {
         this.setState({menuDisplayed: false});
     };
 
-    private onUnreadFirstChanged = () => {
-        // TODO: Support per-list algorithm changes
-        console.log("Unread first changed");
+    private onUnreadFirstChanged = async () => {
+        const isUnreadFirst = RoomListStore.instance.getListOrder(this.props.layout.tagId) === ListAlgorithm.Importance;
+        const newAlgorithm = isUnreadFirst ? ListAlgorithm.Natural : ListAlgorithm.Importance;
+        await RoomListStore.instance.setListOrder(this.props.layout.tagId, newAlgorithm);
+    };
+
+    private onTagSortChanged = async (sort: SortAlgorithm) => {
+        await RoomListStore.instance.setTagSorting(this.props.layout.tagId, sort);
     };
 
     private onMessagePreviewChanged = () => {
@@ -147,6 +155,8 @@ export default class RoomSublist2 extends React.Component<IProps, IState> {
         let contextMenu = null;
         if (this.state.menuDisplayed) {
             const elementRect = this.menuButtonRef.current.getBoundingClientRect();
+            const isAlphabetical = RoomListStore.instance.getTagSorting(this.props.layout.tagId) === SortAlgorithm.Alphabetic;
+            const isUnreadFirst = RoomListStore.instance.getListOrder(this.props.layout.tagId) === ListAlgorithm.Importance;
             contextMenu = (
                 <ContextMenu
                     chevronFace="none"
@@ -157,14 +167,27 @@ export default class RoomSublist2 extends React.Component<IProps, IState> {
                     <div className="mx_RoomSublist2_contextMenu">
                         <div>
                             <div className='mx_RoomSublist2_contextMenu_title'>{_t("Sort by")}</div>
-                            TODO: Radios are blocked by https://github.com/matrix-org/matrix-react-sdk/pull/4731
+                            <StyledRadioButton
+                                onChange={() => this.onTagSortChanged(SortAlgorithm.Recent)}
+                                checked={!isAlphabetical}
+                                name={`mx_${this.props.layout.tagId}_sortBy`}
+                            >
+                                {_t("Activity")}
+                            </StyledRadioButton>
+                            <StyledRadioButton
+                                onChange={() => this.onTagSortChanged(SortAlgorithm.Alphabetic)}
+                                checked={isAlphabetical}
+                                name={`mx_${this.props.layout.tagId}_sortBy`}
+                            >
+                                {_t("A-Z")}
+                            </StyledRadioButton>
                         </div>
                         <hr />
                         <div>
                             <div className='mx_RoomSublist2_contextMenu_title'>{_t("Unread rooms")}</div>
                             <StyledCheckbox
                                 onChange={this.onUnreadFirstChanged}
-                                checked={false/*TODO*/}
+                                checked={isUnreadFirst}
                             >
                                 {_t("Always show first")}
                             </StyledCheckbox>
diff --git a/src/i18n/strings/en_EN.json b/src/i18n/strings/en_EN.json
index 81577d740e..31da52a494 100644
--- a/src/i18n/strings/en_EN.json
+++ b/src/i18n/strings/en_EN.json
@@ -1138,6 +1138,8 @@
     "Not now": "Not now",
     "Don't ask me again": "Don't ask me again",
     "Sort by": "Sort by",
+    "Activity": "Activity",
+    "A-Z": "A-Z",
     "Unread rooms": "Unread rooms",
     "Always show first": "Always show first",
     "Show": "Show",

From cc17409943d03b92f38087b11584c592303454ca Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Fri, 12 Jun 2020 08:37:08 -0600
Subject: [PATCH 5/7] Fix words

Co-authored-by: J. Ryan Stinnett <jryans@gmail.com>
---
 docs/room-list-store.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/room-list-store.md b/docs/room-list-store.md
index 82c83d3593..53f0527209 100644
--- a/docs/room-list-store.md
+++ b/docs/room-list-store.md
@@ -24,7 +24,7 @@ algorithm to call, instead of having all the logic in the room list store itself
 
 
 Tag sorting is effectively the comparator supplied to the list algorithm. This gives the list algorithm
-the power to decide when and how to apply the tag sorting, if at all. For example, The importance algorithm, 
+the power to decide when and how to apply the tag sorting, if at all. For example, the importance algorithm, 
 later described in this document, heavily uses the list ordering behaviour to break the tag into categories. 
 Each category then gets sorted by the appropriate tag sorting algorithm.
 

From 6b54c3a492a26a20213a19660b6b2486b664eb50 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Fri, 12 Jun 2020 08:39:59 -0600
Subject: [PATCH 6/7] Throw if the update cause is unsupported

---
 .../algorithms/list-ordering/ImportanceAlgorithm.ts        | 5 +++++
 .../room-list/algorithms/list-ordering/NaturalAlgorithm.ts | 7 ++++++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/stores/room-list/algorithms/list-ordering/ImportanceAlgorithm.ts b/src/stores/room-list/algorithms/list-ordering/ImportanceAlgorithm.ts
index 2e24cb23f1..325aaf19e6 100644
--- a/src/stores/room-list/algorithms/list-ordering/ImportanceAlgorithm.ts
+++ b/src/stores/room-list/algorithms/list-ordering/ImportanceAlgorithm.ts
@@ -152,6 +152,11 @@ export class ImportanceAlgorithm extends OrderingAlgorithm {
     }
 
     public async handleRoomUpdate(room: Room, cause: RoomUpdateCause): Promise<boolean> {
+        // TODO: Handle NewRoom and RoomRemoved
+        if (cause !== RoomUpdateCause.Timeline && cause !== RoomUpdateCause.ReadReceipt) {
+            throw new Error(`Unsupported update cause: ${cause}`);
+        }
+
         const category = this.getRoomCategory(room);
         if (this.sortingAlgorithm === SortAlgorithm.Manual) {
             return; // Nothing to do here.
diff --git a/src/stores/room-list/algorithms/list-ordering/NaturalAlgorithm.ts b/src/stores/room-list/algorithms/list-ordering/NaturalAlgorithm.ts
index 2302768fbf..cce7372986 100644
--- a/src/stores/room-list/algorithms/list-ordering/NaturalAlgorithm.ts
+++ b/src/stores/room-list/algorithms/list-ordering/NaturalAlgorithm.ts
@@ -17,7 +17,7 @@ limitations under the License.
 import { SortAlgorithm } from "../models";
 import { sortRoomsWithAlgorithm } from "../tag-sorting";
 import { OrderingAlgorithm } from "./OrderingAlgorithm";
-import { TagID } from "../../models";
+import { RoomUpdateCause, TagID } from "../../models";
 import { Room } from "matrix-js-sdk/src/models/room";
 
 /**
@@ -36,6 +36,11 @@ export class NaturalAlgorithm extends OrderingAlgorithm {
     }
 
     public async handleRoomUpdate(room, cause): Promise<boolean> {
+        // TODO: Handle NewRoom and RoomRemoved
+        if (cause !== RoomUpdateCause.Timeline && cause !== RoomUpdateCause.ReadReceipt) {
+            throw new Error(`Unsupported update cause: ${cause}`);
+        }
+
         // TODO: Optimize this to avoid useless operations
         // For example, we can skip updates to alphabetic (sometimes) and manually ordered tags
         this.cachedOrderedRooms = await sortRoomsWithAlgorithm(this.cachedOrderedRooms, this.tagId, this.sortingAlgorithm);

From 6de6d94f7c8c2ff7adcea554d98dcd8707d61651 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Fri, 12 Jun 2020 08:40:08 -0600
Subject: [PATCH 7/7] Fix return type

---
 src/stores/room-list/algorithms/Algorithm.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/stores/room-list/algorithms/Algorithm.ts b/src/stores/room-list/algorithms/Algorithm.ts
index 438ef78e7e..e8b167c1ba 100644
--- a/src/stores/room-list/algorithms/Algorithm.ts
+++ b/src/stores/room-list/algorithms/Algorithm.ts
@@ -508,7 +508,7 @@ export class Algorithm extends EventEmitter {
         if (cause === RoomUpdateCause.NewRoom) {
             // TODO: Be smarter and insert rather than regen the planet.
             await this.setKnownRooms([room, ...this.rooms]);
-            return;
+            return true;
         }
 
         if (cause === RoomUpdateCause.RoomRemoved) {