Add MarkEdit.translationService for translation

Author: cyanzhong

README.md

@@ -19,7 +19,7 @@ Add `markedit-api` to your (TypeScript) project's devDependencies:
 ```json
 {
   "devDependencies": {
-    "markedit-api": "https://github.com/MarkEdit-app/MarkEdit-api#v0.16.0"
+    "markedit-api": "https://github.com/MarkEdit-app/MarkEdit-api#v0.17.0"
   }
 }
 ```
@@ -44,6 +44,8 @@ interface MarkEdit {
   editorAPI: TextEditable;
   // Retrieves a generative language model by name.
   languageModel(name: LanguageModelName): LanguageModel;
+  // Retrieves the system translation service.
+  translationService: TranslationService;
   // CodeMirror modules used by MarkEdit.
   codemirror: { view, state, language, langMarkdown, commands, search, autocomplete };
   // Lezer modules used by MarkEdit.

index.d.ts

@@ -55,6 +55,11 @@ export interface MarkEdit {
    */
   languageModel(name: LanguageModelName): LanguageModel;
 
+  /**
+   * Retrieves the system translation service.
+   */
+  translationService: TranslationService;
+
   /**
    * CodeMirror modules used by MarkEdit.
    */
@@ -380,6 +385,22 @@ export type LanguageModelSampling =
   | { mode: 'greedy' }
   | { mode: 'top-k' | 'top-p'; value: number; seed?: number };
 
+/**
+ * The system translation service.
+ */
+export interface TranslationService {
+  /**
+   * Translate the text with language pair.
+   *
+   * Use BCP-47 language tags, such as `en-US`, `zh-CN`.
+   */
+  translate(text: string, languages?: { from?: string; to?: string }): Promise<TranslationResponse>;
+}
+
+export type TranslationResponse =
+  | { succeeded: true; text: string }
+  | { succeeded: false; error: string };
+
 /**
  * Information of a file in the file system.
  */

package.json

@@ -1,6 +1,6 @@
 {
   "name": "markedit-api",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Type definitions for the latest MakrEdit API.",
   "main": "./index.cjs",
   "module": "./index.js",