@adecore/editor-react 0.42.0 → 0.44.0

package/dist/surround.js

@@ -0,0 +1,399 @@
+import { commentSyntax } from '@adecore/editor';
+import { comparePositions, shiftRange } from './diagnostics-model.js';
+import { KEY_PRIORITY } from './key-priority.js';
+import { lineTextOf, textBeforeOf } from './line-text.js';
+import { enclosingElements, lineEndOf, lineStartOf, markupSyntaxOf, removeTagEdits } from './markup-context.js';
+import { isShortcut } from './shortcut-keys.js';
+import { bodyWithIndentUnit, dedentLines, insertSnippet } from './snippet-insert.js';
+import { indentSnippet } from './snippet-indent.js';
+import { compileSnippet, snippetVariables } from './snippet.js';
+import { expressionConstructs, regionConstructs, statementConstructs } from './surround-constructs.js';
+import { templateApplies, templateContextAt } from './template-context.js';
+const TOAST_ID = 'language-surround';
+const SELECTED_TEXT = 'TM_SELECTED_TEXT';
+const MNEMONICS = '1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+const LINE_BREAK = /\r\n|\r|\n/;
+/* Where a mnemonic can come from: the first character of a name that no row has taken. */
+function mnemonicOf(name, taken) {
+  const found = [...name].find(character => /[\p{L}\p{N}]/u.test(character) && !taken.has(character.toUpperCase()));
+  if (found === undefined) {
+    return undefined;
+  }
+  taken.add(found.toUpperCase());
+  return found.toUpperCase();
+}
+/* Overlapping ranges become one, the one holding the primary range last. Null where two ranges share a line. */
+function mergedRanges(ranges) {
+  const primary = ranges.at(-1);
+  const sorted = [...ranges].sort((left, right) => comparePositions(left.start, right.start));
+  const merged = [];
+  for (const range of sorted) {
+    const last = merged.at(-1);
+    if (last !== undefined && comparePositions(range.start, last.end) <= 0) {
+      merged[merged.length - 1] = {
+        start: last.start,
+        end: comparePositions(range.end, last.end) > 0 ? range.end : last.end
+      };
+    } else {
+      merged.push(range);
+    }
+  }
+  if (merged.some((range, index) => index > 0 && range.start.line <= merged[index - 1].end.line)) {
+    return null;
+  }
+  const index = merged.findIndex(range => comparePositions(range.start, primary.start) <= 0 && comparePositions(primary.start, range.end) <= 0);
+  return [...merged.filter((_range, other) => other !== index), merged[index]];
+}
+/*
+ * Surround With, Surround with Live Template and Unwrap/Remove, as IntelliJ's handlers offer them. Surround With
+ * wraps the selection, or the content of the caret's line, in a statement, an expression, a region comment or a live
+ * template that uses the selected text; Unwrap/Remove takes the construct around the caret away and keeps what is in it.
+ * Each is one edit, so one undo step, and nothing happens in a read-only editor.
+ */
+export class SurroundFeature {
+  language;
+  constructor(language) {
+    this.language = language;
+    language.onDispose(language.onKey(event => {
+      if (isShortcut(language.shortcuts.surroundWith, event)) {
+        return this.open();
+      }
+      if (isShortcut(language.shortcuts.surroundWithLiveTemplate, event)) {
+        return this.openTemplates();
+      }
+      return isShortcut(language.shortcuts.unwrap, event) && this.unwrap();
+    }, KEY_PRIORITY.templates));
+  }
+  /* Opens Surround With under the selection. True, since the chord is taken, also where nothing applies. */
+  open() {
+    return this.show(false);
+  }
+  /* Opens Surround with Live Template: Emmet in markup, then the templates that use the selected text. */
+  openTemplates() {
+    return this.show(true);
+  }
+  /* Opens the list of constructs around the caret that can be unwrapped or removed. */
+  unwrap() {
+    const {
+      editor,
+      pick,
+      project
+    } = this.language;
+    if (editor.isReadOnly?.() === true) {
+      return true;
+    }
+    const rows = this.unwrapRows();
+    if (rows.length === 0) {
+      return true;
+    }
+    const text = editor.getText();
+    pick.open({
+      anchor: editor.getCaret(),
+      title: project.i18n.t('editor:language.surround.unwrap.title'),
+      groups: [{
+        title: null,
+        rows: rows.map((row, index) => ({
+          id: String(index),
+          label: row.label,
+          detail: ''
+        }))
+      }],
+      filter: true,
+      accept: id => this.applyUnwrap(rows[Number(id)]),
+      preview: id => Promise.resolve(this.unwrapPreview(text, rows[Number(id)]))
+    });
+    return true;
+  }
+  show(templatesOnly) {
+    const {
+      editor,
+      pick,
+      project
+    } = this.language;
+    if (editor.isReadOnly?.() === true) {
+      return true;
+    }
+    const subject = this.subjectOf();
+    if (subject === null) {
+      this.refuse('editor:language.surround.none');
+      return true;
+    }
+    const groups = this.groupsOf(subject, templatesOnly);
+    const entries = new Map(groups.flatMap(group => group.entries).map(entry => [entry.row.id, entry]));
+    if (entries.size === 0) {
+      this.refuse(templatesOnly ? 'editor:language.surround.noTemplates' : 'editor:language.surround.none');
+      return true;
+    }
+    const primary = subject.placements.at(-1);
+    pick.open({
+      anchor: primary.range.start,
+      title: project.i18n.t(templatesOnly ? 'editor:language.surround.selectTemplate' : 'editor:language.surround.title'),
+      groups: groups.map(group => ({
+        title: group.title,
+        rows: group.entries.map(entry => entry.row)
+      })),
+      accept: id => entries.get(id).run(),
+      preview: id => Promise.resolve(this.previewOf(entries.get(id).source, primary))
+    });
+    return true;
+  }
+  refuse(key) {
+    const {
+      editor,
+      project
+    } = this.language;
+    const title = project.i18n.t(key);
+    project.host.notify?.({
+      id: TOAST_ID,
+      kind: 'error',
+      title
+    });
+    editor.announce(title);
+  }
+  /* The ranges to surround, their language and what they can be surrounded with; null where nothing can be. */
+  subjectOf() {
+    const {
+      editor,
+      languageId
+    } = this.language;
+    const candidates = editor.getSelections().flatMap(selection => {
+      if (comparePositions(selection.start, selection.end) !== 0) {
+        return [selection];
+      }
+      const line = lineTextOf(editor, selection.start.line);
+      const content = line.trim();
+      if (content === '') {
+        return [];
+      }
+      const start = line.length - line.trimStart().length;
+      return [{
+        start: {
+          line: selection.start.line,
+          character: start
+        },
+        end: {
+          line: selection.start.line,
+          character: start + content.length
+        }
+      }];
+    });
+    const ranges = candidates.length === 0 ? null : mergedRanges(candidates);
+    const found = ranges?.map(range => editor.surroundShape?.(range) ?? null) ?? [];
+    const shapes = found.filter(shape => shape !== null);
+    if (shapes.length === 0 || shapes.length !== found.length) {
+      return null;
+    }
+    const languages = shapes.flatMap(shape => [shape.range.start, shape.range.end]).map(position => editor.placeAt?.(position)?.language ?? languageId);
+    if (new Set(languages).size !== 1) {
+      return null;
+    }
+    return {
+      placements: shapes.map(shape => ({
+        range: shape.range,
+        selectedText: dedentLines(editor.textInRange(shape.range))
+      })),
+      language: languages[0],
+      context: templateContextAt(this.language, shapes.at(-1).range.start),
+      statements: shapes.every(shape => shape.statements),
+      expression: shapes.every(shape => shape.expression)
+    };
+  }
+  groupsOf(subject, templatesOnly) {
+    const {
+      project
+    } = this.language;
+    const {
+      families
+    } = subject.context;
+    const taken = new Set();
+    let next = 0;
+    const numbered = () => {
+      const mnemonic = MNEMONICS[next++];
+      if (mnemonic !== undefined) {
+        taken.add(mnemonic);
+      }
+      return mnemonic;
+    };
+    const insert = (id, label, detail, source, mnemonic) => ({
+      row: {
+        id,
+        label,
+        detail,
+        mnemonic
+      },
+      source,
+      run: () => this.insert(source, subject.placements)
+    });
+    const own = [];
+    if (!templatesOnly) {
+      const constructs = [...(subject.statements ? statementConstructs(families) : []), ...(subject.expression ? expressionConstructs(families) : []), ...regionConstructs(commentSyntax(subject.language))];
+      for (const construct of constructs) {
+        const region = construct.id === 'region' || construct.id === 'editorFold';
+        const label = region ? project.i18n.t('editor:language.surround.comments', {
+          construct: construct.label
+        }) : construct.label;
+        own.push(insert(`construct:${construct.id}`, label, '', construct.body, numbered()));
+      }
+    }
+    const live = [];
+    const markup = this.language.markup;
+    if (markup.supported && (families.includes('html') || families.includes('xml')) && this.language.editor.getSelections().length === 1) {
+      live.push({
+        row: {
+          id: 'emmet',
+          label: 'Emmet',
+          detail: '',
+          mnemonic: mnemonicOf('Emmet', taken)
+        },
+        source: null,
+        run: () => {
+          this.language.editor.setSelection(subject.placements[0].range);
+          markup.startWrap();
+        }
+      });
+    }
+    for (const template of project.templates.live) {
+      if (snippetVariables(template.body).has(SELECTED_TEXT) && templateApplies(template, subject.context)) {
+        live.push(insert(`template:${template.id}`, template.key, template.description ?? '', template.body, mnemonicOf(template.key, taken)));
+      }
+    }
+    const configure = project.host.openTemplateSettings?.bind(project.host);
+    if (configure !== undefined) {
+      live.push({
+        row: {
+          id: 'configure',
+          label: project.i18n.t('editor:language.surround.configure'),
+          detail: ''
+        },
+        source: null,
+        run: () => configure()
+      });
+    }
+    if (templatesOnly) {
+      return [{
+        title: null,
+        entries: live
+      }];
+    }
+    return [{
+      title: null,
+      entries: own
+    }, {
+      title: project.i18n.t('editor:language.surround.liveTemplates'),
+      entries: live
+    }].filter(group => group.entries.length > 0);
+  }
+  /* Inserts the snippet around every range; a snippet that still runs ends first, as the previous template does in IntelliJ. */
+  insert(source, placements) {
+    this.language.snippets.end();
+    void insertSnippet(this.language, bodyWithIndentUnit(source, this.indentUnit()), placements);
+  }
+  indentUnit() {
+    const {
+      tabSize,
+      insertSpaces
+    } = this.language.editor.getIndentation();
+    return insertSpaces ? ' '.repeat(tabSize) : '\t';
+  }
+  /* The lines the primary range covers, and the same lines with the snippet in the range's place. */
+  previewOf(source, placement) {
+    const {
+      editor
+    } = this.language;
+    if (source === null) {
+      return null;
+    }
+    const {
+      range
+    } = placement;
+    const before = textBeforeOf(editor, range.start);
+    const rendered = compileSnippet(bodyWithIndentUnit(source, this.indentUnit())).render(name => name === SELECTED_TEXT ? placement.selectedText ?? '' : undefined, undefined, {
+      indentVariables: true
+    });
+    const after = lineTextOf(editor, range.end.line).slice(range.end.character);
+    return {
+      removed: editor.textInRange({
+        start: {
+          line: range.start.line,
+          character: 0
+        },
+        end: {
+          line: range.end.line,
+          character: lineTextOf(editor, range.end.line).length
+        }
+      }).split(LINE_BREAK),
+      added: (before + indentSnippet(rendered, before).text + after).split(LINE_BREAK),
+      note: null
+    };
+  }
+  unwrapRows() {
+    const {
+      editor,
+      languageId,
+      project
+    } = this.language;
+    const unit = this.indentUnit();
+    const caret = editor.getCaret();
+    const text = editor.getText();
+    const syntax = markupSyntaxOf(languageId);
+    const scripts = (editor.unwrapTargets?.(caret) ?? []).map(target => {
+      const from = editor.offsetAt(target.range.start);
+      return {
+        label: project.i18n.t(`editor:language.surround.unwrap.${target.kind}`),
+        start: from,
+        from,
+        to: editor.offsetAt(target.range.end),
+        edits: target.edits.map(edit => ({
+          from: editor.offsetAt(edit.range.start),
+          to: editor.offsetAt(edit.range.end),
+          text: edit.text
+        })).sort((left, right) => left.from - right.from)
+      };
+    });
+    const tags = syntax === null ? [] : enclosingElements(text, editor.offsetAt(caret), syntax).map(element => ({
+      label: project.i18n.t('editor:language.surround.unwrap.tag', {
+        name: element.name
+      }),
+      start: element.open.from,
+      from: element.open.from,
+      to: element.close?.to ?? element.open.to,
+      edits: removeTagEdits(text, element, unit)
+    }));
+    // The sort is stable, so the rows of one construct stay in the order the editor gave them.
+    return [...scripts, ...tags].sort((left, right) => right.start - left.start);
+  }
+  applyUnwrap(row) {
+    const {
+      editor
+    } = this.language;
+    const changes = row.edits.map(edit => ({
+      range: {
+        start: editor.positionAt(edit.from),
+        end: editor.positionAt(edit.to)
+      },
+      text: edit.text
+    }));
+    const descending = [...changes].reverse();
+    editor.applyEdits(changes, {
+      mapSelections: range => shiftRange(range, descending)
+    });
+    editor.focus();
+  }
+  /* The lines of the construct before and after its edits. */
+  unwrapPreview(text, row) {
+    const edits = row.edits;
+    const from = lineStartOf(text, Math.min(row.from, ...edits.map(edit => edit.from)));
+    let last = Math.max(row.to, ...edits.map(edit => edit.to));
+    // An edit that takes a line break with it ends at the start of the next line, which is not part of the preview.
+    while (last > from && /[\r\n]/.test(text[last - 1])) {
+      last--;
+    }
+    const to = lineEndOf(text, last);
+    const after = [...edits].reverse().reduce((result, edit) => result.slice(0, edit.from - from) + edit.text + result.slice(edit.to - from), text.slice(from, to));
+    return {
+      removed: text.slice(from, to).split(LINE_BREAK),
+      added: after === '' ? [] : after.split(LINE_BREAK),
+      note: null
+    };
+  }
+}

package/dist/symbol-picker.js

@@ -28,11 +28,10 @@ export class SymbolPickerFeature {
   }
   async open() {
     const {
-      project,
       uri,
       popups
     } = this.language;
-    if (!project.service.supports('textDocument/documentSymbol', uri)) {
+    if (!this.language.service.supports('textDocument/documentSymbol', uri)) {
       this.language.project.host.notify?.({
         id: TOAST_ID,
         kind: 'error',
@@ -41,7 +40,7 @@ export class SymbolPickerFeature {
       return;
     }
     try {
-      const entries = entriesOf(await project.service.documentSymbols(uri));
+      const entries = entriesOf(await this.language.service.documentSymbols(uri));
       popups.setState({
         symbols: {
           file: basenameOf(this.language.uri),
@@ -87,13 +86,12 @@ export class SymbolPickerFeature {
   /* The symbols of the project that answer to a name, which is a request to the server and so waits for a pause in the typing. */
   async search(text, signal) {
     const {
-      project,
       uri
     } = this.language;
-    if (text === '' || !project.service.supports('workspace/symbol', uri)) {
+    if (text === '' || !this.language.service.supports('workspace/symbol', uri)) {
       return [];
     }
-    return workspaceEntriesOf(await project.service.workspaceSymbols(uri, text, {
+    return workspaceEntriesOf(await this.language.service.workspaceSymbols(uri, text, {
       signal
     }));
   }

package/dist/symbols.js

@@ -44,6 +44,23 @@ export function symbolSpansOf(result) {
     range: symbol.location.range
   }));
 }
+function declarationsOf(result) {
+  if (result === null || result.length === 0) {
+    return [];
+  }
+  if (!('range' in result[0])) {
+    return result.map(symbol => symbol.location.range.start);
+  }
+  const stops = [];
+  const visit = symbols => {
+    for (const symbol of symbols) {
+      stops.push((symbol.selectionRange ?? symbol.range).start);
+      visit(symbol.children ?? []);
+    }
+  };
+  visit(result);
+  return stops;
+}
 /* A line a declaration can have above it: blank, a comment, or an attribute. A bare `#` is no comment, since it heads a Markdown section. */
 const PRELUDE = /^\s*(?:$|\/\/|\/\*|\*|#\[)/;
 /*
@@ -112,18 +129,19 @@ export class SymbolsFeature {
   constructor(language, timers = realTimers) {
     const {
       editor,
-      project,
       uri
     } = language;
     this.refresher = new Refresher(async signal => {
-      if (!project.service.supports(METHOD, uri)) {
+      if (!language.service.supports(METHOD, uri)) {
         return;
       }
-      const result = await project.service.documentSymbols(uri, {
+      const result = await language.service.documentSymbols(uri, {
         signal
       });
       if (!signal.aborted) {
         editor.setBlocks(result === null ? null : blocksOf(result, editor.getText()));
+        const declarations = declarationsOf(result);
+        editor.setDeclarations?.(declarations.length === 0 ? null : declarations);
         for (const listener of [...this.listeners]) {
           listener(result);
         }
@@ -138,6 +156,7 @@ export class SymbolsFeature {
       providers();
       this.refresher.dispose();
       editor.setBlocks(null);
+      editor.setDeclarations?.(null);
     });
   }
   /* Called with every answer that was not replaced before it came. */

package/dist/template-builtins.d.ts

@@ -0,0 +1,3 @@
+import type { LiveTemplate, PostfixTemplate } from './templates.ts';
+export declare const BUILT_IN_LIVE_TEMPLATES: readonly LiveTemplate[];
+export declare const BUILT_IN_POSTFIX_TEMPLATES: readonly PostfixTemplate[];

package/dist/template-builtins.js

@@ -0,0 +1,46 @@
+/* A body of lines; a leading tab is one indentation unit. */
+function body(...lines) {
+  return lines.join('\n');
+}
+function live(language, key, languages, text, description) {
+  return {
+    id: `builtin.${language}.${key}`,
+    key,
+    body: text,
+    description,
+    languages
+  };
+}
+function phpFunction(key, modifiers, description) {
+  return live('php', key, ['php'], body(`${modifiers} function \${1:name}($2)`, '{', '\t$0', '}'), description);
+}
+/* The keys and bodies of the live templates IntelliJ ships for JavaScript, PHP, HTML and XML. */
+export const BUILT_IN_LIVE_TEMPLATES = [live('javascript', 'log', ['javascript'], 'console.log($0);', 'Prints a value to the console'), live('javascript', 'itar', ['javascript'], body('for (let ${1:i} = 0; $1 < ${2:array}.length; $1++) {', '\tconst ${3:element} = $2[$1];', '\t$0', '}'), 'Iterate elements of array'), live('javascript', 'ritar', ['javascript'], body('for (let ${1:i} = ${2:array}.length - 1; $1 >= 0; $1--) {', '\tconst ${3:element} = $2[$1];', '\t$0', '}'), 'Iterate elements of array in reverse order'), live('javascript', 'iter', ['javascript'], body('for (const ${1:item} of ${2:iterable}) {', '\t$0', '}'), 'Iterate (for...of)'), live('javascript', 'itin', ['javascript'], body('for (const ${1:key} in ${2:object}) {', '\t$0', '}'), 'Iterate (for...in)'), live('php', 'fore', ['php'], body('foreach (\\$${1:iterable} as \\$${2:value}) {', '\t$0', '}'), 'foreach(iterable_expr as $value) {...}'), live('php', 'forek', ['php'], body('foreach (\\$${1:iterable} as \\$${2:key} => \\$${3:value}) {', '\t$0', '}'), 'foreach(iterable_expr as $key => $value) {...}'), phpFunction('pubf', 'public', 'public function'), phpFunction('prif', 'private', 'private function'), phpFunction('prof', 'protected', 'protected function'), phpFunction('pubsf', 'public static', 'public static function'), live('php', 'thr', ['php'], 'throw new $0;', 'throw new'), live('html', 'T', ['html', 'xml'], '<${1:tag}>$TM_SELECTED_TEXT</${1/\\s.*//}>', 'Surround with <tag></tag>'), live('xml', 'CD', ['xml'], body('<![CDATA[', '$TM_SELECTED_TEXT', ']]>'), 'Surround with CDATA section')];
+/* A block statement around the expression, with the caret inside it. */
+function block(head) {
+  return body(`${head} {`, '\t$0', '}');
+}
+function script(key, text, example, description, expression = 'statement') {
+  return {
+    id: `builtin.postfix.javascript.${key}`,
+    key,
+    body: text,
+    example,
+    description,
+    languages: ['javascript', 'typescript'],
+    expression
+  };
+}
+function php(key, text, example, description, expression = 'statement') {
+  return {
+    id: `builtin.postfix.php.${key}`,
+    key,
+    body: text,
+    example,
+    description,
+    languages: ['php'],
+    expression
+  };
+}
+/* The postfix templates that ship with the editor, after the ones IntelliJ has for JavaScript, TypeScript and PHP. */
+export const BUILT_IN_POSTFIX_TEMPLATES = [script('if', block('if ($EXPR)'), 'if (expr) {}', 'Checks boolean expression to be true'), script('else', block('if (!$EXPR)'), 'if (!expr) {}', 'Checks boolean expression to be false'), script('null', block('if ($EXPR === null)'), 'if (expr === null) {}', 'Checks expression to be null'), script('notnull', block('if ($EXPR !== null)'), 'if (expr !== null) {}', 'Checks expression to be not null'), script('return', 'return $EXPR;', 'return expr;', 'Returns the expression from the function'), script('throw', 'throw $EXPR;', 'throw expr;', 'Throws the expression'), script('const', 'const ${1:name} = $EXPR;', 'const name = expr;', 'Creates a constant from the expression'), script('let', 'let ${1:name} = $EXPR;', 'let name = expr;', 'Creates a variable from the expression'), script('forof', block('for (const ${1:item} of $EXPR)'), 'for (const item of expr) {}', 'Iterates over the elements (for...of)'), script('forin', block('for (const ${1:key} in $EXPR)'), 'for (const key in expr) {}', 'Iterates over the keys (for...in)'), script('log', 'console.log($EXPR);', 'console.log(expr);', 'Prints the expression to the console'), script('not', '!$EXPR', '!expr', 'Negates the expression', 'any'), script('par', '($EXPR)', '(expr)', 'Surrounds the expression with parentheses', 'any'), script('arg', '${1:fn}($EXPR)', 'fn(expr)', 'Passes the expression to a function call', 'any'), script('await', 'await $EXPR', 'await expr', 'Awaits the expression', 'any'), script('typeof', 'typeof $EXPR', 'typeof expr', 'Takes the type of the expression', 'any'), php('if', block('if ($EXPR)'), 'if (expr) {}', 'Checks boolean expression to be true'), php('isset', block('if (isset($EXPR))'), 'if (isset(expr)) {}', 'Checks that the expression is set'), php('empty', block('if (empty($EXPR))'), 'if (empty(expr)) {}', 'Checks that the expression is empty'), php('null', block('if ($EXPR === null)'), 'if (expr === null) {}', 'Checks expression to be null'), php('notnull', block('if ($EXPR !== null)'), 'if (expr !== null) {}', 'Checks expression to be not null'), php('return', 'return $EXPR;', 'return expr;', 'Returns the expression from the function'), php('throw', 'throw $EXPR;', 'throw expr;', 'Throws the expression'), php('var', '\\$${1:name} = $EXPR;', '$name = expr;', 'Creates a variable from the expression'), php('foreach', block('foreach ($EXPR as \\$${1:value})'), 'foreach (expr as $value) {}', 'Iterates over the elements'), php('not', '!$EXPR', '!expr', 'Negates the expression', 'any'), php('par', '($EXPR)', '(expr)', 'Surrounds the expression with parentheses', 'any')];

package/dist/template-context.d.ts

@@ -0,0 +1,12 @@
+import type { EditorPosition } from '@adecore/editor';
+import type { EditorLanguage } from './editor-language.ts';
+import type { LiveTemplate, TemplateLanguage, TemplatePlace } from './templates.ts';
+export declare const SNIPPET_KIND = 15;
+export declare function sortAfterServer(key: string): string;
+export declare function familiesOf(languageId: string): readonly TemplateLanguage[];
+export interface TemplateContext {
+    readonly families: readonly TemplateLanguage[];
+    readonly place: TemplatePlace;
+}
+export declare function templateContextAt(language: EditorLanguage, position: EditorPosition): TemplateContext;
+export declare function templateApplies(template: LiveTemplate, context: TemplateContext): boolean;

package/dist/template-context.js

@@ -0,0 +1,56 @@
+/* The completion item kind of a snippet. */
+export const SNIPPET_KIND = 15;
+/* Sorts a template row after the rows of the same score that a service answers. */
+export function sortAfterServer(key) {
+  return `￿${key}`;
+}
+/* The families a language id counts as; TypeScript builds on JavaScript. */
+export function familiesOf(languageId) {
+  switch (languageId) {
+    case 'javascript':
+    case 'js':
+    case 'mjs':
+    case 'cjs':
+    case 'jsx':
+    case 'javascriptreact':
+      return ['javascript'];
+    case 'typescript':
+    case 'ts':
+    case 'mts':
+    case 'cts':
+    case 'tsx':
+    case 'typescriptreact':
+      return ['javascript', 'typescript'];
+    case 'php':
+      return ['php'];
+    case 'css':
+    case 'scss':
+    case 'less':
+      return ['css'];
+    case 'html':
+    case 'xhtml':
+    case 'vue':
+      return ['html'];
+    case 'xml':
+    case 'svg':
+    case 'xsl':
+      return ['xml'];
+    default:
+      return ['other'];
+  }
+}
+/* The families and the place at a position; an editor that cannot tell has the language of the document, in code. */
+export function templateContextAt(language, position) {
+  const place = language.editor.placeAt?.(position);
+  return place === undefined ? {
+    families: familiesOf(language.languageId),
+    place: 'code'
+  } : {
+    families: familiesOf(place.language),
+    place: place.kind
+  };
+}
+/* Whether a template shares a family with the context and applies to its place. */
+export function templateApplies(template, context) {
+  return template.languages.some(family => context.families.includes(family)) && (template.places ?? ['code']).includes(context.place);
+}

package/dist/templates.d.ts

@@ -0,0 +1,59 @@
+import { BUILT_IN_LIVE_TEMPLATES, BUILT_IN_POSTFIX_TEMPLATES } from './template-builtins.ts';
+export { BUILT_IN_LIVE_TEMPLATES, BUILT_IN_POSTFIX_TEMPLATES };
+export { type TemplatesFeature } from './live-templates.ts';
+export type TemplateLanguage = 'javascript' | 'typescript' | 'php' | 'css' | 'html' | 'xml' | 'other';
+export type TemplatePlace = 'code' | 'comment' | 'string';
+export interface LiveTemplate {
+    readonly id: string;
+    readonly key: string;
+    readonly body: string;
+    readonly description?: string;
+    readonly languages: readonly TemplateLanguage[];
+    readonly places?: readonly TemplatePlace[];
+    readonly group?: string;
+}
+export interface PostfixTemplate {
+    readonly id: string;
+    readonly key: string;
+    readonly body: string;
+    readonly description?: string;
+    readonly example?: string;
+    readonly languages: readonly ('javascript' | 'typescript' | 'php')[];
+    readonly expression?: 'any' | 'statement';
+}
+export interface TemplateSettings {
+    readonly liveInCompletion?: boolean;
+    readonly postfix?: boolean;
+    readonly postfixInCompletion?: boolean;
+}
+export interface LiveTemplateDraft {
+    readonly body: string;
+    readonly languages: readonly TemplateLanguage[];
+    readonly places: readonly TemplatePlace[];
+}
+export interface TemplateRegistryOptions {
+    readonly builtins?: boolean;
+}
+export interface TemplateUpdate {
+    readonly live?: readonly LiveTemplate[];
+    readonly postfix?: readonly PostfixTemplate[];
+    readonly disabled?: readonly string[];
+    readonly settings?: TemplateSettings;
+}
+export declare class TemplateRegistry {
+    private readonly builtins;
+    private readonly listeners;
+    private own;
+    private off;
+    private current;
+    private liveList;
+    private postfixList;
+    constructor(options?: TemplateRegistryOptions);
+    get live(): readonly LiveTemplate[];
+    get postfix(): readonly PostfixTemplate[];
+    get settings(): Required<TemplateSettings>;
+    set(update: TemplateUpdate): void;
+    onChange(listener: () => void): () => void;
+    private listed;
+}
+export declare function checkTemplate(template: LiveTemplate | PostfixTemplate, kind?: 'live' | 'postfix'): string | null;