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

package/README.md

@@ -1,130 +1,130 @@
-# TowerPlayController SDK
-
-`@enigma-lake/tower-play-controller-sdk` is a React SDK for Tower-style game controls.
-
-It includes:
-- Manual play
-- Optional autoplay
-- Optional risk selection
-- Play amount controls
-- Currency-aware UI
-- Optional Double Or Nothing button
-- Custom widget slots
-
-`PlayControllerProps` supports two modes:
-- Full mode (default): risk + autoplay enabled
-- Simplified mode: set `withoutRiskAndAutoplay: true`
-
-## Installation
-
-```bash
-npm install @enigma-lake/tower-play-controller-sdk
-```
-
-```tsx
-import "@enigma-lake/tower-play-controller-sdk/dist/style.css";
-```
-
-## Quickstart
-
-```tsx
-import { AutoManualPlayProvider, type PlayControllerProps } from "@enigma-lake/tower-play-controller-sdk";
-
-const config: PlayControllerProps = {
-  currencyOptions,
-  panel: { bgColorHex: "#01243A", bgColorOpacity: 0.5 },
-  dropdown: {
-    bgColorHex: "#01243A",
-    riskColorConfig: {
-      LOW: "#4CAF50",
-      MEDIUM: "#FF9800",
-      HIGH: "#F44336",
-    },
-  },
-  leftWidgets: [],
-  centerWidgets: [],
-  rightWidgets: [],
-  onPlay: () => {},
-  onCashout: () => {},
-  onAutoPlay: (selection, next, stop) => {
-    // call next() when round succeeds, stop() to abort autoplay
-    next();
-  },
-  playOptions: {
-    isPlaying: false,
-    canCashout: false,
-    disabledCashout: false,
-    disabledController: false,
-    disabledMenu: false,
-    displayController: true,
-    disableInput: false,
-    risks: ["LOW", "MEDIUM", "HIGH"],
-    currentRisk: "LOW",
-    onRiskChange: () => {},
-    showAutoPlayToast: () => {},
-    totalBalance: 1000,
-    playHook: () => ({
-      playAmount: 1,
-      setPlayAmount: () => {},
-      playLimits: undefined,
-    }),
-    autoPlayDelay: 1500,
-  },
-};
-
-<AutoManualPlayProvider config={config}>
-  {() => null}
-</AutoManualPlayProvider>;
-```
-
-## Cashout Behavior
-
-`canCashout` and `disabledCashout` are independent:
-
-- `canCashout: false`: cashout button state is not shown.
-- `canCashout: true` + `disabledCashout: false`: cashout is visible and clickable.
-- `canCashout: true` + `disabledCashout: true`: cashout is visible but disabled.
-
-When `disabledCashout` is `true`, click handlers are blocked in:
-- Manual cashout button
-- Autoplay stop/cashout button
-
-## Full Mode vs Simplified Mode
-
-Full mode (default):
-- Requires `onAutoPlay`
-- Includes risk configuration in `playOptions`
-- `dropdown.riskColorConfig` is required
-
-Simplified mode:
-
-```ts
-withoutRiskAndAutoplay: true;
-```
-
-In simplified mode:
-- `onAutoPlay` and `onAutoPlayStop` are not required
-- Risk configuration is removed from `playOptions`
-- `dropdown.riskColorConfig` is not required
-
-## Double Or Nothing (Optional)
-
-```ts
-doubleOrNothing?: {
-  disabled: boolean;
-  display: boolean;
-  onDoubleOrNothingOpen: () => void;
-  onDoubleOrNothingClose: () => void;
-};
-```
-
-Behavior:
-- Shown only when `display` is `true`
-- Sits beside Cashout (cashout width shrinks accordingly)
-- Fully optional and backwards compatible
-
-## Notes
-
-- Import `PlayControllerProps` for strongly typed integration.
-- Keep `playOptions` values in sync with your game engine state.
-- `displayController: false` hides the SDK UI entirely.
+# TowerPlayController SDK
+
+`@enigma-lake/tower-play-controller-sdk` is a React SDK for Tower-style game controls.
+
+It includes:
+- Manual play
+- Optional autoplay
+- Optional risk selection
+- Play amount controls
+- Currency-aware UI
+- Optional Double Or Nothing button
+- Custom widget slots
+
+`PlayControllerProps` supports two modes:
+- Full mode (default): risk + autoplay enabled
+- Simplified mode: set `withoutRiskAndAutoplay: true`
+
+## Installation
+
+```bash
+npm install @enigma-lake/tower-play-controller-sdk
+```
+
+```tsx
+import "@enigma-lake/tower-play-controller-sdk/dist/style.css";
+```
+
+## Quickstart
+
+```tsx
+import { AutoManualPlayProvider, type PlayControllerProps } from "@enigma-lake/tower-play-controller-sdk";
+
+const config: PlayControllerProps = {
+  currencyOptions,
+  panel: { bgColorHex: "#01243A", bgColorOpacity: 0.5 },
+  dropdown: {
+    bgColorHex: "#01243A",
+    riskColorConfig: {
+      LOW: "#4CAF50",
+      MEDIUM: "#FF9800",
+      HIGH: "#F44336",
+    },
+  },
+  leftWidgets: [],
+  centerWidgets: [],
+  rightWidgets: [],
+  onPlay: () => {},
+  onCashout: () => {},
+  onAutoPlay: (selection, next, stop) => {
+    // call next() when round succeeds, stop() to abort autoplay
+    next();
+  },
+  playOptions: {
+    isPlaying: false,
+    canCashout: false,
+    disabledCashout: false,
+    disabledController: false,
+    disabledMenu: false,
+    displayController: true,
+    disableInput: false,
+    risks: ["LOW", "MEDIUM", "HIGH"],
+    currentRisk: "LOW",
+    onRiskChange: () => {},
+    showAutoPlayToast: () => {},
+    totalBalance: 1000,
+    playHook: () => ({
+      playAmount: 1,
+      setPlayAmount: () => {},
+      playLimits: undefined,
+    }),
+    autoPlayDelay: 1500,
+  },
+};
+
+<AutoManualPlayProvider config={config}>
+  {() => null}
+</AutoManualPlayProvider>;
+```
+
+## Cashout Behavior
+
+`canCashout` and `disabledCashout` are independent:
+
+- `canCashout: false`: cashout button state is not shown.
+- `canCashout: true` + `disabledCashout: false`: cashout is visible and clickable.
+- `canCashout: true` + `disabledCashout: true`: cashout is visible but disabled.
+
+When `disabledCashout` is `true`, click handlers are blocked in:
+- Manual cashout button
+- Autoplay stop/cashout button
+
+## Full Mode vs Simplified Mode
+
+Full mode (default):
+- Requires `onAutoPlay`
+- Includes risk configuration in `playOptions`
+- `dropdown.riskColorConfig` is required
+
+Simplified mode:
+
+```ts
+withoutRiskAndAutoplay: true;
+```
+
+In simplified mode:
+- `onAutoPlay` and `onAutoPlayStop` are not required
+- Risk configuration is removed from `playOptions`
+- `dropdown.riskColorConfig` is not required
+
+## Double Or Nothing (Optional)
+
+```ts
+doubleOrNothing?: {
+  disabled: boolean;
+  display: boolean;
+  onDoubleOrNothingOpen: () => void;
+  onDoubleOrNothingClose: () => void;
+};
+```
+
+Behavior:
+- Shown only when `display` is `true`
+- Sits beside Cashout (cashout width shrinks accordingly)
+- Fully optional and backwards compatible
+
+## Notes
+
+- Import `PlayControllerProps` for strongly typed integration.
+- Keep `playOptions` values in sync with your game engine state.
+- `displayController: false` hides the SDK UI entirely.

package/dist/components/base/DifficultySelector/DifficultySelector.d.ts

@@ -1,14 +1,11 @@
 import { PlaySettingsProps } from "../../../types/playController";
 import { RiskTypes } from "./types";
-declare const DifficultySelector: ({ playOptions, dropdownConfig, }: {
+declare const DifficultySelector: ({ playOptions, dropdownConfig, isClassicGame, }: {
     playOptions: PlaySettingsProps;
     dropdownConfig: {
-        bgColorHex: string;
-        riskColorConfig: {
-            [RiskTypes.LOW]: string;
-            [RiskTypes.MEDIUM]: string;
-            [RiskTypes.HIGH]: string;
-        };
+        bgColorHex?: string;
+        riskColorConfig?: Partial<Record<RiskTypes, string>>;
     };
+    isClassicGame?: boolean;
 }) => import("react/jsx-runtime").JSX.Element;
 export default DifficultySelector;

package/dist/components/base/DifficultySelector/Selector.d.ts

@@ -1,3 +1,3 @@
 import { SelectorProps } from "./types";
-declare const Selector: <T>({ currentValue, label, riskColor, values, onSelect, disabled, }: SelectorProps<T>) => import("react/jsx-runtime").JSX.Element;
+declare const Selector: <T>({ currentValue, label, riskColor, values, onSelect, disabled, isClassicGame, formatDisplay, }: SelectorProps<T>) => import("react/jsx-runtime").JSX.Element;
 export default Selector;

package/dist/components/base/DifficultySelector/types.d.ts

@@ -5,6 +5,8 @@ export interface SelectorProps<T> {
     riskColor: string;
     disabled: boolean;
     currentValue: T;
+    isClassicGame?: boolean;
+    formatDisplay?: (value: T) => string;
 }
 export declare enum SELECTORS {
     RISK = "Risk"
@@ -14,3 +16,4 @@ export declare enum RiskTypes {
     MEDIUM = "MEDIUM",
     HIGH = "HIGH"
 }
+export declare const DEFAULT_RISK_COLORS: Record<RiskTypes, string>;

package/dist/components/base/FreeRoundsIntroModal/FreeRoundsIntroModal.d.ts

@@ -0,0 +1,14 @@
+export 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) => import("react/jsx-runtime").JSX.Element;
+export default FreeRoundsIntroModal;

package/dist/components/base/FreeRoundsIntroModal/freeRoundsCoin.d.ts

@@ -0,0 +1,11 @@
+export declare const resolveFreeRoundsCoinLabel: ({ coinType, currency, }: {
+    coinType?: number;
+    currency?: string;
+}) => string;
+export declare const resolveFreeRoundsDecimals: ({ coinType, currency, fallback, }: {
+    coinType?: number;
+    currency?: string;
+    fallback: number;
+}) => number;
+export declare const resolveCoinLabelDecimals: (coin: string) => number;
+export declare const computeExpiresInDays: (expiresAt: string | number | Date | null | undefined, now?: number) => number | null;

package/dist/components/base/FreeRoundsIntroModal/index.d.ts

@@ -0,0 +1,3 @@
+import FreeRoundsIntroModal from "./FreeRoundsIntroModal";
+export type { FreeRoundsIntroModalProps } from "./FreeRoundsIntroModal";
+export default FreeRoundsIntroModal;

package/dist/components/base/FreeRoundsSummaryModal/FreeRoundsSummaryModal.d.ts

@@ -0,0 +1,9 @@
+export interface FreeRoundsSummaryModalProps {
+    totalWinAmount: number;
+    coin: string;
+    roundsPlayed: number;
+    decimals?: number;
+    onClose: () => void;
+}
+declare const FreeRoundsSummaryModal: ({ totalWinAmount, coin, roundsPlayed, decimals, onClose, }: FreeRoundsSummaryModalProps) => import("react/jsx-runtime").JSX.Element;
+export default FreeRoundsSummaryModal;

package/dist/components/base/FreeRoundsSummaryModal/index.d.ts

@@ -0,0 +1,3 @@
+import FreeRoundsSummaryModal from "./FreeRoundsSummaryModal";
+export type { FreeRoundsSummaryModalProps } from "./FreeRoundsSummaryModal";
+export default FreeRoundsSummaryModal;

package/dist/components/base/GroupRow/GroupRow.d.ts

@@ -1,6 +1,7 @@
 import { ComponentProps } from "react";
 export type Props = ComponentProps<"div"> & {
+    isClassicGame?: boolean;
     label?: string;
 };
-declare const GroupRow: ({ children, label, className, ...restProps }: Props) => import("react/jsx-runtime").JSX.Element;
+declare const GroupRow: ({ children, label, className, isClassicGame, ...restProps }: Props) => import("react/jsx-runtime").JSX.Element;
 export default GroupRow;

package/dist/components/base/Input/Input.d.ts

@@ -1,3 +1,5 @@
 import React from "react";
-declare const Input: ({ onChange, disabled, className, max, ...restProps }: React.ComponentProps<"input">) => import("react/jsx-runtime").JSX.Element;
+declare const Input: ({ onChange, disabled, className, max, isClassicGame, ...restProps }: React.ComponentProps<"input"> & {
+    isClassicGame?: boolean;
+}) => import("react/jsx-runtime").JSX.Element;
 export default Input;

package/dist/components/base/InputWithSwitch/InputWithSwitch.d.ts

@@ -6,6 +6,7 @@ export type Props = PropsWithChildren<ComponentProps<"input">> & {
         enabled: boolean;
         disabled: boolean;
     };
+    isClassicGame?: boolean;
 };
-declare const InputWithSwitch: ({ children, switcherConfig, disabled, className, ...restProps }: Props) => import("react/jsx-runtime").JSX.Element;
+declare const InputWithSwitch: ({ children, switcherConfig, disabled, className, isClassicGame, ...restProps }: Props) => import("react/jsx-runtime").JSX.Element;
 export default InputWithSwitch;

package/dist/components/base/PlayController/PlayController.d.ts

@@ -1,6 +1,7 @@
 interface PlayAmountControlProps {
     isDisabled: () => boolean;
     forceRefresh: () => void;
+    lockCurrency?: boolean;
 }
-declare const PlayAmountControl: ({ isDisabled, forceRefresh, }: PlayAmountControlProps) => import("react/jsx-runtime").JSX.Element;
+declare const PlayAmountControl: ({ isDisabled, forceRefresh, lockCurrency, }: PlayAmountControlProps) => import("react/jsx-runtime").JSX.Element;
 export default PlayAmountControl;

package/dist/components/base/PlayValueInput/PlayValueInput.d.ts

@@ -3,6 +3,7 @@ export type Props = PropsWithChildren<ComponentProps<"div">> & {
     disabled: boolean;
     onClick: () => void;
     value: string;
+    isClassicGame?: boolean;
 };
-declare const PlayValueInput: ({ disabled, children, className, value, onClick, }: Props) => import("react/jsx-runtime").JSX.Element;
+declare const PlayValueInput: ({ disabled, children, className, value, onClick, isClassicGame, }: Props) => import("react/jsx-runtime").JSX.Element;
 export default PlayValueInput;

package/dist/components/hooks/usePlayController.d.ts

@@ -29,4 +29,12 @@ export declare const usePlayController: () => {
         setDisplayPlayAmountView: (v: boolean) => void;
         togglePlayAmountView: () => void;
     };
+    freeRounds: {
+        isEngaged: boolean;
+        roundsRemaining: number;
+        totalRounds: number;
+        stakeCents: number;
+        coinType: number | undefined;
+        currency: string | undefined;
+    };
 };

package/dist/components/hooks/useSpacebarButtonTrigger.d.ts

@@ -3,6 +3,7 @@ type UseSpacebarButtonTriggerParams = {
     roleButton: GAME_MODE;
     activeClassName: string;
     canTrigger: () => boolean;
+    suppressed?: boolean;
 };
-export declare const useSpacebarButtonTrigger: ({ roleButton, activeClassName, canTrigger, }: UseSpacebarButtonTriggerParams) => void;
+export declare const useSpacebarButtonTrigger: ({ roleButton, activeClassName, canTrigger, suppressed, }: UseSpacebarButtonTriggerParams) => void;
 export {};

package/dist/i18n/I18nContext.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+import { SupportedLanguage } from "./types";
+import { Translator } from "./translator";
+interface I18nContextValue {
+    language: SupportedLanguage;
+    t: Translator;
+}
+export declare const I18nProvider: ({ language, children, }: {
+    language?: string;
+    children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const useTranslation: () => I18nContextValue;
+export {};

package/dist/i18n/index.d.ts

@@ -0,0 +1,5 @@
+export type { Messages, MessageKey, SupportedLanguage, TranslationParams, } from "./types";
+export { SUPPORTED_LANGUAGE_CODES } from "./types";
+export { DEFAULT_LANGUAGE, SUPPORTED_LANGUAGES, resolveLanguage, createTranslator, } from "./translator";
+export type { Translator } from "./translator";
+export { I18nProvider, useTranslation } from "./I18nContext";

package/dist/i18n/locales/en.d.ts

@@ -0,0 +1,2 @@
+import type { Messages } from "../types";
+export declare const en: Messages;

package/dist/i18n/locales/zh-CN.d.ts

@@ -0,0 +1,2 @@
+import type { Messages } from "../types";
+export declare const zhCN: Messages;

package/dist/i18n/translator.d.ts

@@ -0,0 +1,5 @@
+import { DEFAULT_LANGUAGE, SUPPORTED_LANGUAGES, resolveLanguage, type SupportedLanguage, type Translator as GenericTranslator } from "@enigma-lake/zoot-platform-sdk";
+import { MessageKey } from "./types";
+export type Translator = GenericTranslator<MessageKey>;
+export declare const createTranslator: (language: SupportedLanguage) => Translator;
+export { DEFAULT_LANGUAGE, SUPPORTED_LANGUAGES, resolveLanguage };

package/dist/i18n/types.d.ts

@@ -0,0 +1,41 @@
+export { SUPPORTED_LANGUAGE_CODES } from "@enigma-lake/zoot-platform-sdk";
+export type { SupportedLanguage, TranslationParams, } from "@enigma-lake/zoot-platform-sdk";
+export 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;
+};
+export type MessageKey = keyof Messages;