2017-06-01 14:18:06 +00:00
|
|
|
/*
|
2017-06-01 16:29:40 +00:00
|
|
|
Copyright 2016 Aviral Dasgupta
|
2018-06-19 10:52:48 +00:00
|
|
|
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';
|
2018-06-19 10:52:48 +00:00
|
|
|
import CommunityProvider from './CommunityProvider';
|
2016-06-12 11:32:46 +00:00
|
|
|
import DuckDuckGoProvider from './DuckDuckGoProvider';
|
|
|
|
import RoomProvider from './RoomProvider';
|
|
|
|
import UserProvider from './UserProvider';
|
2016-06-16 23:28:09 +00:00
|
|
|
import EmojiProvider from './EmojiProvider';
|
2017-11-02 18:54:25 +00:00
|
|
|
import NotifProvider from './NotifProvider';
|
2021-06-18 15:13:55 +00:00
|
|
|
import { timeout } from "../utils/promise";
|
2020-04-20 18:00:54 +00:00
|
|
|
import AutocompleteProvider, {ICommand} from "./AutocompleteProvider";
|
2021-05-18 08:39:01 +00:00
|
|
|
import SettingsStore from "../settings/SettingsStore";
|
|
|
|
import SpaceProvider from "./SpaceProvider";
|
2016-09-13 10:11:52 +00:00
|
|
|
|
2020-04-20 18:00:54 +00:00
|
|
|
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.
|
|
|
|
}
|
2016-09-13 10:11:52 +00:00
|
|
|
|
2020-04-20 18:00:54 +00:00
|
|
|
export interface ICompletion {
|
|
|
|
type: "at-room" | "command" | "community" | "room" | "user";
|
2020-06-18 13:32:43 +00:00
|
|
|
completion: string;
|
2020-04-20 18:00:54 +00:00
|
|
|
completionId?: string;
|
2020-06-18 13:32:43 +00:00
|
|
|
component?: ReactElement;
|
|
|
|
range: ISelectionRange;
|
|
|
|
command?: string;
|
2020-04-20 18:00:54 +00:00
|
|
|
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;
|
2020-04-20 18:00:54 +00:00
|
|
|
}
|
2016-06-01 11:24:21 +00:00
|
|
|
|
2016-06-12 11:32:46 +00:00
|
|
|
const PROVIDERS = [
|
2016-06-20 08:22:55 +00:00
|
|
|
UserProvider,
|
2016-06-12 11:32:46 +00:00
|
|
|
RoomProvider,
|
2016-07-03 16:45:13 +00:00
|
|
|
EmojiProvider,
|
2017-11-02 18:54:25 +00:00
|
|
|
NotifProvider,
|
2016-09-13 10:11:52 +00:00
|
|
|
CommandProvider,
|
2018-06-19 10:52:48 +00:00
|
|
|
CommunityProvider,
|
2016-09-13 10:11:52 +00:00
|
|
|
DuckDuckGoProvider,
|
2017-11-02 17:51:08 +00:00
|
|
|
];
|
2016-06-01 11:24:21 +00:00
|
|
|
|
2021-05-18 08:39:01 +00:00
|
|
|
// as the spaces feature is device configurable only, and toggling it refreshes the page, we can do this here
|
|
|
|
if (SettingsStore.getValue("feature_spaces")) {
|
|
|
|
PROVIDERS.push(SpaceProvider);
|
|
|
|
}
|
|
|
|
|
2016-09-13 10:11:52 +00:00
|
|
|
// Providers will get rejected if they take longer than this.
|
|
|
|
const PROVIDER_COMPLETION_TIMEOUT = 3000;
|
|
|
|
|
2020-04-20 18:00:54 +00:00
|
|
|
export interface IProviderCompletions {
|
|
|
|
completions: ICompletion[];
|
|
|
|
provider: AutocompleteProvider;
|
|
|
|
command: ICommand;
|
|
|
|
}
|
|
|
|
|
2017-11-02 17:51:08 +00:00
|
|
|
export default class Autocompleter {
|
2020-04-20 18:00:54 +00:00
|
|
|
room: Room;
|
|
|
|
providers: AutocompleteProvider[];
|
|
|
|
|
2018-06-19 11:06:13 +00:00
|
|
|
constructor(room: Room) {
|
2017-11-02 17:51:08 +00:00
|
|
|
this.room = room;
|
2019-01-11 13:54:11 +00:00
|
|
|
this.providers = PROVIDERS.map((Prov) => {
|
|
|
|
return new Prov(room);
|
2017-11-02 17:51:08 +00:00
|
|
|
});
|
|
|
|
}
|
2016-09-13 10:11:52 +00:00
|
|
|
|
2017-11-02 17:51:08 +00:00
|
|
|
destroy() {
|
|
|
|
this.providers.forEach((p) => {
|
|
|
|
p.destroy();
|
|
|
|
});
|
|
|
|
}
|
2016-09-13 10:11:52 +00:00
|
|
|
|
2021-05-12 11:18:56 +00:00
|
|
|
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,
|
2017-11-02 17:51:08 +00:00
|
|
|
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
|
|
|
|
*/
|
2020-04-20 18:00:54 +00:00
|
|
|
// list of results from each provider, each being a list of completions or null if it times out
|
2021-05-12 11:18:56 +00:00
|
|
|
const completionsList: ICompletion[][] = await Promise.all(this.providers.map(async provider => {
|
|
|
|
return await timeout(
|
|
|
|
provider.getCompletions(query, selection, force, limit),
|
|
|
|
null,
|
|
|
|
PROVIDER_COMPLETION_TIMEOUT,
|
|
|
|
);
|
2019-11-14 13:52:17 +00:00
|
|
|
}));
|
|
|
|
|
|
|
|
// 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;
|
2017-11-02 17:51:08 +00:00
|
|
|
|
|
|
|
return {
|
2019-11-14 13:52:17 +00:00
|
|
|
completions,
|
2017-11-02 17:51:08 +00:00
|
|
|
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),
|
|
|
|
};
|
2019-11-14 13:52:17 +00:00
|
|
|
}).filter(Boolean);
|
2017-11-02 17:51:08 +00:00
|
|
|
}
|
2016-06-01 11:24:21 +00:00
|
|
|
}
|