2025-04-01 10:38:02 +09:00

97 lines
3.5 KiB
TypeScript

import { getTemplateSrv, TemplateSrv } from '@grafana/runtime';
import type { Monaco, monacoTypes } from '@grafana/ui';
import { ResourcesAPI } from '../../resources/ResourcesAPI';
import { CLOUDWATCH_PPL_LANGUAGE_DEFINITION_ID } from '../cloudwatch-ppl/language';
import { LinkedToken } from './LinkedToken';
import { linkedTokenBuilder } from './linkedTokenBuilder';
import { LanguageDefinition } from './register';
import { Completeable, StatementPosition, SuggestionKind, TokenTypes } from './types';
type CompletionItem = monacoTypes.languages.CompletionItem;
/*
CompletionItemProvider is an extendable class which needs to implement :
- tokenTypes
- getStatementPosition
- getSuggestionKinds
- getSuggestions
*/
export class CompletionItemProvider implements Completeable {
resources: ResourcesAPI;
templateSrv: TemplateSrv;
tokenTypes: TokenTypes;
constructor(resources: ResourcesAPI, templateSrv: TemplateSrv = getTemplateSrv()) {
this.resources = resources;
this.templateSrv = templateSrv;
this.templateSrv = templateSrv;
// implement with more specific tokens when extending this class
this.tokenTypes = {
Parenthesis: 'delimiter.parenthesis',
Whitespace: 'white',
Keyword: 'keyword',
Delimiter: 'delimiter',
Operator: 'operator',
Identifier: 'identifier',
Type: 'type',
Function: 'predefined',
Number: 'number',
String: 'string',
Variable: 'variable',
Comment: 'comment',
Regexp: 'regexp',
};
}
// implemented by subclasses, given a token, returns a lexical position in a query
getStatementPosition(currentToken: LinkedToken | null): StatementPosition {
return StatementPosition.Unknown;
}
// implemented by subclasses, given a lexical statement position, returns potential kinds of suggestions
getSuggestionKinds(position: StatementPosition): SuggestionKind[] {
return [];
}
// implemented by subclasses, given potential suggestions kinds, returns suggestion objects for monaco aka "CompletionItem"
getSuggestions(
monaco: Monaco,
currentToken: LinkedToken | null,
suggestionKinds: SuggestionKind[],
statementPosition: StatementPosition,
position: monacoTypes.IPosition
): Promise<CompletionItem[]> {
return Promise.reject([]);
}
// called by registerLanguage and passed to monaco with registerCompletionItemProvider
// returns an object that implements https://microsoft.github.io/monaco-editor/api/interfaces/monaco.languages.CompletionItemProvider.html
getCompletionProvider(monaco: Monaco, languageDefinition: LanguageDefinition) {
const isPPL = languageDefinition.id === CLOUDWATCH_PPL_LANGUAGE_DEFINITION_ID; // backticks for field names in PPL
const triggerCharacters = [' ', '$', ',', '(', "'"].concat(isPPL ? ['`'] : []);
return {
triggerCharacters, // one of these characters indicates that it is time to look for a suggestion
provideCompletionItems: async (model: monacoTypes.editor.ITextModel, position: monacoTypes.IPosition) => {
const currentToken = linkedTokenBuilder(monaco, languageDefinition, model, position, this.tokenTypes);
const statementPosition = this.getStatementPosition(currentToken);
const suggestionKinds = this.getSuggestionKinds(statementPosition);
const suggestions = await this.getSuggestions(
monaco,
currentToken,
suggestionKinds,
statementPosition,
position
);
return {
suggestions,
};
},
};
}
}