@open-slot-ui/core 0.5.1 → 0.6.1

package/dist/index.d.cts

@@ -1255,6 +1255,11 @@ declare class OpenUI {
     };
     /** Minimum round duration (ms) from jurisdiction — stored for the GAME to enforce. */
     minimumRoundDuration: number;
+    /** Buy-feature confirm threshold, as a multiple of the base bet. A play (buy or
+     *  bet-mode activation) that costs STRICTLY MORE than this must show a confirm step
+     *  — Stake requires that bet modes above 2× never activate on a single click. `0`
+     *  (the default) = off. Set via `spec.buyFeature.confirmAboveCost` or a jurisdiction. */
+    confirmBuyAboveCost: number;
     private sessionNet;
     private prevVolumes;
     /** The frozen UISpec `createUI` built this from, if any — authored = run = tested. */
@@ -1363,6 +1368,10 @@ declare class OpenUI {
     /** 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' | 'fullscreen' | 'slamstop' | 'spacebar'): boolean;
+    /** True when a buy / bet-mode activation of `cost`× the base bet must be confirmed
+     *  before it commits (Stake: no one-click activation above `confirmBuyAboveCost`×).
+     *  Always false when the threshold is 0/unset or `cost` isn't a finite number. */
+    shouldConfirmBuy(cost: number): 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,
@@ -1403,6 +1412,11 @@ interface JurisdictionConfig {
     displaySessionTimer?: boolean;
     /** Minimum ms a round must take — stored on the HUD for the GAME to enforce. */
     minimumRoundDuration?: number;
+    /** Buy-feature confirm threshold (× base bet). A play costing more than this must
+     *  be confirmed before it commits — Stake requires that bet modes above 2× never
+     *  activate on a single click, so a Stake preset sets this to `2`. Not part of the
+     *  wallet schema; a convenience so a jurisdiction can require the confirm step. */
+    confirmBuyAboveCost?: number;
 }
 /**
  * Apply a Stake Engine `jurisdiction` config to a live HUD — the whole switchboard
@@ -1679,6 +1693,15 @@ interface UISpec {
         name?: string;
         version?: string;
     };
+    /** Buy-feature / bet-mode confirmation. `confirmAboveCost` (× base bet) makes any
+     *  play costing MORE than that require a confirm step before it commits — Stake
+     *  requires bet modes above 2× to never activate on a single click, so set `2`.
+     *  The game routes a purchase/activation through `hud.requestBuyFeature(...)`, which
+     *  shows the confirm popup itself when the cost exceeds the threshold. A jurisdiction
+     *  can set the same threshold (`JurisdictionConfig.confirmBuyAboveCost`). */
+    buyFeature?: {
+        confirmAboveCost?: number;
+    };
     /** Reality-check reminder (RTS 13): open-ui runs a wall-clock timer, emits a
      *  `realityCheck` event, stops autoplay, and (unless `showModal:false`) shows an
      *  acknowledge modal. You supply only the cadence + text. `title`/`message` are
@@ -1895,8 +1918,9 @@ interface CurrencyInfo {
 /**
  * The Stake Engine supported-currency matrix (symbol · decimals · placement), 1:1 with
  * the platform's `CurrencyMeta`. Symbol placement: prefix by default, SUFFIX for the
- * few that render after the amount (DKK/PLN/VND/CLP/ARS/PEN). Crypto is included for
- * completeness (8-dp with a symbol) so high-precision balances also format right.
+ * few that render after the amount (DKK/NOK/PLN/VND/CLP/ARS/PEN). Decimals follow the
+ * ISO minor units — 0 for JPY/KRW/IDR/VND/CLP, 3 for the KWD/JOD/BHD dinars (1000 fils),
+ * 2 otherwise. Crypto is included (8-dp) so high-precision balances also format right.
  */
 declare const CURRENCY_TABLE: Readonly<Record<string, CurrencyInfo>>;
 /** True if `code` is a Stake social/sweepstakes coin (displayed "GC"/"SC"). */

package/dist/index.d.ts

@@ -1255,6 +1255,11 @@ declare class OpenUI {
     };
     /** Minimum round duration (ms) from jurisdiction — stored for the GAME to enforce. */
     minimumRoundDuration: number;
+    /** Buy-feature confirm threshold, as a multiple of the base bet. A play (buy or
+     *  bet-mode activation) that costs STRICTLY MORE than this must show a confirm step
+     *  — Stake requires that bet modes above 2× never activate on a single click. `0`
+     *  (the default) = off. Set via `spec.buyFeature.confirmAboveCost` or a jurisdiction. */
+    confirmBuyAboveCost: number;
     private sessionNet;
     private prevVolumes;
     /** The frozen UISpec `createUI` built this from, if any — authored = run = tested. */
@@ -1363,6 +1368,10 @@ declare class OpenUI {
     /** 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' | 'fullscreen' | 'slamstop' | 'spacebar'): boolean;
+    /** True when a buy / bet-mode activation of `cost`× the base bet must be confirmed
+     *  before it commits (Stake: no one-click activation above `confirmBuyAboveCost`×).
+     *  Always false when the threshold is 0/unset or `cost` isn't a finite number. */
+    shouldConfirmBuy(cost: number): 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,
@@ -1403,6 +1412,11 @@ interface JurisdictionConfig {
     displaySessionTimer?: boolean;
     /** Minimum ms a round must take — stored on the HUD for the GAME to enforce. */
     minimumRoundDuration?: number;
+    /** Buy-feature confirm threshold (× base bet). A play costing more than this must
+     *  be confirmed before it commits — Stake requires that bet modes above 2× never
+     *  activate on a single click, so a Stake preset sets this to `2`. Not part of the
+     *  wallet schema; a convenience so a jurisdiction can require the confirm step. */
+    confirmBuyAboveCost?: number;
 }
 /**
  * Apply a Stake Engine `jurisdiction` config to a live HUD — the whole switchboard
@@ -1679,6 +1693,15 @@ interface UISpec {
         name?: string;
         version?: string;
     };
+    /** Buy-feature / bet-mode confirmation. `confirmAboveCost` (× base bet) makes any
+     *  play costing MORE than that require a confirm step before it commits — Stake
+     *  requires bet modes above 2× to never activate on a single click, so set `2`.
+     *  The game routes a purchase/activation through `hud.requestBuyFeature(...)`, which
+     *  shows the confirm popup itself when the cost exceeds the threshold. A jurisdiction
+     *  can set the same threshold (`JurisdictionConfig.confirmBuyAboveCost`). */
+    buyFeature?: {
+        confirmAboveCost?: number;
+    };
     /** Reality-check reminder (RTS 13): open-ui runs a wall-clock timer, emits a
      *  `realityCheck` event, stops autoplay, and (unless `showModal:false`) shows an
      *  acknowledge modal. You supply only the cadence + text. `title`/`message` are
@@ -1895,8 +1918,9 @@ interface CurrencyInfo {
 /**
  * The Stake Engine supported-currency matrix (symbol · decimals · placement), 1:1 with
  * the platform's `CurrencyMeta`. Symbol placement: prefix by default, SUFFIX for the
- * few that render after the amount (DKK/PLN/VND/CLP/ARS/PEN). Crypto is included for
- * completeness (8-dp with a symbol) so high-precision balances also format right.
+ * few that render after the amount (DKK/NOK/PLN/VND/CLP/ARS/PEN). Decimals follow the
+ * ISO minor units — 0 for JPY/KRW/IDR/VND/CLP, 3 for the KWD/JOD/BHD dinars (1000 fils),
+ * 2 otherwise. Crypto is included (8-dp) so high-precision balances also format right.
  */
 declare const CURRENCY_TABLE: Readonly<Record<string, CurrencyInfo>>;
 /** True if `code` is a Stake social/sweepstakes coin (displayed "GC"/"SC"). */

package/dist/index.js

@@ -1247,6 +1247,9 @@ function validateSpec(spec) {
     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");
     }
+    if (spec.buyFeature?.confirmAboveCost != null && !(typeof spec.buyFeature.confirmAboveCost === "number" && Number.isFinite(spec.buyFeature.confirmAboveCost) && spec.buyFeature.confirmAboveCost >= 0)) {
+      add("error", "buyFeature.confirmAboveCost", "bad-threshold", "buyFeature.confirmAboveCost must be a finite number >= 0");
+    }
     if (spec.controls) {
       for (const [id, ov] of Object.entries(spec.controls)) {
         checkLayout(ov.layout?.anchor, `controls.${id}.layout.anchor`);
@@ -1399,6 +1402,9 @@ function applyJurisdiction(ui, jur) {
   if (typeof jur.minimumRoundDuration === "number" && Number.isFinite(jur.minimumRoundDuration)) {
     ui.minimumRoundDuration = Math.max(0, jur.minimumRoundDuration);
   }
+  if (typeof jur.confirmBuyAboveCost === "number" && Number.isFinite(jur.confirmBuyAboveCost)) {
+    ui.confirmBuyAboveCost = Math.max(0, jur.confirmBuyAboveCost);
+  }
 }
 
 // src/notice.ts
@@ -1456,6 +1462,8 @@ var openuiDefaults = {
   "openui.replay": "Replay",
   "openui.buyFeature.title": "Buy feature",
   "openui.buyFeature.message": "Buy this feature now?",
+  // Confirm step for a higher-cost play — {{name}} / {{price}} are interpolated.
+  "openui.buyFeature.confirm": "Buy {{name}} for {{price}}?",
   "openui.freeSpins": "FS",
   // reality check (RTS 13) — {{minutes}} is interpolated by open-ui's scheduler
   "openui.realityCheck.title": "Reality check",
@@ -1491,6 +1499,7 @@ var openuiSocialDefaults = {
   "openui.err.insufficient.title": "Insufficient balance",
   "openui.buyFeature.title": "Play bonus",
   "openui.buyFeature.message": "Play this bonus now?",
+  "openui.buyFeature.confirm": "Play {{name}} for {{price}}?",
   "openui.err.insufficient.message": "You don't have enough balance for this play.",
   "openui.err.limit.message": "A play limit has been reached. Please try again later."
 };
@@ -1553,8 +1562,18 @@ var CURRENCY_TABLE = Object.freeze({
   MXN: { symbol: "MX$", decimals: 2 },
   TRY: { symbol: "\u20BA", decimals: 2 },
   GBP: { symbol: "\xA3", decimals: 2 },
+  NGN: { symbol: "\u20A6", decimals: 2 },
+  TWD: { symbol: "NT$", decimals: 2 },
+  SGD: { symbol: "SG$", decimals: 2 },
+  MYR: { symbol: "RM", decimals: 2 },
+  CRC: { symbol: "\u20A1", decimals: 2 },
+  // three-decimal dinars (1 unit = 1000 fils) — the >2-decimal path must format these
+  KWD: { symbol: "KD", decimals: 3 },
+  JOD: { symbol: "JD", decimals: 3 },
+  BHD: { symbol: "BD", decimals: 3 },
   // ── fiat — symbol AFTER the amount ───────────────────────────────────────────
   DKK: { symbol: "kr", decimals: 2, symbolAfter: true },
+  NOK: { symbol: "kr", decimals: 2, symbolAfter: true },
   PLN: { symbol: "z\u0142", decimals: 2, symbolAfter: true },
   VND: { symbol: "\u20AB", decimals: 0, symbolAfter: true },
   CLP: { symbol: "CLP", decimals: 0, symbolAfter: true },
@@ -1671,6 +1690,11 @@ var OpenUI = class {
   gameInfo = {};
   /** Minimum round duration (ms) from jurisdiction — stored for the GAME to enforce. */
   minimumRoundDuration = 0;
+  /** Buy-feature confirm threshold, as a multiple of the base bet. A play (buy or
+   *  bet-mode activation) that costs STRICTLY MORE than this must show a confirm step
+   *  — Stake requires that bet modes above 2× never activate on a single click. `0`
+   *  (the default) = off. Set via `spec.buyFeature.confirmAboveCost` or a jurisdiction. */
+  confirmBuyAboveCost = 0;
   sessionNet = 0;
   prevVolumes = null;
   /** The frozen UISpec `createUI` built this from, if any — authored = run = tested. */
@@ -2020,6 +2044,13 @@ var OpenUI = class {
     const j = this.jurisdiction;
     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;
   }
+  /** True when a buy / bet-mode activation of `cost`× the base bet must be confirmed
+   *  before it commits (Stake: no one-click activation above `confirmBuyAboveCost`×).
+   *  Always false when the threshold is 0/unset or `cost` isn't a finite number. */
+  shouldConfirmBuy(cost) {
+    const t = this.confirmBuyAboveCost;
+    return t > 0 && Number.isFinite(cost) && cost > t;
+  }
   /**
    * 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,
@@ -2353,6 +2384,9 @@ function createUI(spec = {}, hooks = {}) {
       }
     }
   }
+  if (spec.buyFeature?.confirmAboveCost != null && Number.isFinite(spec.buyFeature.confirmAboveCost)) {
+    ui.confirmBuyAboveCost = Math.max(0, spec.buyFeature.confirmAboveCost);
+  }
   if (spec.jurisdiction) ui.applyJurisdiction(spec.jurisdiction);
   const portraitControls = {};
   for (const [id, layout] of Object.entries(portraitDefaultLayouts)) {