@open-slot-ui/core 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -1084,9 +1084,19 @@ interface Translator {
     /** Switch the active locale (a no-op for the same locale); fires onChange. */
     setLocale(next: string): void;
     onChange(cb: (locale: string) => void): Dispose;
+    /** Switch social/sweepstakes wording on/off. In social mode `t` resolves from a
+     *  SEPARATE social dictionary first, so social copy can never be mixed into the
+     *  normal keys by accident (by design). No-op if unsupported. */
+    setSocial?(on: boolean): void;
 }
 /** open-ui owns this namespace; the host's translator may override any key. */
 declare const openuiDefaults: Record<string, string>;
+/**
+ * Social / sweepstakes wording — a SEPARATE dictionary (same keys as the normal
+ * ones). Kept apart on purpose so a host can never mix gambling and social copy in
+ * one map: provide your social overrides under `locale.socialMessages`, not inline.
+ */
+declare const openuiSocialDefaults: Record<string, string>;
 /**
  * Zero-dep dictionary translator. Falls back to open-ui defaults, then to the
  * key itself only if nothing is found — but built-in keys always resolve, so the
@@ -1094,16 +1104,22 @@ declare const openuiDefaults: Record<string, string>;
  */
 declare class DictionaryTranslator implements Translator {
     private readonly messages;
+    /** SEPARATE social/sweepstakes dictionary — consulted first in social mode. */
+    private readonly socialMessages;
     private _locale;
+    private _social;
     private readonly subs;
-    constructor(messages: Record<string, Record<string, string>>, locale: string);
+    constructor(messages: Record<string, Record<string, string>>, locale: string, 
+    /** SEPARATE social/sweepstakes dictionary — consulted first in social mode. */
+    socialMessages?: Record<string, Record<string, string>>);
     get locale(): string;
     setLocale(next: string): void;
+    setSocial(on: boolean): void;
     t(key: string, vars?: Record<string, string | number>): string;
     onChange(cb: (locale: string) => void): Dispose;
 }
 /** Convenience factory for a zero-dep dictionary translator. */
-declare function dictionary(messages: Record<string, Record<string, string>>, locale: string): DictionaryTranslator;
+declare function dictionary(messages: Record<string, Record<string, string>>, locale: string, socialMessages?: Record<string, Record<string, string>>): DictionaryTranslator;
 
 interface OpenUIOptions {
     theme?: Theme;
@@ -1183,9 +1199,6 @@ declare class OpenUI {
     readonly settingsPanel: PanelControl;
     readonly musicSlider: SliderControl;
     readonly sfxSlider: SliderControl;
-    readonly rulesButton: ButtonControl;
-    readonly infoPanel: PanelControl;
-    readonly infoClose: ButtonControl;
     readonly turbo: TurboControl;
     readonly autoplay: AutoplayControl;
     readonly bonusButton: ButtonControl;
@@ -1264,20 +1277,21 @@ declare class OpenUI {
      * `localeChanged`; controls' views, subscribed to `locale`, re-render their text.
      */
     setLocale(next: string): void;
-    /** Translate a key (or pass plain text through) via the active translator. In
-     *  social mode, a `<key>.social` variant wins when one resolves — so gambling
-     *  wording (Bet/Buy feature) swaps to sweepstakes terms automatically. */
+    /** Translate a key (or pass plain text through) via the active translator. Social
+     *  wording is resolved by the translator from a SEPARATE social dictionary (see
+     *  `setSocial`), so gambling and social copy can never be mixed by accident. */
     t(key: string, vars?: Record<string, string | number>): string;
     /**
-     * Turn social / sweepstakes mode on or off (one switch). Swaps gambling wording
-     * (Bet/Buy feature → social terms via `<key>.social` i18n) AND, when a `coin` is
-     * given (e.g. `'GC'`/`'SC'`/`'XGC'`), shows balance/bet/net in that coin. Wording
-     * re-renders live; the host can still override any `.social` key.
+     * Turn social / sweepstakes mode on or off (one switch). Flips the translator to
+     * its SEPARATE social dictionary (Bet→Play, Buy feature→Play bonus, etc.) and,
+     * when a `coin` is given (e.g. `'GC'`/`'SC'`), shows balance/bet/net in that coin.
+     * Wording re-renders live. Social copy lives in `locale.socialMessages` — kept
+     * apart from your normal `locale.messages` by design.
      */
     setSocial(on: boolean, coin?: string): void;
     /** Read-back: did the applied jurisdiction disable this feature? (real guard, not
      *  just a hide — `confirmBuy`/autoplay entry points consult this). */
-    isDisabled(feature: 'autoplay' | 'buyFeature' | 'turbo' | 'superTurbo' | 'fullscreen' | 'slamstop' | 'spacebar'): boolean;
+    isDisabled(feature: 'autoplay' | 'buyFeature' | 'turbo' | 'fullscreen' | 'slamstop' | 'spacebar'): boolean;
     /**
      * Start a reality-check reminder (RTS 13). Every `everyMinutes` (WALL-CLOCK, so a
      * backgrounded tab can't cheat it) it emits a `realityCheck` event, stops autoplay,
@@ -1309,7 +1323,6 @@ interface JurisdictionConfig {
     socialCasino?: boolean;
     disabledFullscreen?: boolean;
     disabledTurbo?: boolean;
-    disabledSuperTurbo?: boolean;
     disabledAutoplay?: boolean;
     disabledSlamstop?: boolean;
     disabledSpacebar?: boolean;
@@ -1568,6 +1581,9 @@ interface UISpec {
     locale?: {
         messages: Record<string, Record<string, string>>;
         locale: string;
+        /** SEPARATE social/sweepstakes wording dictionary (same keys as `messages`),
+         *  used only in social mode — kept apart so the two can't be mixed up. */
+        socialMessages?: Record<string, Record<string, string>>;
     };
     /** Block/control id whose `optionSelected` switches the locale. Default 'lang'. */
     localeSelectId?: string;
@@ -1582,9 +1598,6 @@ interface UISpec {
     jurisdiction?: JurisdictionConfig;
     /** Initial RTP percentage for the RTP readout (e.g. 96 → "96.0%"). */
     rtp?: number;
-    /** Put the compliance readouts (net · RTP · session) in a thin status bar pinned
-     *  to the `'top'` or `'bottom'` edge instead of at screen corners. */
-    statusBar?: 'top' | 'bottom';
     /** Game name + version — shown in the menu footer (support / certification). */
     game?: {
         name?: string;
@@ -1792,24 +1805,4 @@ declare function buildBetLadder(cfg: RgsBetConfig, divisor?: number): {
 /** Clamp a stake (major units) to the RGS min/max and snap to `stepBet`. Pure. */
 declare function clampBet(amount: number, cfg: RgsBetConfig, divisor?: number): number;
 
-/**
- * Win-celebration classifier — the RTS 14F guardrail. open-ui doesn't render the win
- * (the game does), but this helper lets a game decide HOW LOUD to celebrate without
- * ever celebrating a return ≤ the stake (the most-fined responsible-gambling rule).
- */
-interface WinTier {
-    name: string;
-    /** Minimum win/stake multiplier for this tier. */
-    minMultiplier: number;
-}
-/** Default escalation tiers (multipliers of stake). */
-declare const DEFAULT_WIN_TIERS: readonly WinTier[];
-/**
- * Classify a win for celebration. Returns `'none'` when the win is ≤ the stake (so a
- * "win" that returns less than was staked is NEVER celebrated — UKGC RTS 14F), else
- * `'win'` for a positive win below the first tier, or the highest tier whose
- * multiplier threshold is met. Pure + total.
- */
-declare function winTier(win: number, stake: number, tiers?: readonly WinTier[]): string;
-
-export { API_AMOUNT_DIVISOR, type Anchor, AutoplayControl, type AutoplayLimits, type AutoplayMode, type AutoplayOptions, BLOCK_KINDS, type BlockFactory, type BlockSpec, type Breakpoint, type BuiltPanel, ButtonControl, type ButtonOptions, CURRENCY_TABLE, CardControl, type CardOptions, type ComposeMenuOptions, Control, type ControlOptions, type ControlOverride, ControlRegistry, type ControlSnapshot, type CurrencyInfo, type CurrencySpec, DEFAULT_MENU_TITLES, DEFAULT_NOTICE_ACTION, DEFAULT_WIN_TIERS, type DeepPartial, DictionaryTranslator, type Dispose, EventBus, EventLog, type EventLogOptions, type EventMap, Fade, type HostHooks, type JurisdictionConfig, type KnownControlId, LOCALE_LABELS, type LayoutConfig, type LayoutSpec, type LoggedEvent, type MenuSpec, type NoticeAction, type NoticeOptions, OpenUI, type OpenUIEvents, type OpenUIOptions, type Orientation, PanelControl, type PanelOptions, type PanelSpec, type PanelVariant, Parallel, type Placement, Pulse, RGS_ERROR_KEYS, ReadoutControl, type ReadoutKind, type ReadoutOptions, type RealityCheckOptions, type Rect, type ResponsiveKey, type ResponsiveOverride, type RgsBetConfig, type RgsErrorCode, type RgsErrorOptions, type ScreenState, SelectControl, type SelectControlOptions, type SelectOption, Sequence, Signal, SliderControl, type SliderOptions, type SpecIssue, SpinControl, type SpinPress, type SpinSpec, Squish, type StateDef, type StateMap, StepperControl, type StepperOptions, type Subscribable, type Theme, type ThemeChoice, type ThemeIssue, type ThemeOverrides, type ThemePreset, ToggleControl, type ToggleOptions, type Transition, type Translator, TurboControl, type TurboOptions, type TurboSpec, Turn, type UISpec, ValueDisplay, type ValueDisplayOptions, type ViewInspect, type WinTier, applyJurisdiction, breakpointFor, buildBetLadder, buildBlocks, buildPanel, buttonBlocks, clampBet, clampDecimals, clampDigits, clampMinDigits, composeMenu, computeScreen, createUI, defaultHudSpec, defaultLayoutConfig, defaultTheme, defineUI, dictionary, displayDigits, effect, errorBlocks, extendTheme, formatAmount, installResponsive, integerDigits, isSafeColor, isSocialCurrency, openuiDefaults, resolveCurrency, resolvePlacement, resolveTheme, resolveTurboModes, safeAmount, sanitizeThemeOverrides, themePresets, validateSpec, valueFitMaxWidth, winTier };
+export { API_AMOUNT_DIVISOR, type Anchor, AutoplayControl, type AutoplayLimits, type AutoplayMode, type AutoplayOptions, BLOCK_KINDS, type BlockFactory, type BlockSpec, type Breakpoint, type BuiltPanel, ButtonControl, type ButtonOptions, CURRENCY_TABLE, CardControl, type CardOptions, type ComposeMenuOptions, Control, type ControlOptions, type ControlOverride, ControlRegistry, type ControlSnapshot, type CurrencyInfo, type CurrencySpec, DEFAULT_MENU_TITLES, DEFAULT_NOTICE_ACTION, type DeepPartial, DictionaryTranslator, type Dispose, EventBus, EventLog, type EventLogOptions, type EventMap, Fade, type HostHooks, type JurisdictionConfig, type KnownControlId, LOCALE_LABELS, type LayoutConfig, type LayoutSpec, type LoggedEvent, type MenuSpec, type NoticeAction, type NoticeOptions, OpenUI, type OpenUIEvents, type OpenUIOptions, type Orientation, PanelControl, type PanelOptions, type PanelSpec, type PanelVariant, Parallel, type Placement, Pulse, RGS_ERROR_KEYS, ReadoutControl, type ReadoutKind, type ReadoutOptions, type RealityCheckOptions, type Rect, type ResponsiveKey, type ResponsiveOverride, type RgsBetConfig, type RgsErrorCode, type RgsErrorOptions, type ScreenState, SelectControl, type SelectControlOptions, type SelectOption, Sequence, Signal, SliderControl, type SliderOptions, type SpecIssue, SpinControl, type SpinPress, type SpinSpec, Squish, type StateDef, type StateMap, StepperControl, type StepperOptions, type Subscribable, type Theme, type ThemeChoice, type ThemeIssue, type ThemeOverrides, type ThemePreset, ToggleControl, type ToggleOptions, type Transition, type Translator, TurboControl, type TurboOptions, type TurboSpec, Turn, type UISpec, ValueDisplay, type ValueDisplayOptions, type ViewInspect, applyJurisdiction, breakpointFor, buildBetLadder, buildBlocks, buildPanel, buttonBlocks, clampBet, clampDecimals, clampDigits, clampMinDigits, composeMenu, computeScreen, createUI, defaultHudSpec, defaultLayoutConfig, defaultTheme, defineUI, dictionary, displayDigits, effect, errorBlocks, extendTheme, formatAmount, installResponsive, integerDigits, isSafeColor, isSocialCurrency, openuiDefaults, openuiSocialDefaults, resolveCurrency, resolvePlacement, resolveTheme, resolveTurboModes, safeAmount, sanitizeThemeOverrides, themePresets, validateSpec, valueFitMaxWidth };

package/dist/index.d.ts

@@ -1084,9 +1084,19 @@ interface Translator {
     /** Switch the active locale (a no-op for the same locale); fires onChange. */
     setLocale(next: string): void;
     onChange(cb: (locale: string) => void): Dispose;
+    /** Switch social/sweepstakes wording on/off. In social mode `t` resolves from a
+     *  SEPARATE social dictionary first, so social copy can never be mixed into the
+     *  normal keys by accident (by design). No-op if unsupported. */
+    setSocial?(on: boolean): void;
 }
 /** open-ui owns this namespace; the host's translator may override any key. */
 declare const openuiDefaults: Record<string, string>;
+/**
+ * Social / sweepstakes wording — a SEPARATE dictionary (same keys as the normal
+ * ones). Kept apart on purpose so a host can never mix gambling and social copy in
+ * one map: provide your social overrides under `locale.socialMessages`, not inline.
+ */
+declare const openuiSocialDefaults: Record<string, string>;
 /**
  * Zero-dep dictionary translator. Falls back to open-ui defaults, then to the
  * key itself only if nothing is found — but built-in keys always resolve, so the
@@ -1094,16 +1104,22 @@ declare const openuiDefaults: Record<string, string>;
  */
 declare class DictionaryTranslator implements Translator {
     private readonly messages;
+    /** SEPARATE social/sweepstakes dictionary — consulted first in social mode. */
+    private readonly socialMessages;
     private _locale;
+    private _social;
     private readonly subs;
-    constructor(messages: Record<string, Record<string, string>>, locale: string);
+    constructor(messages: Record<string, Record<string, string>>, locale: string, 
+    /** SEPARATE social/sweepstakes dictionary — consulted first in social mode. */
+    socialMessages?: Record<string, Record<string, string>>);
     get locale(): string;
     setLocale(next: string): void;
+    setSocial(on: boolean): void;
     t(key: string, vars?: Record<string, string | number>): string;
     onChange(cb: (locale: string) => void): Dispose;
 }
 /** Convenience factory for a zero-dep dictionary translator. */
-declare function dictionary(messages: Record<string, Record<string, string>>, locale: string): DictionaryTranslator;
+declare function dictionary(messages: Record<string, Record<string, string>>, locale: string, socialMessages?: Record<string, Record<string, string>>): DictionaryTranslator;
 
 interface OpenUIOptions {
     theme?: Theme;
@@ -1183,9 +1199,6 @@ declare class OpenUI {
     readonly settingsPanel: PanelControl;
     readonly musicSlider: SliderControl;
     readonly sfxSlider: SliderControl;
-    readonly rulesButton: ButtonControl;
-    readonly infoPanel: PanelControl;
-    readonly infoClose: ButtonControl;
     readonly turbo: TurboControl;
     readonly autoplay: AutoplayControl;
     readonly bonusButton: ButtonControl;
@@ -1264,20 +1277,21 @@ declare class OpenUI {
      * `localeChanged`; controls' views, subscribed to `locale`, re-render their text.
      */
     setLocale(next: string): void;
-    /** Translate a key (or pass plain text through) via the active translator. In
-     *  social mode, a `<key>.social` variant wins when one resolves — so gambling
-     *  wording (Bet/Buy feature) swaps to sweepstakes terms automatically. */
+    /** Translate a key (or pass plain text through) via the active translator. Social
+     *  wording is resolved by the translator from a SEPARATE social dictionary (see
+     *  `setSocial`), so gambling and social copy can never be mixed by accident. */
     t(key: string, vars?: Record<string, string | number>): string;
     /**
-     * Turn social / sweepstakes mode on or off (one switch). Swaps gambling wording
-     * (Bet/Buy feature → social terms via `<key>.social` i18n) AND, when a `coin` is
-     * given (e.g. `'GC'`/`'SC'`/`'XGC'`), shows balance/bet/net in that coin. Wording
-     * re-renders live; the host can still override any `.social` key.
+     * Turn social / sweepstakes mode on or off (one switch). Flips the translator to
+     * its SEPARATE social dictionary (Bet→Play, Buy feature→Play bonus, etc.) and,
+     * when a `coin` is given (e.g. `'GC'`/`'SC'`), shows balance/bet/net in that coin.
+     * Wording re-renders live. Social copy lives in `locale.socialMessages` — kept
+     * apart from your normal `locale.messages` by design.
      */
     setSocial(on: boolean, coin?: string): void;
     /** Read-back: did the applied jurisdiction disable this feature? (real guard, not
      *  just a hide — `confirmBuy`/autoplay entry points consult this). */
-    isDisabled(feature: 'autoplay' | 'buyFeature' | 'turbo' | 'superTurbo' | 'fullscreen' | 'slamstop' | 'spacebar'): boolean;
+    isDisabled(feature: 'autoplay' | 'buyFeature' | 'turbo' | 'fullscreen' | 'slamstop' | 'spacebar'): boolean;
     /**
      * Start a reality-check reminder (RTS 13). Every `everyMinutes` (WALL-CLOCK, so a
      * backgrounded tab can't cheat it) it emits a `realityCheck` event, stops autoplay,
@@ -1309,7 +1323,6 @@ interface JurisdictionConfig {
     socialCasino?: boolean;
     disabledFullscreen?: boolean;
     disabledTurbo?: boolean;
-    disabledSuperTurbo?: boolean;
     disabledAutoplay?: boolean;
     disabledSlamstop?: boolean;
     disabledSpacebar?: boolean;
@@ -1568,6 +1581,9 @@ interface UISpec {
     locale?: {
         messages: Record<string, Record<string, string>>;
         locale: string;
+        /** SEPARATE social/sweepstakes wording dictionary (same keys as `messages`),
+         *  used only in social mode — kept apart so the two can't be mixed up. */
+        socialMessages?: Record<string, Record<string, string>>;
     };
     /** Block/control id whose `optionSelected` switches the locale. Default 'lang'. */
     localeSelectId?: string;
@@ -1582,9 +1598,6 @@ interface UISpec {
     jurisdiction?: JurisdictionConfig;
     /** Initial RTP percentage for the RTP readout (e.g. 96 → "96.0%"). */
     rtp?: number;
-    /** Put the compliance readouts (net · RTP · session) in a thin status bar pinned
-     *  to the `'top'` or `'bottom'` edge instead of at screen corners. */
-    statusBar?: 'top' | 'bottom';
     /** Game name + version — shown in the menu footer (support / certification). */
     game?: {
         name?: string;
@@ -1792,24 +1805,4 @@ declare function buildBetLadder(cfg: RgsBetConfig, divisor?: number): {
 /** Clamp a stake (major units) to the RGS min/max and snap to `stepBet`. Pure. */
 declare function clampBet(amount: number, cfg: RgsBetConfig, divisor?: number): number;
 
-/**
- * Win-celebration classifier — the RTS 14F guardrail. open-ui doesn't render the win
- * (the game does), but this helper lets a game decide HOW LOUD to celebrate without
- * ever celebrating a return ≤ the stake (the most-fined responsible-gambling rule).
- */
-interface WinTier {
-    name: string;
-    /** Minimum win/stake multiplier for this tier. */
-    minMultiplier: number;
-}
-/** Default escalation tiers (multipliers of stake). */
-declare const DEFAULT_WIN_TIERS: readonly WinTier[];
-/**
- * Classify a win for celebration. Returns `'none'` when the win is ≤ the stake (so a
- * "win" that returns less than was staked is NEVER celebrated — UKGC RTS 14F), else
- * `'win'` for a positive win below the first tier, or the highest tier whose
- * multiplier threshold is met. Pure + total.
- */
-declare function winTier(win: number, stake: number, tiers?: readonly WinTier[]): string;
-
-export { API_AMOUNT_DIVISOR, type Anchor, AutoplayControl, type AutoplayLimits, type AutoplayMode, type AutoplayOptions, BLOCK_KINDS, type BlockFactory, type BlockSpec, type Breakpoint, type BuiltPanel, ButtonControl, type ButtonOptions, CURRENCY_TABLE, CardControl, type CardOptions, type ComposeMenuOptions, Control, type ControlOptions, type ControlOverride, ControlRegistry, type ControlSnapshot, type CurrencyInfo, type CurrencySpec, DEFAULT_MENU_TITLES, DEFAULT_NOTICE_ACTION, DEFAULT_WIN_TIERS, type DeepPartial, DictionaryTranslator, type Dispose, EventBus, EventLog, type EventLogOptions, type EventMap, Fade, type HostHooks, type JurisdictionConfig, type KnownControlId, LOCALE_LABELS, type LayoutConfig, type LayoutSpec, type LoggedEvent, type MenuSpec, type NoticeAction, type NoticeOptions, OpenUI, type OpenUIEvents, type OpenUIOptions, type Orientation, PanelControl, type PanelOptions, type PanelSpec, type PanelVariant, Parallel, type Placement, Pulse, RGS_ERROR_KEYS, ReadoutControl, type ReadoutKind, type ReadoutOptions, type RealityCheckOptions, type Rect, type ResponsiveKey, type ResponsiveOverride, type RgsBetConfig, type RgsErrorCode, type RgsErrorOptions, type ScreenState, SelectControl, type SelectControlOptions, type SelectOption, Sequence, Signal, SliderControl, type SliderOptions, type SpecIssue, SpinControl, type SpinPress, type SpinSpec, Squish, type StateDef, type StateMap, StepperControl, type StepperOptions, type Subscribable, type Theme, type ThemeChoice, type ThemeIssue, type ThemeOverrides, type ThemePreset, ToggleControl, type ToggleOptions, type Transition, type Translator, TurboControl, type TurboOptions, type TurboSpec, Turn, type UISpec, ValueDisplay, type ValueDisplayOptions, type ViewInspect, type WinTier, applyJurisdiction, breakpointFor, buildBetLadder, buildBlocks, buildPanel, buttonBlocks, clampBet, clampDecimals, clampDigits, clampMinDigits, composeMenu, computeScreen, createUI, defaultHudSpec, defaultLayoutConfig, defaultTheme, defineUI, dictionary, displayDigits, effect, errorBlocks, extendTheme, formatAmount, installResponsive, integerDigits, isSafeColor, isSocialCurrency, openuiDefaults, resolveCurrency, resolvePlacement, resolveTheme, resolveTurboModes, safeAmount, sanitizeThemeOverrides, themePresets, validateSpec, valueFitMaxWidth, winTier };
+export { API_AMOUNT_DIVISOR, type Anchor, AutoplayControl, type AutoplayLimits, type AutoplayMode, type AutoplayOptions, BLOCK_KINDS, type BlockFactory, type BlockSpec, type Breakpoint, type BuiltPanel, ButtonControl, type ButtonOptions, CURRENCY_TABLE, CardControl, type CardOptions, type ComposeMenuOptions, Control, type ControlOptions, type ControlOverride, ControlRegistry, type ControlSnapshot, type CurrencyInfo, type CurrencySpec, DEFAULT_MENU_TITLES, DEFAULT_NOTICE_ACTION, type DeepPartial, DictionaryTranslator, type Dispose, EventBus, EventLog, type EventLogOptions, type EventMap, Fade, type HostHooks, type JurisdictionConfig, type KnownControlId, LOCALE_LABELS, type LayoutConfig, type LayoutSpec, type LoggedEvent, type MenuSpec, type NoticeAction, type NoticeOptions, OpenUI, type OpenUIEvents, type OpenUIOptions, type Orientation, PanelControl, type PanelOptions, type PanelSpec, type PanelVariant, Parallel, type Placement, Pulse, RGS_ERROR_KEYS, ReadoutControl, type ReadoutKind, type ReadoutOptions, type RealityCheckOptions, type Rect, type ResponsiveKey, type ResponsiveOverride, type RgsBetConfig, type RgsErrorCode, type RgsErrorOptions, type ScreenState, SelectControl, type SelectControlOptions, type SelectOption, Sequence, Signal, SliderControl, type SliderOptions, type SpecIssue, SpinControl, type SpinPress, type SpinSpec, Squish, type StateDef, type StateMap, StepperControl, type StepperOptions, type Subscribable, type Theme, type ThemeChoice, type ThemeIssue, type ThemeOverrides, type ThemePreset, ToggleControl, type ToggleOptions, type Transition, type Translator, TurboControl, type TurboOptions, type TurboSpec, Turn, type UISpec, ValueDisplay, type ValueDisplayOptions, type ViewInspect, applyJurisdiction, breakpointFor, buildBetLadder, buildBlocks, buildPanel, buttonBlocks, clampBet, clampDecimals, clampDigits, clampMinDigits, composeMenu, computeScreen, createUI, defaultHudSpec, defaultLayoutConfig, defaultTheme, defineUI, dictionary, displayDigits, effect, errorBlocks, extendTheme, formatAmount, installResponsive, integerDigits, isSafeColor, isSocialCurrency, openuiDefaults, openuiSocialDefaults, resolveCurrency, resolvePlacement, resolveTheme, resolveTurboModes, safeAmount, sanitizeThemeOverrides, themePresets, validateSpec, valueFitMaxWidth };

package/dist/index.js

@@ -1170,9 +1170,6 @@ function validateSpec(spec) {
     if (spec.rtp != null && !(typeof spec.rtp === "number" && Number.isFinite(spec.rtp))) {
       add("error", "rtp", "bad-rtp", `rtp must be a number, got ${String(spec.rtp)}`);
     }
-    if (spec.statusBar != null && spec.statusBar !== "top" && spec.statusBar !== "bottom") {
-      add("error", "statusBar", "bad-statusbar", `statusBar must be 'top' or 'bottom', got "${String(spec.statusBar)}"`);
-    }
     if (spec.realityCheck != null && !(typeof spec.realityCheck.everyMinutes === "number" && spec.realityCheck.everyMinutes > 0)) {
       add("error", "realityCheck.everyMinutes", "bad-interval", "realityCheck.everyMinutes must be a number > 0");
     }
@@ -1312,7 +1309,6 @@ function applyJurisdiction(ui, jur) {
     lockHidden("bonus");
     ui.bonusButton.disable();
   }
-  if (jur.disabledSuperTurbo && ui.turbo.modeCount > 2) ui.turbo.setModes(["off", "on"]);
   if (jur.disabledSlamstop) ui.spin.allowSlamStop.set(false);
   if (jur.disabledSpacebar) {
     ui.spin.holdToSpin = false;
@@ -1386,13 +1382,6 @@ var openuiDefaults = {
   "openui.buyFeature.title": "Buy feature",
   "openui.buyFeature.message": "Buy this feature now?",
   "openui.freeSpins": "FS",
-  // ── social / sweepstakes wording (used when `ui.social` is on; see OpenUI.t) ──
-  // open-ui resolves `<key>.social` first in social mode, falling back to the base
-  // key. These are the gambling-loaded terms a sweepstakes jurisdiction must avoid;
-  // override any of them (or add `openui.bet.social` etc.) in your messages dict.
-  "openui.buyFeature.title.social": "Play bonus",
-  "openui.buyFeature.message.social": "Play this bonus now?",
-  "openui.win.social": "Prize",
   // reality check (RTS 13) — {{minutes}} is interpolated by open-ui's scheduler
   "openui.realityCheck.title": "Reality check",
   "openui.realityCheck.message": "You've been playing for {{minutes}} minutes. Take a moment before continuing.",
@@ -1414,17 +1403,27 @@ var openuiDefaults = {
   "openui.err.connection.title": "Connection lost",
   "openui.err.connection.message": "A stable connection is required. Reload to finish any open round."
 };
+var openuiSocialDefaults = {
+  "openui.bet": "Play",
+  "openui.balance": "Credits",
+  "openui.win": "Prize",
+  "openui.buyFeature.title": "Play bonus",
+  "openui.buyFeature.message": "Play this bonus now?"
+};
 function interpolate(template, vars) {
   if (!vars) return template;
   return template.replace(/\{\{(\w+)\}\}/g, (_m, k) => String(vars[k] ?? `{{${k}}}`));
 }
 var DictionaryTranslator = class {
-  constructor(messages, locale) {
+  constructor(messages, locale, socialMessages = {}) {
     this.messages = messages;
+    this.socialMessages = socialMessages;
     this._locale = locale;
   }
   messages;
+  socialMessages;
   _locale;
+  _social = false;
   subs = /* @__PURE__ */ new Set();
   get locale() {
     return this._locale;
@@ -1434,8 +1433,12 @@ var DictionaryTranslator = class {
     this._locale = next;
     for (const cb of [...this.subs]) cb(next);
   }
+  setSocial(on) {
+    this._social = on;
+  }
   t(key, vars) {
-    const resolved = this.messages[this._locale]?.[key] ?? openuiDefaults[key] ?? key;
+    const social = this._social ? this.socialMessages[this._locale]?.[key] ?? openuiSocialDefaults[key] : void 0;
+    const resolved = social ?? this.messages[this._locale]?.[key] ?? openuiDefaults[key] ?? key;
     return interpolate(resolved, vars);
   }
   onChange(cb) {
@@ -1445,8 +1448,8 @@ var DictionaryTranslator = class {
     };
   }
 };
-function dictionary(messages, locale) {
-  return new DictionaryTranslator(messages, locale);
+function dictionary(messages, locale, socialMessages) {
+  return new DictionaryTranslator(messages, locale, socialMessages);
 }
 
 // src/format/currency.ts
@@ -1552,9 +1555,6 @@ var OpenUI = class {
   settingsPanel;
   musicSlider;
   sfxSlider;
-  rulesButton;
-  infoPanel;
-  infoClose;
   turbo;
   autoplay;
   bonusButton;
@@ -1609,9 +1609,6 @@ var OpenUI = class {
     );
     this.musicSlider = new SliderControl({ id: "music", label: "Music", layout: { anchor: "center" }, initial: 0.7 }, this.bus);
     this.sfxSlider = new SliderControl({ id: "sfx", label: "Sound", layout: { anchor: "center" }, initial: 0.5 }, this.bus);
-    this.rulesButton = new ButtonControl({ id: "rules", label: "Rules", layout: { anchor: "center" } }, this.bus);
-    this.infoPanel = new PanelControl({ id: "info-panel", variant: "modal", title: "Game Info", layout: { anchor: "center" } }, this.bus);
-    this.infoClose = new ButtonControl({ id: "info-close", layout: { anchor: "top-right" } }, this.bus);
     this.bonusButton = new ButtonControl({ id: "bonus", layout: { anchor: "bottom-center", offset: [-400, -440] } }, this.bus);
     this.autoplay = new AutoplayControl(
       { id: "autoplay", layout: { anchor: "bottom-center", offset: [-225, -440] }, options: [5, 10, 25, 50, 100, Infinity] },
@@ -1635,9 +1632,6 @@ var OpenUI = class {
       this.settingsPanel,
       this.musicSlider,
       this.sfxSlider,
-      this.rulesButton,
-      this.infoPanel,
-      this.infoClose,
       this.bonusButton,
       this.autoplay,
       this.turbo,
@@ -1658,12 +1652,7 @@ var OpenUI = class {
     this.hidden.add("session-timer");
     this.bus.on("buttonActivated", ({ id }) => {
       if (id === "settings") this.settingsPanel.toggle();
-      else if (id === "rules") {
-        this.settingsPanel.closePanel();
-        this.infoPanel.openPanel();
-      } else if (id === "info-close") {
-        this.infoPanel.closePanel();
-      } else if (id === "bet-plus") {
+      else if (id === "bet-plus") {
         this.betStepper.inc();
       } else if (id === "bet-minus") {
         this.betStepper.dec();
@@ -1858,26 +1847,23 @@ var OpenUI = class {
   setLocale(next) {
     this.translator.setLocale(next);
   }
-  /** Translate a key (or pass plain text through) via the active translator. In
-   *  social mode, a `<key>.social` variant wins when one resolves — so gambling
-   *  wording (Bet/Buy feature) swaps to sweepstakes terms automatically. */
+  /** Translate a key (or pass plain text through) via the active translator. Social
+   *  wording is resolved by the translator from a SEPARATE social dictionary (see
+   *  `setSocial`), so gambling and social copy can never be mixed by accident. */
   t(key, vars) {
-    if (this.social.get()) {
-      const sk = `${key}.social`;
-      const s = this.translator.t(sk, vars);
-      if (s !== sk) return s;
-    }
     return this.translator.t(key, vars);
   }
   /**
-   * Turn social / sweepstakes mode on or off (one switch). Swaps gambling wording
-   * (Bet/Buy feature → social terms via `<key>.social` i18n) AND, when a `coin` is
-   * given (e.g. `'GC'`/`'SC'`/`'XGC'`), shows balance/bet/net in that coin. Wording
-   * re-renders live; the host can still override any `.social` key.
+   * Turn social / sweepstakes mode on or off (one switch). Flips the translator to
+   * its SEPARATE social dictionary (Bet→Play, Buy feature→Play bonus, etc.) and,
+   * when a `coin` is given (e.g. `'GC'`/`'SC'`), shows balance/bet/net in that coin.
+   * Wording re-renders live. Social copy lives in `locale.socialMessages` — kept
+   * apart from your normal `locale.messages` by design.
    */
   setSocial(on, coin) {
     if (on !== this.social.get()) {
       this.social.set(on);
+      this.translator.setSocial?.(on);
       this.locale.update(() => {
       });
     }
@@ -1892,7 +1878,7 @@ var OpenUI = class {
    *  just a hide — `confirmBuy`/autoplay entry points consult this). */
   isDisabled(feature) {
     const j = this.jurisdiction;
-    return feature === "autoplay" && !!j.disabledAutoplay || feature === "buyFeature" && !!j.disabledBuyFeature || feature === "turbo" && !!j.disabledTurbo || feature === "superTurbo" && !!j.disabledSuperTurbo || feature === "fullscreen" && !!j.disabledFullscreen || feature === "slamstop" && !!j.disabledSlamstop || feature === "spacebar" && !!j.disabledSpacebar;
+    return feature === "autoplay" && !!j.disabledAutoplay || feature === "buyFeature" && !!j.disabledBuyFeature || feature === "turbo" && !!j.disabledTurbo || feature === "fullscreen" && !!j.disabledFullscreen || feature === "slamstop" && !!j.disabledSlamstop || feature === "spacebar" && !!j.disabledSpacebar;
   }
   /**
    * Start a reality-check reminder (RTS 13). Every `everyMinutes` (WALL-CLOCK, so a
@@ -1936,7 +1922,7 @@ var OpenUI = class {
     this.showNotice(
       [
         { kind: "heading", id: "rc-title", text: this.t(opts.title ?? "openui.realityCheck.title", vars) },
-        { kind: "callout", id: "rc-body", tone: "info", text: this.t(opts.message ?? "openui.realityCheck.message", vars) }
+        { kind: "text", id: "rc-body", text: this.t(opts.message ?? "openui.realityCheck.message", vars) }
       ],
       opts.actions ?? [{ label: "openui.continue", variant: "primary" }]
     );
@@ -2025,7 +2011,7 @@ var ANALYTICS_EVENTS = [
 function createUI(spec = {}, hooks = {}) {
   const { issues } = validateSpec(spec);
   for (const issue of issues) hooks.onDataIssue?.(issue);
-  const translator = spec.locale ? new DictionaryTranslator(spec.locale.messages, spec.locale.locale) : void 0;
+  const translator = spec.locale ? new DictionaryTranslator(spec.locale.messages, spec.locale.locale, spec.locale.socialMessages) : void 0;
   const theme = resolveTheme(spec.theme, (i) => hooks.onDataIssue?.(i));
   const ui = new OpenUI({ theme, layout: spec.layout, translator, startMuted: spec.audio?.startMuted });
   if (spec.currency) {
@@ -2255,20 +2241,6 @@ function clampBet(amount, cfg, divisor = API_AMOUNT_DIVISOR) {
   return Math.min(max, Math.max(min, v));
 }
 
-// src/win.ts
-var DEFAULT_WIN_TIERS = Object.freeze([
-  { name: "big", minMultiplier: 10 },
-  { name: "mega", minMultiplier: 50 },
-  { name: "epic", minMultiplier: 100 }
-]);
-function winTier(win, stake, tiers = DEFAULT_WIN_TIERS) {
-  if (!Number.isFinite(win) || !Number.isFinite(stake) || stake <= 0 || win <= stake) return "none";
-  const mult = win / stake;
-  let name = "win";
-  for (const t of tiers) if (mult >= t.minMultiplier) name = t.name;
-  return name;
-}
-
-export { API_AMOUNT_DIVISOR, AutoplayControl, BLOCK_KINDS, ButtonControl, CURRENCY_TABLE, CardControl, Control, ControlRegistry, DEFAULT_MENU_TITLES, DEFAULT_NOTICE_ACTION, DEFAULT_WIN_TIERS, DictionaryTranslator, EventBus, EventLog, Fade, LOCALE_LABELS, OpenUI, PanelControl, Parallel, Pulse, RGS_ERROR_KEYS, ReadoutControl, SelectControl, Sequence, Signal, SliderControl, SpinControl, Squish, StepperControl, ToggleControl, TurboControl, Turn, ValueDisplay, applyJurisdiction, breakpointFor, buildBetLadder, buildBlocks, buildPanel, buttonBlocks, clampBet, clampDecimals, clampDigits, clampMinDigits, composeMenu, computeScreen, createUI, defaultHudSpec, defaultLayoutConfig, defaultTheme, defineUI, dictionary, displayDigits, effect, errorBlocks, extendTheme, formatAmount, installResponsive, integerDigits, isSafeColor, isSocialCurrency, openuiDefaults, resolveCurrency, resolvePlacement, resolveTheme, resolveTurboModes, safeAmount, sanitizeThemeOverrides, themePresets, validateSpec, valueFitMaxWidth, winTier };
+export { API_AMOUNT_DIVISOR, AutoplayControl, BLOCK_KINDS, ButtonControl, CURRENCY_TABLE, CardControl, Control, ControlRegistry, DEFAULT_MENU_TITLES, DEFAULT_NOTICE_ACTION, DictionaryTranslator, EventBus, EventLog, Fade, LOCALE_LABELS, OpenUI, PanelControl, Parallel, Pulse, RGS_ERROR_KEYS, ReadoutControl, SelectControl, Sequence, Signal, SliderControl, SpinControl, Squish, StepperControl, ToggleControl, TurboControl, Turn, ValueDisplay, applyJurisdiction, breakpointFor, buildBetLadder, buildBlocks, buildPanel, buttonBlocks, clampBet, clampDecimals, clampDigits, clampMinDigits, composeMenu, computeScreen, createUI, defaultHudSpec, defaultLayoutConfig, defaultTheme, defineUI, dictionary, displayDigits, effect, errorBlocks, extendTheme, formatAmount, installResponsive, integerDigits, isSafeColor, isSocialCurrency, openuiDefaults, openuiSocialDefaults, resolveCurrency, resolvePlacement, resolveTheme, resolveTurboModes, safeAmount, sanitizeThemeOverrides, themePresets, validateSpec, valueFitMaxWidth };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map