@enigma-lake/mines-play-controller-sdk 3.2.0 → 4.0.0

package/dist/index.mjs

@@ -346,8 +346,135 @@ const SelectMenu = ({ disabled = false }) => {
                     }) })] })) }));
 };
 
+// Supported play-controller languages. Codes are BCP-47 style tags and line up
+// 1:1 with the `code` column seeded in el-auth's `languages` catalog
+// (en, zh-CN). Adding a language = add a code here + a locale file.
+const SUPPORTED_LANGUAGE_CODES = ["en", "zh-CN"];
+
+// English — the fallback language. Any key missing from another locale falls
+// back to the value here.
+const en = {
+    playNow: "PLAY NOW",
+    selectPlayAmount: "SELECT PLAY AMOUNT",
+    cashout: "CASHOUT",
+    collect: "COLLECT",
+    doubleTitle: "DOUBLE",
+    doubleSubtitle: "OR NOTHING",
+    playFreeRound: "PLAY FREE ROUND",
+    startAutoplay: "START AUTOPLAY",
+    stopAutoplay: "STOP AUTOPLAY",
+    startFreeAutoplay: "START FREE AUTOPLAY",
+    numberOfPlays: "Number of Plays",
+    selectTileToast: "Please select at least one tile to start autoplay.",
+    minesLabel: "Mines",
+    selectPlayAmountAria: "Select play amount",
+    freeRoundsModalTitle: "Free Game Rounds",
+    freeRoundsHave: "You have",
+    freeRoundsUnitOne: "FREE GAME ROUND",
+    freeRoundsUnitOther: "FREE GAME ROUNDS",
+    freeRoundsPerRound: "{amount} per round",
+    freeRoundsExpiresIn: "Expires in {days} {unit}",
+    dayUnitOne: "day",
+    dayUnitOther: "days",
+    freeRoundsModalPlayNow: "Play now",
+    freeRoundsModalPlayLater: "Maybe later",
+};
+
+// Simplified Chinese.
+const zhCN = {
+    playNow: "立即游戏",
+    selectPlayAmount: "选择下注金额",
+    cashout: "提现",
+    collect: "收取",
+    doubleTitle: "双倍",
+    doubleSubtitle: "或全无",
+    playFreeRound: "免费游戏",
+    startAutoplay: "开始自动游戏",
+    stopAutoplay: "停止自动游戏",
+    startFreeAutoplay: "开始免费自动游戏",
+    numberOfPlays: "游戏次数",
+    selectTileToast: "请至少选择一个方块以开始自动游戏。",
+    minesLabel: "地雷",
+    selectPlayAmountAria: "选择下注金额",
+    freeRoundsModalTitle: "免费游戏回合",
+    freeRoundsHave: "您有",
+    freeRoundsUnitOne: "个免费游戏回合",
+    freeRoundsUnitOther: "个免费游戏回合",
+    freeRoundsPerRound: "每回合 {amount}",
+    freeRoundsExpiresIn: "{days} {unit}后到期",
+    dayUnitOne: "天",
+    dayUnitOther: "天",
+    freeRoundsModalPlayNow: "立即游戏",
+    freeRoundsModalPlayLater: "稍后再玩",
+};
+
+const DEFAULT_LANGUAGE = "en";
+const SUPPORTED_LANGUAGES = SUPPORTED_LANGUAGE_CODES;
+// Central registry of locale bundles. Adding a language is: add its code to
+// SUPPORTED_LANGUAGE_CODES, create a locale file, and register it here.
+const dictionaries = {
+    en,
+    "zh-CN": zhCN,
+};
+// Normalize an arbitrary language input (e.g. "fr-FR", "ZH", "en-US") to one of
+// the supported codes, falling back to English. Matches exact codes first, then
+// by primary subtag ("fr-FR" -> "fr", "zh" -> "zh-CN").
+const resolveLanguage = (input) => {
+    if (!input) {
+        return DEFAULT_LANGUAGE;
+    }
+    const normalized = input.trim().toLowerCase();
+    if (!normalized) {
+        return DEFAULT_LANGUAGE;
+    }
+    const exact = SUPPORTED_LANGUAGES.find((code) => code.toLowerCase() === normalized);
+    if (exact) {
+        return exact;
+    }
+    const primary = normalized.split("-")[0];
+    const byPrimary = SUPPORTED_LANGUAGES.find((code) => code.toLowerCase().split("-")[0] === primary);
+    return byPrimary ?? DEFAULT_LANGUAGE;
+};
+const interpolate = (template, params) => {
+    if (!params) {
+        return template;
+    }
+    return template.replace(/\{(\w+)\}/g, (match, key) => key in params ? String(params[key]) : match);
+};
+// Build a translator bound to a language. Per-key fallback to English ensures a
+// partially-translated locale never renders a blank string.
+const createTranslator = (language) => {
+    const dictionary = dictionaries[language] ?? dictionaries[DEFAULT_LANGUAGE];
+    const fallback = dictionaries[DEFAULT_LANGUAGE];
+    return (key, params) => {
+        const template = dictionary[key] ?? fallback[key] ?? key;
+        return interpolate(template, params);
+    };
+};
+
+const I18nContext = createContext(undefined);
+// Provider placed at the root of the play-controller tree. `language` is the
+// raw code coming from the host (UserInformation.language); it is normalized to
+// a supported code here.
+const I18nProvider = ({ language, children, }) => {
+    const value = useMemo(() => {
+        const resolved = resolveLanguage(language);
+        return { language: resolved, t: createTranslator(resolved) };
+    }, [language]);
+    return jsx(I18nContext.Provider, { value: value, children: children });
+};
+// Fallback value used when a component renders outside an I18nProvider (e.g. the
+// standalone FreeRoundsIntroModal export). Defaults to English so nothing ever
+// crashes or renders an empty label.
+const DEFAULT_VALUE = {
+    language: DEFAULT_LANGUAGE,
+    t: createTranslator(DEFAULT_LANGUAGE),
+};
+const useTranslation = () => useContext(I18nContext) ?? DEFAULT_VALUE;
+
 const usePlayController = () => {
     const { config, autoPlay: { setNumberOfPlays, numberOfPlays, setPlayedRounds, playedRounds, selection, setState, state, }, playValues: { displayPlayAmountView, setDisplayPlayAmountView, togglePlayAmountView, }, } = useAutoManualPlayState();
+    const { t } = useTranslation();
     const { current } = config.currencyOptions;
     const { isPlaying, canCashout, disabledController, showAutoPlayToast, autoPlayDelay = 1500, playHook, } = config.playOptions;
     const { playAmount: rawPlayAmount, playLimits, setPlayAmount: rawSetPlayAmount, } = playHook?.() ?? {};
@@ -380,6 +507,17 @@ const usePlayController = () => {
         engaged: Boolean(freeRoundsOptions?.engaged),
         remaining: freeRoundsOptions?.roundsRemaining ?? 0,
     };
+    // Per-session accounting for engaged autoplay. roundsRemaining is game-driven
+    // and only decrements via an async refetch AFTER each settlement, so the live
+    // ref can still read stale-high when the loop schedules the next round. We
+    // therefore also count submissions locally: a session that started engaged
+    // may never submit more rounds than the grants available when it started,
+    // regardless of refetch timing.
+    const autoplaySessionRef = useRef({
+        startedEngaged: false,
+        grantsAtStart: 0,
+        roundsSubmitted: 0,
+    });
     const stopAutoplay = () => {
         isAutoplayActiveRef.current = false;
         if (playIntervalRef.current) {
@@ -397,11 +535,23 @@ const usePlayController = () => {
         if (!isAutoplayActiveRef.current) {
             return;
         }
-        // Hard-stop: free-rounds autoplay ends the moment the grants are exhausted.
-        if (freeRoundsRef.current.engaged && freeRoundsRef.current.remaining <= 0) {
-            setNumberOfPlays(AUTOPLAY_DEFAULT_PLAY_ROUNDS_COUNT);
-            stopAutoplay();
-            return;
+        // Hard-stop: an autoplay session that started on free rounds ends the
+        // moment the grants are exhausted or engagement ends mid-session — it must
+        // never submit a paid round. Checked BEFORE each submission so the round
+        // that consumes the last grant completes normally, then the loop halts.
+        // Reads live values via refs (closures here are stale across rounds) plus
+        // the local per-session submission count (the game's roundsRemaining
+        // refetch can lag behind the next scheduled round).
+        const session = autoplaySessionRef.current;
+        if (session.startedEngaged) {
+            const live = freeRoundsRef.current;
+            const grantsExhausted = session.roundsSubmitted >= session.grantsAtStart ||
+                live.remaining <= 0;
+            if (grantsExhausted || !live.engaged) {
+                setNumberOfPlays(AUTOPLAY_DEFAULT_PLAY_ROUNDS_COUNT);
+                stopAutoplay();
+                return;
+            }
         }
         if (remainingPlays < 1 || numberOfPlays === 0) {
             setNumberOfPlays(AUTOPLAY_DEFAULT_PLAY_ROUNDS_COUNT);
@@ -410,6 +560,7 @@ const usePlayController = () => {
         }
         setPlayedRounds(currentPlayedRounds + 1);
         setNumberOfPlays((prev) => Math.max(prev - 1, 0));
+        session.roundsSubmitted += 1;
         config.onAutoPlay(selection, () => {
             if (!isAutoplayActiveRef.current) {
                 return;
@@ -424,7 +575,7 @@ const usePlayController = () => {
         if (selection.length === 0) {
             showAutoPlayToast?.({
                 type: "info",
-                message: "Please select at least one tile to start autoplay.",
+                message: t("selectTileToast"),
             });
             return;
         }
@@ -438,6 +589,15 @@ const usePlayController = () => {
         if (isFreeRoundsEngaged && effectiveNumberOfPlays !== numberOfPlays) {
             setNumberOfPlays(effectiveNumberOfPlays);
         }
+        // Snapshot the free-rounds state for this session. Uses the RAW engaged
+        // flag (not isFreeRoundsEngaged, which also requires remaining > 0) so a
+        // session started while engaged with 0 grants fails closed on the first
+        // loop iteration instead of silently becoming a paid session.
+        autoplaySessionRef.current = {
+            startedEngaged: Boolean(freeRoundsOptions?.engaged),
+            grantsAtStart: freeRoundsOptions?.roundsRemaining ?? 0,
+            roundsSubmitted: 0,
+        };
         isAutoplayActiveRef.current = true;
         setState(AUTO_PLAY_STATE.PLAYING);
         loopRounds(playedRounds, effectiveNumberOfPlays);
@@ -571,12 +731,6 @@ const PlayAmountControl = ({ isDisabled }) => {
                     state === AUTO_PLAY_STATE.PLAYING, onClick: handleTogglePlayAmount, isClassicGame: isClassicGame, children: jsx(SelectMenu, { disabled: isDisabled() }) }), jsx(Button, { className: styles_group.groupItem, onClick: () => adjustPlayAmount({ direction: -1 }), theme: "ghost", disabled: isDisabled(), children: jsx("span", { className: styles_group.x2, children: "-" }) }), jsx(Button, { className: styles_group.groupItem, onClick: () => adjustPlayAmount({ direction: 1 }), theme: "ghost", disabled: isDisabled(), children: jsx("span", { className: cx$1(styles_group.x2, styles_group.last), children: "+" }) })] }));
 };
 
-var AUTOPLAY_LABEL;
-(function (AUTOPLAY_LABEL) {
-    AUTOPLAY_LABEL["START"] = "START AUTOPLAY";
-    AUTOPLAY_LABEL["STOP"] = "STOP AUTOPLAY";
-})(AUTOPLAY_LABEL || (AUTOPLAY_LABEL = {}));
-
 function clamp01(value) {
     if (value < 0) {
         return 0;
@@ -721,6 +875,7 @@ function usePlayControllerButtons(params) {
 
 const AutoPlayController = () => {
     const { config } = useAutoManualPlayState();
+    const { t } = useTranslation();
     const { isValidPlayAmount, freeRounds, playValues: { displayPlayAmountView, togglePlayAmountView }, autoPlay: { isDisabled, state, onPlay, onStopPlay }, } = usePlayController();
     const { current } = config.currencyOptions;
     const roleButton = GAME_MODE.AUTOPLAY;
@@ -770,10 +925,10 @@ const AutoPlayController = () => {
     }, [state]);
     const buttonFallbackLabel = useMemo(() => {
         if (state === AUTO_PLAY_STATE.PLAYING) {
-            return AUTOPLAY_LABEL.STOP;
+            return t("stopAutoplay");
         }
-        return AUTOPLAY_LABEL.START;
-    }, [state]);
+        return t("startAutoplay");
+    }, [state, t]);
     const handleKeyPress = useCallback((event) => {
         if (event.code !== "Space") {
             return;
@@ -856,7 +1011,7 @@ const AutoPlayController = () => {
     const renderButton = useMemo(() => {
         if (displayPlayAmountView) {
             const id = "selectPlayAmount";
-            const label = buttons.resolveLabel(id, "SELECT PLAY AMOUNT");
+            const label = buttons.resolveLabel(id, t("selectPlayAmount"));
             const style = buttons.resolveStyle(id, {
                 pressed: buttons.pressedId === id,
                 disabled: false,
@@ -874,7 +1029,7 @@ const AutoPlayController = () => {
         // STOP button keeps its cashout styling and gains a remaining-rounds
         // count: "STOP AUTOPLAY (N)".
         if (freeRounds.isEngaged && isStart) {
-            return (jsx(Button, { disabled: isButtonDisabled, className: styles_button.buttonFree, style: style, ...buttons.getPressHandlers(buttonId), onClick: buttonAction, roleType: roleButton, children: "START FREE AUTOPLAY" }));
+            return (jsx(Button, { disabled: isButtonDisabled, className: styles_button.buttonFree, style: style, ...buttons.getPressHandlers(buttonId), onClick: buttonAction, roleType: roleButton, children: t("startFreeAutoplay") }));
         }
         let label = buttons.resolveLabel(buttonId, buttonFallbackLabel);
         // Free-rounds engaged: show the remaining grant count on the STOP button
@@ -900,6 +1055,7 @@ const AutoPlayController = () => {
         handleTogglePlayAmount,
         isButtonDisabled,
         roleButton,
+        t,
     ]);
     return (jsxs(Fragment$1, { children: [jsx(PlayAmountControl, { isDisabled: () => isDisabled() || freeRounds.isEngaged }), renderButton] }));
 };
@@ -929,6 +1085,7 @@ const useIsRunningExternal = () => {
 const ManualPlayController = () => {
     const { config, doubleOrNothing } = useAutoManualPlayState();
     const { isRunningExternal } = useIsRunningExternal();
+    const { t } = useTranslation();
     const { isValidPlayAmount, freeRounds, playValues: { displayPlayAmountView, togglePlayAmountView }, manualPlay: { isDisabled, onPlay, canCashout }, } = usePlayController();
     const { current } = config.currencyOptions;
     const roleButton = GAME_MODE.MANUAL;
@@ -1079,7 +1236,7 @@ const ManualPlayController = () => {
     const renderButton = useMemo(() => {
         if (displayPlayAmountView) {
             const id = "selectPlayAmount";
-            const label = buttons.resolveLabel(id, "SELECT PLAY AMOUNT");
+            const label = buttons.resolveLabel(id, t("selectPlayAmount"));
             const style = buttons.resolveStyle(id, {
                 pressed: buttons.pressedId === id,
                 disabled: false,
@@ -1095,7 +1252,7 @@ const ManualPlayController = () => {
             const isDoubleOrNothingDisabled = isCashoutDisabled ||
                 !!config.doubleOrNothing?.disabled ||
                 doubleOrNothing.state === DOUBLE_OR_NOTHING_STATE.PROGRESS;
-            const label = buttons.resolveLabel(id, isRunningExternal ? "COLLECT" : "CASHOUT");
+            const label = buttons.resolveLabel(id, isRunningExternal ? t("collect") : t("cashout"));
             const style = buttons.resolveStyle(id, {
                 pressed: buttons.pressedId === id,
                 disabled: isCashoutDisabled,
@@ -1104,7 +1261,7 @@ const ManualPlayController = () => {
                             [styles_button.buttonRow__cashout]: showDoubleOrNothing,
                         }), style: style, ...buttons.getPressHandlers(id), onClick: handleCashoutClick, roleType: roleButton, children: [label, " ", format(current.possibleWin ?? 0, current.decimals), " ", current.abbr] }), showDoubleOrNothing ? (jsx(Button, { disabled: isDoubleOrNothingDisabled, className: cx$1(styles_button.buttonDON, styles_button.buttonRow__don, {
                             [styles_button.buttonDON__disabled]: isDoubleOrNothingDisabled,
-                        }), onClick: handleDoubleOrNothingClick, roleType: roleButton, children: jsxs("div", { className: styles_button.buttonDON__content, children: [jsx("p", { className: styles_button.buttonDON__title, children: "DOUBLE" }), jsx("p", { className: styles_button.buttonDON__subtitle, children: "OR NOTHING" })] }) })) : null] }));
+                        }), onClick: handleDoubleOrNothingClick, roleType: roleButton, children: jsxs("div", { className: styles_button.buttonDON__content, children: [jsx("p", { className: styles_button.buttonDON__title, children: t("doubleTitle") }), jsx("p", { className: styles_button.buttonDON__subtitle, children: t("doubleSubtitle") })] }) })) : null] }));
         }
         {
             // Game-driven autoplay loop running: the stop-autoplay control owns the
@@ -1121,9 +1278,9 @@ const ManualPlayController = () => {
             // free round. No count on the button — the remaining count lives only
             // in the footer status line.
             if (freeRounds.isEngaged) {
-                return (jsx(Button, { disabled: isButtonDisabled, className: styles_button.buttonFree, style: style, ...buttons.getPressHandlers(id), onClick: onPlay, roleType: roleButton, children: "PLAY FREE ROUND" }));
+                return (jsx(Button, { disabled: isButtonDisabled, className: styles_button.buttonFree, style: style, ...buttons.getPressHandlers(id), onClick: onPlay, roleType: roleButton, children: t("playFreeRound") }));
             }
-            const label = buttons.resolveLabel(id, "PLAY NOW", {
+            const label = buttons.resolveLabel(id, t("playNow"), {
                 disabled: isButtonDisabled,
                 isPlaying: config.playOptions.isPlaying,
             });
@@ -1152,6 +1309,7 @@ const ManualPlayController = () => {
         isRunningExternal,
         onPlay,
         roleButton,
+        t,
     ]);
     return (jsxs(Fragment$1, { children: [jsx(PlayAmountControl, { isDisabled: () => isDisabled() || displayPlayAmountView || freeRounds.isEngaged }), renderButton] }));
 };
@@ -1162,8 +1320,9 @@ var styles$3 = {"backdrop":"FreeRoundsIntroModal-module__backdrop___qIgNx","cont
 // callbacks only; the SDK does no fetching. `onPlayNow` should engage
 // free-rounds mode + close, `onPlayLater` should close and render the
 // controller exactly as if the user had no free rounds for this session.
-const FreeRoundsIntroModal = ({ open, roundsRemaining, stakeCents, coinType, currency, decimals = 2, expiresAt, onPlayNow, onPlayLater, }) => {
+const FreeRoundsIntroModal = ({ open, roundsRemaining, stakeCents, coinType, currency, decimals = 2, expiresAt, language, onPlayNow, onPlayLater, }) => {
     const handleClose = () => onPlayLater?.();
+    const t = useMemo(() => createTranslator(resolveLanguage(language)), [language]);
     const coinLabel = resolveFreeRoundsCoinLabel({ coinType, currency });
     const valueDecimals = resolveFreeRoundsDecimals({
         coinType,
@@ -1171,8 +1330,13 @@ const FreeRoundsIntroModal = ({ open, roundsRemaining, stakeCents, coinType, cur
         fallback: decimals,
     });
     const valueDisplay = format(stakeCents / 100, valueDecimals);
+    const valueAmount = `${valueDisplay}${coinLabel ? ` ${coinLabel}` : ""}`;
     const expiresInDays = daysUntil(expiresAt);
-    return (jsx(Dialog, { open: open, onClose: handleClose, className: styles$3.backdrop, children: jsx("div", { className: styles$3.content, children: jsxs(DialogPanel, { className: styles$3.panel, children: [jsx(DialogTitle, { className: styles$3.header, children: "Free Game Rounds" }), jsxs("div", { className: styles$3.summary, children: ["You have ", jsx("span", { className: styles$3.accent, children: roundsRemaining }), " ", roundsRemaining === 1 ? "FREE GAME ROUND" : "FREE GAME ROUNDS"] }), jsxs("div", { className: styles$3.perRound, children: [valueDisplay, coinLabel ? ` ${coinLabel}` : "", " per round"] }), expiresInDays !== null ? (jsxs("div", { className: styles$3.expiry, children: ["Expires in ", expiresInDays, " ", expiresInDays === 1 ? "day" : "days"] })) : null, jsxs("div", { className: styles$3.actions, children: [jsx("button", { type: "button", className: `${styles$3.button} ${styles$3.playNow}`, onClick: onPlayNow, children: "Play now" }), jsx("button", { type: "button", className: `${styles$3.button} ${styles$3.playLater}`, onClick: onPlayLater, children: "Maybe later" })] })] }) }) }));
+    const roundsUnit = roundsRemaining === 1 ? t("freeRoundsUnitOne") : t("freeRoundsUnitOther");
+    return (jsx(Dialog, { open: open, onClose: handleClose, className: styles$3.backdrop, children: jsx("div", { className: styles$3.content, children: jsxs(DialogPanel, { className: styles$3.panel, children: [jsx(DialogTitle, { className: styles$3.header, children: t("freeRoundsModalTitle") }), jsxs("div", { className: styles$3.summary, children: [t("freeRoundsHave"), " ", jsx("span", { className: styles$3.accent, children: roundsRemaining }), " ", roundsUnit] }), jsx("div", { className: styles$3.perRound, children: t("freeRoundsPerRound", { amount: valueAmount }) }), expiresInDays !== null ? (jsx("div", { className: styles$3.expiry, children: t("freeRoundsExpiresIn", {
+                            days: expiresInDays,
+                            unit: expiresInDays === 1 ? t("dayUnitOne") : t("dayUnitOther"),
+                        }) })) : null, jsxs("div", { className: styles$3.actions, children: [jsx("button", { type: "button", className: `${styles$3.button} ${styles$3.playNow}`, onClick: onPlayNow, children: t("freeRoundsModalPlayNow") }), jsx("button", { type: "button", className: `${styles$3.button} ${styles$3.playLater}`, onClick: onPlayLater, children: t("freeRoundsModalPlayLater") })] })] }) }) }));
 };
 
 var styles_ui = {"base":"UI-module__base___wThyQ","container":"UI-module__container___gMSiK","betForm":"UI-module__betForm___hQkYd","isClassicGame":"UI-module__isClassicGame___zV1we","containerSpread":"UI-module__containerSpread___Axb7e","baseForceLeft":"UI-module__baseForceLeft___xfc-h","disabled":"UI-module__disabled___dnZJX","auto":"UI-module__auto___5peb8","freeRoundsFooter":"UI-module__freeRoundsFooter___AOprS","freeRoundsFooter__count":"UI-module__freeRoundsFooter__count___eHp9g","controllerWidgets":"UI-module__controllerWidgets___x2lBy","sideWidget":"UI-module__sideWidget___WMGRy","centerWidget":"UI-module__centerWidget___sLLUi","left":"UI-module__left___1wtUp","center":"UI-module__center___E0ILH","right":"UI-module__right___yLHvk","controls":"UI-module__controls___Z6L-V"};
@@ -1282,6 +1446,7 @@ var styles$2 = {"base":"PlayValueList-module__base___5duc6","playValuesWrapper":
 
 const PlayValueList = () => {
     const { config } = useAutoManualPlayState();
+    const { t } = useTranslation();
     const isClassicGame = config?.isClassicGame ?? false;
     const { onChangeAmount, playAmount, totalBalance, playValues: { displayPlayAmountView, togglePlayAmountView }, } = usePlayController();
     const { playLimits } = config.playOptions.playHook();
@@ -1316,7 +1481,7 @@ const PlayValueList = () => {
             applyValue(value);
         }
     };
-    return (jsx("div", { className: cx$1(styles$2.base, { [styles$2.isClassicGame]: isClassicGame }), children: jsx("div", { className: cx$1(styles$2.playValuesWrapper), onClick: handleClick, role: "listbox", "aria-label": "Select play amount", "data-testid": "play-value-list", children: playLimits?.[config.currencyOptions.current.code].defaultBetOptions.map((playValue) => (jsx("div", { className: cx$1(styles$2.playValue, {
+    return (jsx("div", { className: cx$1(styles$2.base, { [styles$2.isClassicGame]: isClassicGame }), children: jsx("div", { className: cx$1(styles$2.playValuesWrapper), onClick: handleClick, role: "listbox", "aria-label": t("selectPlayAmountAria"), "data-testid": "play-value-list", children: playLimits?.[config.currencyOptions.current.code].defaultBetOptions.map((playValue) => (jsx("div", { className: cx$1(styles$2.playValue, {
                     [styles$2.selectedPlayValue]: playValue === playAmount,
                     [styles$2.disabledPlayValue]: playValue > totalBalance,
                 }), "data-value": playValue, role: "option", tabIndex: 0, "aria-selected": false, children: format(playValue, config.currencyOptions.current.decimals) }, `${config.currencyOptions.current.code}-${playValue}`))) }) }));
@@ -1379,6 +1544,7 @@ const generateMines = (numberOfMines) => {
 };
 
 const DifficultySelector = ({ playOptions, }) => {
+    const { t } = useTranslation();
     const classicGame = playOptions?.classicGame;
     const disabledController = playOptions.disabledController;
     const disabledMenu = classicGame?.disabledMenu ?? false;
@@ -1393,7 +1559,7 @@ const DifficultySelector = ({ playOptions, }) => {
         }
         onMinesChange(value);
     }
-    return (jsx("div", { className: style_difficulty.base, children: jsx(Selector, { currentValue: currentMines, label: SELECTORS.MINES, values: mines, onSelect: onMinesSelected, disabled: disabledMenu || disabledController }) }));
+    return (jsx("div", { className: style_difficulty.base, children: jsx(Selector, { currentValue: currentMines, label: t("minesLabel"), values: mines, onSelect: onMinesSelected, disabled: disabledMenu || disabledController }) }));
 };
 
 const AutoManualPlayProvider = ({ children, config, }) => {
@@ -1420,6 +1586,10 @@ const AutoManualPlayProvider = ({ children, config, }) => {
     if (isFreeRoundsEngaged) {
         displayedNumberOfPlays = Math.min(displayedNumberOfPlays, freeRoundsRemaining);
     }
+    // Local translator for strings rendered by the provider itself. The provider
+    // sits above the <I18nProvider> it renders, so it cannot use useTranslation();
+    // descendant components (controllers, modal) use the context hook instead.
+    const t = useMemo(() => createTranslator(resolveLanguage(config.language)), [config.language]);
     const togglePlayAmountView = useCallback(() => {
         setDisplayPlayAmountView((v) => !v);
     }, []);
@@ -1539,43 +1709,43 @@ const AutoManualPlayProvider = ({ children, config, }) => {
         displayPlayAmountView,
         togglePlayAmountView,
     ]);
-    return (jsxs(AutoManualPlayStateContext.Provider, { value: contextValue, children: [typeof children === "function" ? children(contextValue) : children, config.playOptions.displayController && (jsx("div", { className: cx$1(styles_ui.base, styles_ui.betForm, {
-                    [styles_ui.baseForceLeft]: config?.classicGame?.forceLeftStyle,
-                    [styles_ui.isClassicGame]: config?.isClassicGame,
-                }), style: {
-                    "--play-bottom": config.panel?.bottom ?? 0,
-                    "--play-panel-bg": hexToRgb(config.panel.bgColorHex ?? "#01243A"),
-                    "--play-panel-bg-opacity": config.panel.opacity ?? 0.5,
-                    "--play-dropdown-bg": hexToRgb(config?.classicGame?.dropdown?.bgColorHex ?? "#01243A"),
-                }, children: jsxs("div", { className: cx$1(styles_ui.container, {
-                        [styles_ui.containerSpread]: config?.classicGame?.forceLeftStyle,
-                    }), children: [jsxs("div", { className: cx$1(styles_ui.controls), children: [jsx(PlayValueList, {}), jsxs("div", { className: cx$1(styles_ui.auto), children: [config.isClassicGame ? (jsx(DifficultySelector, { playOptions: {
-                                                ...config.playOptions,
-                                            } })) : null, jsx(InputWithSwitch, { value: displayedNumberOfPlays, type: "number", onChange: (e) => {
-                                                const next = Number(e.currentTarget.value);
-                                                setNumberOfPlays(isFreeRoundsEngaged
-                                                    ? Math.min(next, freeRoundsRemaining)
-                                                    : next);
-                                            }, placeholder: "Number of Plays", min: 0, max: isFreeRoundsEngaged ? freeRoundsRemaining : 99, disabled: config.playOptions.disabledController ||
-                                                mode === GAME_MODE.MANUAL, switcherConfig: {
-                                                onSwitch: toggleMode,
-                                                isPlaying: isAutoPlaying || config.playOptions.isPlaying,
-                                                enabled: mode !== GAME_MODE.MANUAL,
-                                                disabled: config.playOptions.disabledController ||
-                                                    autoplayState === AUTO_PLAY_STATE.PLAYING,
-                                            }, isClassicGame: config.isClassicGame, children: jsx("span", { className: cx$1({
-                                                    [styles_ui.disabled]: mode !== GAME_MODE.AUTOPLAY ||
-                                                        numberOfPlays !== Infinity ||
-                                                        autoplayState === AUTO_PLAY_STATE.PLAYING ||
-                                                        // Free-rounds autoplay is exactly grant-count: no infinite.
-                                                        isFreeRoundsEngaged,
-                                                }), children: "\u221E" }) })] }), mode === GAME_MODE.MANUAL ? (jsx(ManualPlayController, {})) : (jsx(AutoPlayController, {})), isFreeRoundsEngaged ? (jsxs("div", { className: styles_ui.freeRoundsFooter, children: [jsx("span", { className: styles_ui.freeRoundsFooter__count, children: freeRoundsRemaining }), " ", freeRoundsRemaining === 1
-                                            ? "FREE ROUND LEFT"
-                                            : "FREE ROUNDS LEFT"] })) : null] }), freeRoundsOptions ? (jsx(FreeRoundsIntroModal, { open: showFreeRoundsIntroModal, roundsRemaining: freeRoundsRemaining, totalRounds: freeRoundsOptions.totalRounds, stakeCents: freeRoundsOptions.stakeCents, coinType: freeRoundsOptions.coinType, currency: freeRoundsOptions.currency, decimals: config.currencyOptions.current.decimals, expiresAt: freeRoundsOptions.expiresAt, onPlayNow: freeRoundsOptions.onPlayNow, onPlayLater: freeRoundsOptions.onPlayLater })) : null, jsx(WidgetContainer, { state: autoplayState, displayPlayAmountView: displayPlayAmountView, widgets: {
-                                left: config.leftWidgets,
-                                center: config.centerWidgets,
-                                right: config.rightWidgets,
-                            } })] }) }))] }));
+    return (jsx(I18nProvider, { language: config.language, children: jsxs(AutoManualPlayStateContext.Provider, { value: contextValue, children: [typeof children === "function" ? children(contextValue) : children, config.playOptions.displayController && (jsx("div", { className: cx$1(styles_ui.base, styles_ui.betForm, {
+                        [styles_ui.baseForceLeft]: config?.classicGame?.forceLeftStyle,
+                        [styles_ui.isClassicGame]: config?.isClassicGame,
+                    }), style: {
+                        "--play-bottom": config.panel?.bottom ?? 0,
+                        "--play-panel-bg": hexToRgb(config.panel.bgColorHex ?? "#01243A"),
+                        "--play-panel-bg-opacity": config.panel.opacity ?? 0.5,
+                        "--play-dropdown-bg": hexToRgb(config?.classicGame?.dropdown?.bgColorHex ?? "#01243A"),
+                    }, children: jsxs("div", { className: cx$1(styles_ui.container, {
+                            [styles_ui.containerSpread]: config?.classicGame?.forceLeftStyle,
+                        }), children: [jsxs("div", { className: cx$1(styles_ui.controls), children: [jsx(PlayValueList, {}), jsxs("div", { className: cx$1(styles_ui.auto), children: [config.isClassicGame ? (jsx(DifficultySelector, { playOptions: {
+                                                    ...config.playOptions,
+                                                } })) : null, jsx(InputWithSwitch, { value: displayedNumberOfPlays, type: "number", onChange: (e) => {
+                                                    const next = Number(e.currentTarget.value);
+                                                    setNumberOfPlays(isFreeRoundsEngaged
+                                                        ? Math.min(next, freeRoundsRemaining)
+                                                        : next);
+                                                }, placeholder: t("numberOfPlays"), min: 0, max: isFreeRoundsEngaged ? freeRoundsRemaining : 99, disabled: config.playOptions.disabledController ||
+                                                    mode === GAME_MODE.MANUAL, switcherConfig: {
+                                                    onSwitch: toggleMode,
+                                                    isPlaying: isAutoPlaying || config.playOptions.isPlaying,
+                                                    enabled: mode !== GAME_MODE.MANUAL,
+                                                    disabled: config.playOptions.disabledController ||
+                                                        autoplayState === AUTO_PLAY_STATE.PLAYING,
+                                                }, isClassicGame: config.isClassicGame, children: jsx("span", { className: cx$1({
+                                                        [styles_ui.disabled]: mode !== GAME_MODE.AUTOPLAY ||
+                                                            numberOfPlays !== Infinity ||
+                                                            autoplayState === AUTO_PLAY_STATE.PLAYING ||
+                                                            // Free-rounds autoplay is exactly grant-count: no infinite.
+                                                            isFreeRoundsEngaged,
+                                                    }), children: "\u221E" }) })] }), mode === GAME_MODE.MANUAL ? (jsx(ManualPlayController, {})) : (jsx(AutoPlayController, {})), isFreeRoundsEngaged ? (jsxs("div", { className: styles_ui.freeRoundsFooter, children: [jsx("span", { className: styles_ui.freeRoundsFooter__count, children: freeRoundsRemaining }), " ", freeRoundsRemaining === 1
+                                                ? "FREE ROUND LEFT"
+                                                : "FREE ROUNDS LEFT"] })) : null] }), freeRoundsOptions ? (jsx(FreeRoundsIntroModal, { open: showFreeRoundsIntroModal, roundsRemaining: freeRoundsRemaining, totalRounds: freeRoundsOptions.totalRounds, stakeCents: freeRoundsOptions.stakeCents, coinType: freeRoundsOptions.coinType, currency: freeRoundsOptions.currency, decimals: config.currencyOptions.current.decimals, expiresAt: freeRoundsOptions.expiresAt, onPlayNow: freeRoundsOptions.onPlayNow, onPlayLater: freeRoundsOptions.onPlayLater })) : null, jsx(WidgetContainer, { state: autoplayState, displayPlayAmountView: displayPlayAmountView, widgets: {
+                                    left: config.leftWidgets,
+                                    center: config.centerWidgets,
+                                    right: config.rightWidgets,
+                                } })] }) }))] }) }));
 };
 
 var styles = {"backdrop":"FreeRoundsSummaryModal-module__backdrop___tNi3I","panel":"FreeRoundsSummaryModal-module__panel___2MIEp","header":"FreeRoundsSummaryModal-module__header___-BkpP","summary":"FreeRoundsSummaryModal-module__summary___YExX9","accent":"FreeRoundsSummaryModal-module__accent___z9aBF","hint":"FreeRoundsSummaryModal-module__hint___CYWqA","close":"FreeRoundsSummaryModal-module__close___4-irR"};
@@ -1593,5 +1763,5 @@ const FreeRoundsSummaryModal = ({ totalWinAmount, coin, roundsPlayed, decimals,
     return (jsx(Dialog, { open: true, onClose: onClose, className: styles.backdrop, children: jsxs(DialogPanel, { className: styles.panel, children: [jsx(DialogTitle, { className: styles.header, children: "Free Game Rounds" }), jsxs("div", { className: styles.summary, children: ["You won", " ", jsxs("span", { className: styles.accent, children: [amountDisplay, " ", coin] }), " ", "in ", roundsPlayed, " ", roundsPlayed === 1 ? "free game round" : "free game rounds"] }), jsx("div", { className: styles.hint, children: "Winnings have been credited to your bonus balance." }), jsx("button", { type: "button", className: styles.close, onClick: onClose, children: "Close" })] }) }));
 };
 
-export { AUTO_PLAY_STATE, AutoManualPlayProvider, DOUBLE_OR_NOTHING_STATE, FreeRoundsIntroModal, FreeRoundsSummaryModal, GAME_MODE, WIDGET, format };
+export { AUTO_PLAY_STATE, AutoManualPlayProvider, DEFAULT_LANGUAGE, DOUBLE_OR_NOTHING_STATE, FreeRoundsIntroModal, FreeRoundsSummaryModal, GAME_MODE, I18nProvider, SUPPORTED_LANGUAGES, SUPPORTED_LANGUAGE_CODES, WIDGET, createTranslator, format, resolveLanguage, useTranslation };
 //# sourceMappingURL=index.mjs.map