element-web/src/autocomplete/Autocompleter.ts

122 lines
4.1 KiB
TypeScript
Raw Normal View History

2017-06-01 14:18:06 +00:00
/*
2017-06-01 16:29:40 +00:00
Copyright 2016 Aviral Dasgupta
Copyright 2017, 2018 New Vector Ltd
2017-06-01 14:18:06 +00:00
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.
*/
2021-06-18 15:13:55 +00:00
import { ReactElement } from 'react';
import { Room } from 'matrix-js-sdk/src/models/room';
2016-06-01 11:24:21 +00:00
import CommandProvider from './CommandProvider';
import RoomProvider from './RoomProvider';
import UserProvider from './UserProvider';
import EmojiProvider from './EmojiProvider';
import NotifProvider from './NotifProvider';
2021-06-18 15:13:55 +00:00
import { timeout } from "../utils/promise";
2021-06-29 12:11:58 +00:00
import AutocompleteProvider, { ICommand } from "./AutocompleteProvider";
import SpaceProvider from "./SpaceProvider";
import { TimelineRenderingType } from '../contexts/RoomContext';
export interface ISelectionRange {
beginning?: boolean; // whether the selection is in the first block of the editor or not
start: number; // byte offset relative to the start anchor of the current editor selection.
end: number; // byte offset relative to the end anchor of the current editor selection.
}
export interface ICompletion {
type: "at-room" | "command" | "community" | "room" | "user";
2020-06-18 13:32:43 +00:00
completion: string;
completionId?: string;
2020-06-18 13:32:43 +00:00
component?: ReactElement;
range: ISelectionRange;
command?: string;
suffix?: string;
2017-07-20 15:49:23 +00:00
// If provided, apply a LINK entity to the completion with the
// data = { url: href }.
2020-06-18 13:32:43 +00:00
href?: string;
}
2016-06-01 11:24:21 +00:00
const PROVIDERS = [
UserProvider,
RoomProvider,
EmojiProvider,
NotifProvider,
CommandProvider,
SpaceProvider,
];
2016-06-01 11:24:21 +00:00
// Providers will get rejected if they take longer than this.
const PROVIDER_COMPLETION_TIMEOUT = 3000;
export interface IProviderCompletions {
completions: ICompletion[];
provider: AutocompleteProvider;
command: ICommand;
}
export default class Autocompleter {
room: Room;
providers: AutocompleteProvider[];
constructor(room: Room, renderingType: TimelineRenderingType = TimelineRenderingType.Room) {
this.room = room;
this.providers = PROVIDERS.map((Prov) => {
return new Prov(room, renderingType);
});
}
destroy() {
this.providers.forEach((p) => {
p.destroy();
});
}
async getCompletions(
query: string,
selection: ISelectionRange,
force = false,
limit = -1,
): Promise<IProviderCompletions[]> {
2017-11-02 18:11:18 +00:00
/* Note: This intentionally waits for all providers to return,
otherwise, we run into a condition where new completions are displayed
while the user is interacting with the list, which makes it difficult
to predict whether an action will actually do what is intended
*/
// list of results from each provider, each being a list of completions or null if it times out
const completionsList: ICompletion[][] = await Promise.all(this.providers.map(async provider => {
return timeout(
provider.getCompletions(query, selection, force, limit),
null,
PROVIDER_COMPLETION_TIMEOUT,
);
}));
// map then filter to maintain the index for the map-operation, for this.providers to line up
return completionsList.map((completions, i) => {
if (!completions || !completions.length) return;
return {
completions,
provider: this.providers[i],
/* the currently matched "command" the completer tried to complete
* we pass this through so that Autocomplete can figure out when to
* re-show itself once hidden.
*/
command: this.providers[i].getCurrentCommand(query, selection, force),
};
}).filter(Boolean);
}
2016-06-01 11:24:21 +00:00
}