@enigma-lake/tower-play-controller-sdk 2.0.23 → 2.0.25

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { ReactNode, ReactElement } from 'react';
-import { CurrencyProps, PlayLimitsV2 } from '@enigma-lake/zoot-platform-sdk';
+import { CurrencyProps, SupportedLanguage, PlayLimitsV2, Translator as Translator$1 } from '@enigma-lake/zoot-platform-sdk';
+export { DEFAULT_LANGUAGE, SUPPORTED_LANGUAGES, SUPPORTED_LANGUAGE_CODES, SupportedLanguage, TranslationParams, resolveLanguage } from '@enigma-lake/zoot-platform-sdk';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 declare enum GAME_MODE {
     MANUAL = "manual",
@@ -32,6 +34,47 @@ declare enum RiskTypes {
     MEDIUM = "MEDIUM",
     HIGH = "HIGH"
 }
+declare const DEFAULT_RISK_COLORS: Record<RiskTypes, string>;
+
+type Messages = {
+    playNow: string;
+    playFreeRound: string;
+    selectPlayAmount: string;
+    cashout: string;
+    collect: string;
+    doubleTitle: string;
+    doubleSubtitle: string;
+    startAutoplay: string;
+    stopAutoplay: string;
+    numberOfPlays: string;
+    selectPlayAmountAria: string;
+    playAmountLabel: string;
+    autoLabel: string;
+    selectTileToast: string;
+    riskLabel: string;
+    riskLow: string;
+    riskMedium: string;
+    riskHigh: string;
+    freeRoundLeftOne: string;
+    freeRoundLeftOther: string;
+    freeRoundsModalTitle: string;
+    freeRoundsHave: string;
+    freeRoundsUnitOne: string;
+    freeRoundsUnitOther: string;
+    freeRoundsPerRound: string;
+    freeRoundsExpiresIn: string;
+    dayUnitOne: string;
+    dayUnitOther: string;
+    freeRoundsModalPlayNow: string;
+    freeRoundsModalPlayLater: string;
+    freeRoundsSummaryWon: string;
+    freeRoundsSummaryIn: string;
+    freeRoundsSummaryUnitOne: string;
+    freeRoundsSummaryUnitOther: string;
+    freeRoundsSummaryCredited: string;
+    freeRoundsSummaryClose: string;
+};
+type MessageKey = keyof Messages;
 
 /**
  * Styling / theme-related props for the controller.
@@ -40,26 +83,22 @@ declare enum RiskTypes {
 type StylingWithRisk = {
     panel: {
         bottom?: string;
-        bgColorHex: string;
+        bgColorHex?: string;
         bgColorOpacity?: number;
     };
     dropdown: {
-        bgColorHex: string;
-        riskColorConfig: {
-            [RiskTypes.LOW]: string;
-            [RiskTypes.MEDIUM]: string;
-            [RiskTypes.HIGH]: string;
-        };
+        bgColorHex?: string;
+        riskColorConfig?: Partial<Record<RiskTypes, string>>;
     };
 };
 type StylingWithoutRisk = {
     panel: {
         bottom?: string;
-        bgColorHex: string;
+        bgColorHex?: string;
         bgColorOpacity?: number;
     };
     dropdown: {
-        bgColorHex: string;
+        bgColorHex?: string;
     };
 };
 /**
@@ -132,6 +171,34 @@ type DoubleOrNothingProps = {
     onDoubleOrNothingOpen: () => void;
     onDoubleOrNothingClose: () => void;
 };
+type FreeRoundsOptionsProps = {
+    engaged: boolean;
+    supportsGrantFundedAutoplay?: boolean;
+    roundsRemaining: number;
+    totalRounds: number;
+    stakeCents: number;
+    coinType?: number;
+    currency?: string;
+    expiresAt?: string | number | Date;
+    autoplayActive?: boolean;
+    showIntroModal?: boolean;
+    onPlayNow?: () => void;
+    onPlayLater?: () => void;
+};
+/**
+ * Classic-game layout opts. So towers
+ * can opt into the same left-rail layout used by classic.
+ *
+ * Both fields are OPTIONAL. Omitting `classicGame` (or omitting
+ * `isClassicGame`) keeps the controller rendering exactly as today — so
+ * existing tower integrations are unaffected.
+ */
+type ClassicGameProps = {
+    forceLeftStyle?: boolean;
+    dropdown?: {
+        bgColorHex: string;
+    };
+};
 /**
  * Common controller props that don't depend on the flag.
  */
@@ -140,11 +207,29 @@ type BaseControllerCommon = {
     leftWidgets: Widget[];
     rightWidgets: Widget[];
     centerWidgets: Widget[];
+    language?: SupportedLanguage | string;
     /**
      * Optional so existing integrations don't break.
      * If you want it required, remove the `?`.
      */
     doubleOrNothing?: DoubleOrNothingProps;
+    /**
+     * Opt-in flag for the classic-mines-style layout. When true (and
+     * paired with `classicGame.forceLeftStyle`), the controller renders as
+     * a left rail on desktop. Default: undefined / false → no behavior
+     * change for existing integrations.
+     */
+    isClassicGame?: boolean;
+    classicGame?: ClassicGameProps;
+    /**
+     * Optional free-rounds config. Engagement is binary via the intro modal
+     * (PLAY NOW / PLAY LATER). When engaged, the per-round value is locked to
+     * the grant and a "{N} FREE ROUNDS LEFT" footer renders. When not engaged,
+     * the controller renders exactly as if the user had no free rounds.
+     * Manual-mode only unless the game opts into grant-funded autoplay via
+     * `supportsGrantFundedAutoplay`.
+     */
+    freeRoundsOptions?: FreeRoundsOptionsProps;
 };
 /**
  * Variant when risk & autoplay are enabled (FULL mode).
@@ -256,4 +341,40 @@ interface AutoManualPlayStateProviderProps {
 }
 declare const AutoManualPlayProvider: React.FC<AutoManualPlayStateProviderProps>;
 
-export { AUTO_PLAY_STATE, AutoManualPlayProvider, DOUBLE_OR_NOTHING_STATE, GAME_MODE, type PlayControllerProps, type PlayControllerWithRisk, type PlayControllerWithoutRisk, WIDGET, type Widget, canAutoplaySpaceTrigger, createAutoplayButtonAction, createManualCashoutClickHandler, format, isAutoplayButtonDisabled, isManualCashoutDisabled };
+interface FreeRoundsIntroModalProps {
+    open: boolean;
+    roundsRemaining: number;
+    totalRounds: number;
+    stakeCents: number;
+    coinType?: number;
+    currency?: string;
+    decimals?: number;
+    expiresAt?: string | number | Date;
+    onPlayNow?: () => void;
+    onPlayLater?: () => void;
+}
+declare const FreeRoundsIntroModal: ({ open, roundsRemaining, stakeCents, coinType, currency, decimals, expiresAt, onPlayNow, onPlayLater, }: FreeRoundsIntroModalProps) => react_jsx_runtime.JSX.Element;
+
+interface FreeRoundsSummaryModalProps {
+    totalWinAmount: number;
+    coin: string;
+    roundsPlayed: number;
+    decimals?: number;
+    onClose: () => void;
+}
+declare const FreeRoundsSummaryModal: ({ totalWinAmount, coin, roundsPlayed, decimals, onClose, }: FreeRoundsSummaryModalProps) => react_jsx_runtime.JSX.Element;
+
+type Translator = Translator$1<MessageKey>;
+declare const createTranslator: (language: SupportedLanguage) => Translator;
+
+interface I18nContextValue {
+    language: SupportedLanguage;
+    t: Translator;
+}
+declare const I18nProvider: ({ language, children, }: {
+    language?: string;
+    children: ReactNode;
+}) => react_jsx_runtime.JSX.Element;
+declare const useTranslation: () => I18nContextValue;
+
+export { AUTO_PLAY_STATE, AutoManualPlayProvider, DEFAULT_RISK_COLORS, DOUBLE_OR_NOTHING_STATE, FreeRoundsIntroModal, type FreeRoundsIntroModalProps, type FreeRoundsOptionsProps, FreeRoundsSummaryModal, type FreeRoundsSummaryModalProps, GAME_MODE, I18nProvider, type MessageKey, type Messages, type PlayControllerProps, type PlayControllerWithRisk, type PlayControllerWithoutRisk, type Translator, WIDGET, type Widget, canAutoplaySpaceTrigger, createAutoplayButtonAction, createManualCashoutClickHandler, createTranslator, format, isAutoplayButtonDisabled, isManualCashoutDisabled, useTranslation };