typescript-template-language-service-decorator/lib/template-settings.d.ts

Framework for decorating a TypeScript language service with support for languages embedded in template strings

/**
 * Define which tagged templates to process and how to parse them.
 */
export default interface TemplateSettings {
    /**
     * Set of tags that identify which tagged templates to process.
     *
     * The tag string may be matched at either the start or the end of the template's tag.
     */
    readonly tags: ReadonlyArray<string>;
    /**
     * Should templates with substitutions be processed?
     *
     * Defaults to false.
     */
    readonly enableForStringWithSubstitutions?: boolean;
    /**
     * Retrieve a string that is used internally in place of the substitution expression.
     *
     * @param templateString The raw template string with all `${substitution}` in place.
     * @param start Start index of the range in `templateString` to replace.
     * @param end End index of the range in `templateString` to replace.
     *
     * @return Replacement string. Must be the of length `end - start`.
     */
    getSubstitution?(templateString: string, start: number, end: number): string;
    /**
     * Retrieve a string that is used internally in place of the substitution expression.
     *
     * If this is implemented, `getSubstitution` will not be called.
     *
     * @param templateString The raw template string with all `${substitution}` in place.
     * @param spans List of placeholder spans.
     *
     * @return Replacement string. Must be the exact same length as the input string
     */
    getSubstitutions?(templateString: string, spans: ReadonlyArray<{
        start: number;
        end: number;
    }>): string;
}