feat(helper): add mutil-engine translator

Author: kabeep

src/helpers/index.ts

@@ -1,2 +1,3 @@
 export { default as boundary } from './boundary';
 export { default as showLanguageList } from './show-language-list';
+export { default as translator } from './translator';

src/helpers/translator.ts

@@ -0,0 +1,58 @@
+import type {
+    TranslateOptions,
+    TranslationOption,
+} from '@kabeep/node-translate';
+import googleTranslate from '@kabeep/node-translate';
+import { translate as microsoftTranslate } from 'microsoft-translate-api';
+import { OS_LOCALE_ENV } from '../constants';
+import type { ArgumentVector, MicrosoftTranslateOption } from '../shared';
+
+export interface TranslatorOptions
+    extends Omit<TranslateOptions, 'raw'>,
+        Pick<ArgumentVector, 'engine'> {}
+
+const LOCALE_ALIASES: Record<string, string> = {
+    mandarin: 'zh-cn',
+    cantonese: 'zh-tw',
+    'zh-hk': 'zh-tw',
+};
+
+const MICROSOFT_LANG_CODE_DICT: Record<string, string> = {
+    zh: 'zh-hans',
+    'zh-cn': 'zh-hans',
+    'zh-tw': 'zh-hant',
+};
+
+function microsoftLangCodeAdapter(code?: string, adaptive = false) {
+    const isAdaptive = !code || code === 'auto';
+    if (!adaptive && isAdaptive) return null;
+
+    const source = isAdaptive ? OS_LOCALE_ENV : code;
+    const langCode = LOCALE_ALIASES[source] ?? source;
+    return MICROSOFT_LANG_CODE_DICT[langCode] ?? langCode;
+}
+
+async function translator(
+    text: string,
+    options: TranslatorOptions,
+): Promise<TranslationOption | MicrosoftTranslateOption[] | undefined> {
+    const { engine = 'google', ...restOptions } = options;
+    switch (engine) {
+        case 'microsoft': {
+            const { from, to } = options;
+            const sourceLang = microsoftLangCodeAdapter(from);
+            const targetLang = microsoftLangCodeAdapter(to, true);
+            return microsoftTranslate(
+                text,
+                sourceLang,
+                targetLang as string,
+            ) as unknown as MicrosoftTranslateOption[] | undefined;
+        }
+
+        case 'google': {
+            return googleTranslate(text, restOptions);
+        }
+    }
+}
+
+export default translator;

src/shared/index.ts

@@ -1 +1,2 @@
 export type { ArgumentVector } from './argument-vector.type';
+export type { MicrosoftTranslateOption } from './microsoft-translate-option.type';

src/shared/microsoft-translate-option.type.ts

@@ -0,0 +1,27 @@
+interface DetectedLanguageOption {
+    language: string; // lang code
+    score: number; // 0 - 1
+}
+
+interface SentLenOption {
+    srcSentLen: number[];
+    transSentLen: number[];
+}
+
+interface TransliterationOption {
+    script: string;
+    text: string;
+}
+
+interface TranslationOption {
+    text: string;
+    to: string; // lang code
+    sentLen?: SentLenOption;
+    transliteration?: TransliterationOption;
+    alignment?: object;
+}
+
+export interface MicrosoftTranslateOption {
+    detectedLanguage: DetectedLanguageOption;
+    translations: TranslationOption[];
+}