@magmamath/students-features 1.3.22 → 1.3.23-rc.10

package/dist/typescript/module/features/voice/playing/model/VoicePlayer.model.d.ts

@@ -1,6 +1,7 @@
 import { VoiceTranscriptionsCollection } from './VoiceTranscriptionsCollection';
 import { VoiceFileDownloaderModel } from './VoiceFileDownloader.model';
-import { VoiceTranscriptionsDropdownModel } from './VoiceTranscriptionsDropdown.model';
+import { VoiceTranscriptionModel } from './VoiceTranscription.model';
+import { VoiceTranscriptionTranslationModel } from './VoiceTranscriptionTranslation.model';
 import { AnswerAudio, VoicePlayerApi, VoiceTranscriptionItem } from '../../types';
 import { PlayerModel, PlayerState } from './Player.model';
 import { TranscriptionsDownloaderModel } from './TranscriptionsDownloaderModel';
@@ -11,7 +12,8 @@ type VoiceTranscriptionsPlayerModelParams = {
 export declare class VoicePlayerModel {
     readonly collection: VoiceTranscriptionsCollection;
     readonly downloader: VoiceFileDownloaderModel;
-    readonly dropdown: VoiceTranscriptionsDropdownModel;
+    readonly dropdown: VoiceTranscriptionModel;
+    readonly translation: VoiceTranscriptionTranslationModel;
     readonly playerModel: PlayerModel;
     readonly loader: TranscriptionsDownloaderModel;
     readonly api: VoicePlayerApi;

package/dist/typescript/module/features/voice/playing/model/VoicePlayer.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VoicePlayer.model.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/voice/playing/model/VoicePlayer.model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAA;AACtF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAE/E,KAAK,oCAAoC,GAAG;IAC1C,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CACvB,CAAA;AAMD,qBAAa,gBAAgB;IAC3B,SAAgB,UAAU,gCAAsC;IAChE,SAAgB,UAAU,2BAAiC;IAC3D,SAAgB,QAAQ,mCAAyC;IACjE,SAAgB,WAAW,cAAoB;IAC/C,SAAgB,MAAM,EAAE,6BAA6B,CAAA;IACrD,SAAgB,GAAG,EAAE,cAAc,CAAA;IACnC,OAAO,CAAC,qBAAqB,CAAsB;IACnD,OAAO,CAAC,qBAAqB,CAAQ;IAErC,SAAgB,iBAAiB,kDAA+B;IAChE,SAAgB,KAAK,yCAAgB;IAErC,SAAgB,eAAe,kDAA0D;IACzF,SAAgB,YAAY,gDAAgC;IAE5D,SAAgB,UAAU,+CAAyB;IAEnD,SAAgB,SAAS,aAMxB;IAED,SAAgB,WAAW,aAO1B;gBAEW,MAAM,EAAE,oCAAoC;IAiBjD,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE;IAMtD,OAAO,CAAC,8BAA8B;IAoBtC,OAAO,CAAC,0BAA0B;IAalC,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CA6DhC;IAEF,OAAO,CAAC,WAAW,CAmCjB;IAEK,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAI9C,cAAc,IAAI,sBAAsB,EAAE;IAI1C,kBAAkB;IAIlB,OAAO;IAUP,eAAe,iDAUpB;CACH"}
+{"version":3,"file":"VoicePlayer.model.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/voice/playing/model/VoicePlayer.model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,EAAE,kCAAkC,EAAE,MAAM,uCAAuC,CAAA;AAC1F,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACjF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAE/E,KAAK,oCAAoC,GAAG;IAC1C,GAAG,EAAE,cAAc,CAAA;IACnB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CACvB,CAAA;AAMD,qBAAa,gBAAgB;IAC3B,SAAgB,UAAU,gCAAsC;IAChE,SAAgB,UAAU,2BAAiC;IAC3D,SAAgB,QAAQ,0BAAgC;IACxD,SAAgB,WAAW,EAAE,kCAAkC,CAAA;IAC/D,SAAgB,WAAW,cAAoB;IAC/C,SAAgB,MAAM,EAAE,6BAA6B,CAAA;IACrD,SAAgB,GAAG,EAAE,cAAc,CAAA;IACnC,OAAO,CAAC,qBAAqB,CAAsB;IACnD,OAAO,CAAC,qBAAqB,CAAQ;IAErC,SAAgB,iBAAiB,kDAA+B;IAChE,SAAgB,KAAK,yCAAgB;IAErC,SAAgB,eAAe,kDAA0D;IACzF,SAAgB,YAAY,gDAAgC;IAE5D,SAAgB,UAAU,+CAAyB;IAEnD,SAAgB,SAAS,aAMxB;IAED,SAAgB,WAAW,aAQ1B;gBAEW,MAAM,EAAE,oCAAoC;IAkBjD,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE;IAMtD,OAAO,CAAC,8BAA8B;IAoBtC,OAAO,CAAC,0BAA0B;IAalC,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CA6DhC;IAEF,OAAO,CAAC,WAAW,CAmCjB;IAEK,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAI9C,cAAc,IAAI,sBAAsB,EAAE;IAI1C,kBAAkB;IAIlB,OAAO;IAWP,eAAe,iDAUpB;CACH"}

package/dist/typescript/module/features/voice/playing/model/{VoiceTranscriptionsDropdown.model.d.ts → VoiceTranscription.model.d.ts}

@@ -1,7 +1,7 @@
-export declare class VoiceTranscriptionsDropdownModel {
+export declare class VoiceTranscriptionModel {
     readonly toggleExpand: import("effector").EventCallable<void>;
     readonly setExpanded: import("effector").EventCallable<boolean>;
     readonly reset: import("effector").EventCallable<void>;
     readonly $isExpanded: import("effector").StoreWritable<boolean>;
 }
-//# sourceMappingURL=VoiceTranscriptionsDropdown.model.d.ts.map
+//# sourceMappingURL=VoiceTranscription.model.d.ts.map

package/dist/typescript/module/features/voice/playing/model/VoiceTranscription.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceTranscription.model.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/voice/playing/model/VoiceTranscription.model.ts"],"names":[],"mappings":"AAEA,qBAAa,uBAAuB;IAClC,SAAgB,YAAY,yCAAgB;IAC5C,SAAgB,WAAW,4CAAyB;IACpD,SAAgB,KAAK,yCAAgB;IAErC,SAAgB,WAAW,4CAEP;CACrB"}

package/dist/typescript/module/features/voice/playing/model/VoiceTranscriptionTranslation.model.d.ts

@@ -0,0 +1,25 @@
+import { VoiceTranscriptionsCollection } from './VoiceTranscriptionsCollection';
+import { VoicePlayerApi } from '../../types';
+type TranslateParams = {
+    attemptNumber: number;
+    targetLanguage: string;
+};
+type TranslateResult = {
+    attemptNumber: number;
+    text: string;
+};
+export declare class VoiceTranscriptionTranslationModel {
+    private readonly collection;
+    private readonly service;
+    readonly toggle: import("effector").EventCallable<void>;
+    readonly setActive: import("effector").EventCallable<boolean>;
+    readonly clearCache: import("effector").EventCallable<void>;
+    readonly reset: import("effector").EventCallable<void>;
+    readonly $isActive: import("effector").StoreWritable<boolean>;
+    readonly translate: import("effector").Effect<TranslateParams, TranslateResult | null, Error>;
+    readonly $translations: import("effector").StoreWritable<Record<number, string>>;
+    constructor(collection: VoiceTranscriptionsCollection, api: VoicePlayerApi);
+    getTranslation(attemptNumber: number): string | undefined;
+}
+export {};
+//# sourceMappingURL=VoiceTranscriptionTranslation.model.d.ts.map

package/dist/typescript/module/features/voice/playing/model/VoiceTranscriptionTranslation.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceTranscriptionTranslation.model.d.ts","sourceRoot":"","sources":["../../../../../../../src/features/voice/playing/model/VoiceTranscriptionTranslation.model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAQ5C,KAAK,eAAe,GAAG;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,qBAAa,kCAAkC;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAE5C,SAAgB,MAAM,yCAAgB;IACtC,SAAgB,SAAS,4CAAyB;IAClD,SAAgB,UAAU,yCAAgB;IAC1C,SAAgB,KAAK,yCAAgB;IAErC,SAAgB,SAAS,4CAEL;IAEpB,SAAgB,SAAS,4EAexB;IAED,SAAgB,aAAa,2DAKQ;gBAEzB,UAAU,EAAE,6BAA6B,EAAE,GAAG,EAAE,cAAc;IAcnE,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGjE"}

package/dist/typescript/module/features/voice/types.d.ts

@@ -2,6 +2,8 @@ import { WithAbortSignal } from 'src/types/common.types';
 import { getAvailableInputs } from './helpers';
 import { VoiceRecordModel } from './recording/model/VoiceRecord.model';
 import { AxiosResponse } from 'axios';
+import type { GoogleTranslateProps as GoogleTranslatePayload, GoogleTranslateResponse } from '../translation/providers/google.types';
+export type { GoogleTranslatePayload, GoogleTranslateResponse };
 export type VoiceRecordNotificationTypes = {
     success: (message: string) => void;
     info: (message: string) => void;
@@ -46,6 +48,7 @@ export type VoiceRecorderApi = {
 type TranscriptionStatus = 'pending' | 'completed' | 'failed';
 export type AudioTranscriptResponse = {
     text: string;
+    language: string;
     status: TranscriptionStatus;
 };
 export type VoicePlayerApi = {
@@ -53,12 +56,14 @@ export type VoicePlayerApi = {
     downloadAudioFile: (audioFileId: string, options?: {
         signal?: AbortSignal;
     }) => Promise<AxiosResponse<Blob>>;
+    translateText: (payload: GoogleTranslatePayload) => Promise<GoogleTranslateResponse>;
 };
 export type VoiceTranscriptionItem = {
     attemptNumber: number;
     audioFileId: string;
     _id: string;
     transcript?: string;
+    transcriptLanguage?: string;
     transcriptLoading?: boolean;
     transcriptError?: string;
     audioUri?: string;
@@ -72,5 +77,8 @@ export declare enum RecordButtonVariant {
     DEFAULT = "default",
     ADVANCED = "advanced"
 }
-export {};
+export declare enum VoiceTranscriptionVariant {
+    SMALL = "small",
+    LARGE = "large"
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/typescript/module/features/voice/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/features/voice/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAErC,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC;IAC/C,iBAAiB,EAAE,QAAQ,CAAA;CAC5B,CAAC,CAAA;AAEF,KAAK,mBAAmB,GAAG;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kBAAkB,CAAC,EAAE,OAAO,CAAC,IAAI,GAAG,mBAAmB,CAAC,CAAA;IACxD,UAAU,CAAC,EAAE,eAAe,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,CAAC,SAAS,EAAE,MAAM,GAAG,yBAAyB,CAAA;CAC/C,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAA;AAEjF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,gBAAgB,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC3E,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD,CAAA;AAED,KAAK,mBAAmB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;AAC7D,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,mBAAmB,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;IACjF,iBAAiB,EAAE,CACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAC/B,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IACnC,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,oBAAY,mBAAmB;IAC7B,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/features/voice/types.ts"],"names":[],"mappings":"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"}

package/dist/typescript/module/index.d.ts

@@ -14,4 +14,5 @@ export * from './shared/icons';
 export * from './features/voice';
 export * from './features/featureUsage';
 export * from './features/uiMode';
+export * from './features/translation';
 //# sourceMappingURL=index.d.ts.map

package/dist/typescript/module/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magmamath/students-features",
-  "version": "1.3.22",
+  "version": "1.3.23-rc.10",
   "description": "Magmamath features library",
   "source": "src/index.ts",
   "main": "src/index.ts",

package/src/features/translation/constants.ts

@@ -0,0 +1,4 @@
+export const GBD_TEXT_CACHE_SUFFIX = '::gbd'
+export const DESCRIPTION_CACHE_KEY_SUFFIX = '::description'
+export const CHOICES_CACHE_KEY_SUFFIX = '::choices'
+export const PRACTICE_THEORY_CACHE_KEY_SUFFIX = '::practice-theory'

package/src/features/translation/helpers.ts

@@ -0,0 +1,63 @@
+import { MaskSegmentParams } from './types'
+
+export function replaceMappedTokens(input: string, map: Record<string, string>): string {
+  let result = input
+
+  for (const [original, override] of Object.entries(map)) {
+    const escaped = original.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+    const regex = new RegExp(`\\b${escaped}\\b`, 'gi')
+
+    result = result.replace(regex, override)
+  }
+
+  return result
+}
+
+/**
+ * Masks text segments matched by `regex` with a placeholder,
+ * while preserving spaces around the original match.
+ */
+export const maskSegment = ({
+  text,
+  regex,
+  placeholder,
+  replacements,
+  shouldSkip,
+}: MaskSegmentParams): string => {
+  return text.replace(regex, (match, ...args) => {
+    if (shouldSkip?.(match)) return match
+
+    const offset = args[args.length - 2] as number
+    const input = args[args.length - 1] as string
+
+    const before = offset > 0 ? input[offset - 1] : ''
+    const afterIdx = offset + match.length
+    const after = afterIdx < input.length ? input[afterIdx] : ''
+
+    const leftPad = /\s/.test(before)
+    const rightPad = /\s/.test(after)
+
+    replacements.push({ placeholder, original: match, leftPad, rightPad })
+
+    return placeholder
+  })
+}
+
+const HTML_NAMED_ENTITIES: Record<string, string> = {
+  '&amp;': '&',
+  '&lt;': '<',
+  '&gt;': '>',
+  '&quot;': '"',
+  '&apos;': "'",
+  '&nbsp;': ' ',
+}
+
+export const decodeHtmlEntities = (text: string): string => {
+  return text
+    .replace(/&#(\d+);/g, (_, code: string) => String.fromCharCode(parseInt(code, 10)))
+    .replace(/&#x([0-9a-f]+);/gi, (_, code: string) => String.fromCharCode(parseInt(code, 16)))
+    .replace(
+      /&(amp|lt|gt|quot|apos|nbsp);/g,
+      (match) => HTML_NAMED_ENTITIES[match] ?? match,
+    )
+}

package/src/features/translation/index.ts

@@ -0,0 +1,30 @@
+export { TranslationModel } from './model/TranslationModel'
+export { TranslationService, type TranslateConfigProps } from './model/TranslationService'
+export { TranslationKatexPreprocessor } from './model/TranslationPreprocessor'
+export { TranslationProvider, type LanguageGlossary } from './providers/translation.interface'
+export { GoogleTranslationProvider } from './providers/google/GoogleTranslationProvider'
+export { GoogleTranslateLanguage } from './providers/google/supportedLanguages'
+export type {
+  GoogleTranslateProps,
+  GoogleTranslateResponse,
+  GoogleTranslation,
+} from './providers/google.types'
+export { wordsToPreserve, preservedWordsReplacers } from './preserve/wordsToPreserve'
+export {
+  GBD_TEXT_CACHE_SUFFIX,
+  DESCRIPTION_CACHE_KEY_SUFFIX,
+  CHOICES_CACHE_KEY_SUFFIX,
+  PRACTICE_THEORY_CACHE_KEY_SUFFIX,
+} from './constants'
+export {
+  replaceMappedTokens,
+  maskSegment,
+  decodeHtmlEntities,
+} from './helpers'
+export type {
+  TranslatableProblem,
+  TranslateAllFxParams,
+  TranslateFxParams,
+  Replacement,
+  MaskSegmentParams,
+} from './types'

package/src/features/translation/model/TranslationModel.ts

@@ -0,0 +1,174 @@
+import {
+  attach,
+  combine,
+  createEffect,
+  createEvent,
+  restore,
+  sample,
+  split,
+  Store,
+  Unit,
+} from 'effector'
+import { GoogleTranslationProvider } from '../providers/google/GoogleTranslationProvider'
+import {
+  GoogleTranslateProps,
+  GoogleTranslateResponse,
+} from '../providers/google.types'
+import { TranslationService } from './TranslationService'
+import {
+  preservedWordsReplacers,
+  wordsToPreserve,
+} from '../preserve/wordsToPreserve'
+import {
+  CHOICES_CACHE_KEY_SUFFIX,
+  DESCRIPTION_CACHE_KEY_SUFFIX,
+  GBD_TEXT_CACHE_SUFFIX,
+} from '../constants'
+import {
+  TranslatableProblem,
+  TranslateAllFxParams,
+  TranslateFxParams,
+} from '../types'
+
+type TranslationModelProps<TProblem extends TranslatableProblem> = {
+  $problem: Store<TProblem | null>
+  $problemId: Store<string>
+  $assignmentId: Store<string>
+  $currentProblemIndex: Store<number>
+  $translationLanguageCode: Store<string>
+  $contentLanguageCode?: Store<string>
+  $isTranslationLocked: Store<boolean>
+  languageChanged: Unit<unknown>
+  api: {
+    translateRequest: (payload: GoogleTranslateProps) => Promise<GoogleTranslateResponse>
+  }
+  getGreatWorkFeedbackText?: () => string
+}
+
+export class TranslationModel<TProblem extends TranslatableProblem = TranslatableProblem> {
+  private readonly service: TranslationService
+
+  public readonly toggle = createEvent()
+  public readonly setTranslated = createEvent<boolean>()
+  public readonly reset = createEvent()
+
+  public readonly $isTranslationActive = restore(this.setTranslated, false).reset(this.reset)
+  public readonly $isTranslated = this.$isTranslationActive
+  public readonly $isTranslationPending
+
+  public readonly translateFx
+  public readonly translateAllFx
+
+  constructor({
+    $problem,
+    $problemId,
+    $assignmentId,
+    $currentProblemIndex,
+    $translationLanguageCode,
+    $contentLanguageCode,
+    $isTranslationLocked,
+    languageChanged,
+    api,
+    getGreatWorkFeedbackText,
+  }: TranslationModelProps<TProblem>) {
+    this.service = new TranslationService({
+      preserve: {
+        map: wordsToPreserve,
+        replacers: preservedWordsReplacers,
+      },
+      providers: [new GoogleTranslationProvider({ api })],
+      onError: () => this.reset(),
+    })
+
+    this.service.bindCustomCacheKey(
+      $problemId,
+      (problemId, { target }) => `${problemId}::${target}`,
+    )
+    this.service.bindTargetLanguage($translationLanguageCode)
+    if ($contentLanguageCode) {
+      this.service.bindSourceLanguage($contentLanguageCode)
+    }
+
+    this.translateAllFx = attach({
+      source: {
+        problem: $problem,
+        translationLanguageCode: $translationLanguageCode,
+      },
+      mapParams: (_: void, source) => source,
+      effect: createEffect(({ problem, translationLanguageCode }: TranslateAllFxParams<TProblem>) => {
+        if (!problem) return
+
+        const promises: Promise<unknown>[] = [
+          this.service.translate(problem.richDescription || problem.description, {
+            cacheKeySuffix: DESCRIPTION_CACHE_KEY_SUFFIX,
+          }),
+          this.service.translate(problem.answerVariants, {
+            cacheKeySuffix: CHOICES_CACHE_KEY_SUFFIX,
+          }),
+        ]
+
+        if (getGreatWorkFeedbackText) {
+          promises.push(
+            this.service.translate(getGreatWorkFeedbackText(), {
+              cacheKey: `${translationLanguageCode}${GBD_TEXT_CACHE_SUFFIX}`,
+            }),
+          )
+        }
+
+        return Promise.all(promises)
+      }),
+    })
+
+    this.translateFx = createEffect(({ cacheKey, text }: TranslateFxParams) => {
+      return this.service.translate(text, { cacheKey })
+    })
+
+    this.$isTranslationActive.on(this.translateAllFx.doneData, () => true)
+    this.$isTranslationActive.on(this.translateAllFx.fail, () => false)
+
+    split({
+      source: sample({
+        clock: this.toggle,
+        source: this.$isTranslationActive,
+      }),
+      match: {
+        on: (isTranslated) => !isTranslated,
+        off: (isTranslated) => isTranslated,
+      },
+      cases: {
+        on: this.translateAllFx,
+        off: this.reset,
+      },
+    })
+
+    sample({
+      clock: languageChanged,
+      fn: () => false,
+      target: this.setTranslated,
+    })
+
+    sample({
+      clock: [$currentProblemIndex, $assignmentId, this.$isTranslationActive],
+      source: {
+        isTranslated: this.$isTranslationActive,
+        isLocked: $isTranslationLocked,
+      },
+      filter: ({ isTranslated, isLocked }) => isLocked || isTranslated,
+      target: this.translateAllFx,
+    })
+
+    this.$isTranslationPending = combine(
+      this.translateAllFx.pending,
+      this.translateFx.pending,
+      (isAllPending, isOnePending) => isAllPending || isOnePending,
+    )
+  }
+
+  public getTranslated<T extends string | string[]>(key: string): T | undefined {
+    return this.service.getCached<T>(key)
+  }
+
+  public clearCache() {
+    this.service.reset()
+  }
+}

package/src/features/translation/model/TranslationPreprocessor.ts

@@ -0,0 +1,171 @@
+import { LanguageGlossary } from '../providers/translation.interface'
+import { maskSegment, replaceMappedTokens } from '../helpers'
+import { Replacement } from '../types'
+
+const KATEX_REGEX = /\$(.+?)\$/g
+const NEWLINE_REGEX = /\n/g
+const QUOTE_REGEX = /\\(['"])/g
+const DOLLAR_REGEX = /\\\$/gm
+const COMMA_REGEX = /,/gm
+const DOT_REGEX = /\./gm
+
+const wrapNoTranslate = (content: string) => `<span translate="no">${content}</span>`
+
+const KATEX_PLACEHOLDER = wrapNoTranslate('{{@}}')
+const NEWLINE__PLACEHOLDER = wrapNoTranslate('{{#}}')
+const QUOTE_PLACEHOLDER = wrapNoTranslate('{{""}}')
+const DOLLAR_PLACEHOLDER = wrapNoTranslate('{{!}}')
+const COMMA_PLACEHOLDER = wrapNoTranslate('{{,}}')
+const DOT_PLACEHOLDER = wrapNoTranslate('{{.}}')
+
+const defaultOrderedReplacersMap = [
+  [DOLLAR_REGEX, DOLLAR_PLACEHOLDER],
+  [KATEX_REGEX, KATEX_PLACEHOLDER],
+  [NEWLINE_REGEX, NEWLINE__PLACEHOLDER],
+  [QUOTE_REGEX, QUOTE_PLACEHOLDER],
+  [COMMA_REGEX, COMMA_PLACEHOLDER],
+  [DOT_REGEX, DOT_PLACEHOLDER],
+] as const
+
+type SetupPreservableProps = {
+  glossaryToPreserve: LanguageGlossary
+  preserveWordsReplacers: [RegExp, string][]
+}
+
+export class TranslationKatexPreprocessor {
+  private static plaintextConverter: (text: string) => string = (text) => text
+
+  public static setPlaintextConverter(converter: (text: string) => string) {
+    this.plaintextConverter = converter
+  }
+
+  public static shouldSkipTranslation(text: string | string[] = '') {
+    if (Array.isArray(text)) {
+      return text.every(
+        (t) => this.isMathExpressionOnly(t) || this.isSingleLetter(t) || this.isMathSymbolsOnly(t),
+      )
+    }
+
+    return (
+      this.isMathExpressionOnly(text) || this.isSingleLetter(text) || this.isMathSymbolsOnly(text)
+    )
+  }
+
+  public static isMathExpressionOnly(text: string) {
+    return /^[\d\s+\-*/^=().\\><%!|]+$/.test(text.trim())
+  }
+
+  public static isSingleLetter(text: string) {
+    return /^[a-zA-Z]$/.test(text)
+  }
+
+  public static isMathSymbolsOnly(text: string) {
+    const plainText = this.plaintextConverter(text)
+    const cleanedUp = plainText.replace(/(\\\\|\\|\$|\−|\+|\=|\*|kr|pln|€|£|x|y|\{|\}|\÷)/gi, '')
+    const mathOnlyRegex = /^(?=.*\d)[0-9+\-×÷*/^().\s]+$/u
+    return cleanedUp.length > 0 && mathOnlyRegex.test(cleanedUp)
+  }
+
+  private globalTargetLanguage: string | null = null
+  private preserveWordsMap: LanguageGlossary = {}
+  private preserveWordsReplacers: [RegExp, string][] = []
+
+  private normalizePlaceholderSpacing(text: string) {
+    return text
+      .replace(/\s+(<span[^>]*translate="no"[^>]*>)/g, '$1')
+      .replace(/(<\/span>)\s+/g, '$1')
+  }
+
+  public sanitize(text: string): { sanitized: string; replacements: Replacement[] } {
+    const language = this.globalTargetLanguage ?? ''
+    const replacements: Replacement[] = []
+    let sanitizedText = text
+
+    defaultOrderedReplacersMap.forEach(([regex, placeholder]) => {
+      sanitizedText = maskSegment({
+        text: sanitizedText,
+        regex,
+        placeholder,
+        replacements,
+      })
+    })
+
+    this.preserveWordsReplacers.forEach(([regex, placeholder]) => {
+      const preserveWordsMapTarget = this.preserveWordsMap[language]
+
+      sanitizedText = maskSegment({
+        text: sanitizedText,
+        regex,
+        placeholder,
+        replacements,
+        shouldSkip: (match) =>
+          this.skipCustomReplacerSanitizeWithoutGlossary(match, preserveWordsMapTarget),
+      })
+    })
+
+    return { sanitized: sanitizedText, replacements }
+  }
+
+  public restore(text: string, replacements: Replacement[]) {
+    let restored = this.normalizePlaceholderSpacing(text)
+    replacements.forEach(({ placeholder, original, leftPad, rightPad }) => {
+      const wrapped = `${leftPad ? ' ' : ''}${original}${rightPad ? ' ' : ''}`
+      restored = restored.replace(placeholder, wrapped)
+    })
+
+    return this.applyPreserved(restored)
+  }
+
+  public sanitizeBatch(texts: string[]): { sanitized: string[]; replacements: Replacement[][] } {
+    const sanitized: string[] = []
+    const replacements: Replacement[][] = []
+
+    texts.forEach((t) => {
+      const { sanitized: s, replacements: r } = this.sanitize(t)
+      sanitized.push(s)
+      replacements.push(r)
+    })
+
+    return { sanitized, replacements }
+  }
+
+  public restoreBatch(texts: string[], replacementsArray: Replacement[][]) {
+    return texts.map((t, i) => {
+      const restored = this.restore(t, replacementsArray[i])
+      return this.applyPreserved(restored)
+    })
+  }
+
+  // Glossaries apply after translation response and do not remove words from payload.
+  // This replaces words from the string before sending request to API to completely avoid
+  // translating it. We use it to avoid "context localization" e.g. Google API changes numbers
+  // when units are passed and target language is from a different region. We must preserve
+  // words like "miles" and the exact number in this case.
+  public setupPreservable({ glossaryToPreserve, preserveWordsReplacers }: SetupPreservableProps) {
+    this.preserveWordsMap = glossaryToPreserve
+    this.preserveWordsReplacers = preserveWordsReplacers
+  }
+
+  public setupTarget(language: string) {
+    this.globalTargetLanguage = language
+  }
+
+  private skipCustomReplacerSanitizeWithoutGlossary(
+    match: string,
+    preserveWordsMapTarget?: Record<string, string>,
+  ) {
+    if (!preserveWordsMapTarget) return true
+
+    const normalized = match.toLowerCase()
+    const glossaryKeys = Object.keys(preserveWordsMapTarget).map((key) => key.toLowerCase())
+
+    return !glossaryKeys.includes(normalized)
+  }
+
+  private applyPreserved(restored: string) {
+    const language = this.globalTargetLanguage ?? ''
+    const preservedMap = this.preserveWordsMap[language]
+
+    return preservedMap ? replaceMappedTokens(restored, preservedMap) : restored
+  }
+}