@energy8platform/platform-core 0.30.3 → 0.30.5

package/dist/game-spec.d.ts

@@ -91,6 +91,10 @@ interface ActionSpec {
     /** Shell display for buy/feature actions (SSOT). */
     title?: string;
     description?: string;
+    /** Transparent hero art for the top of the buy/feature card (no background plate). Forwarded
+     *  verbatim to `BonusOption.thumbnail` by `toBonusOptions` — the shell loads it as-is (pixi
+     *  `Assets.load`, html `<img src>`), so it's the same path/URL a static `thumbnail` would take. */
+    art?: string;
     /** Volatility rating (1–5 lightning bolts) shown on the buy/feature card in the shell's Buy bonus
      *  overlay. Forwarded to `BonusOption.volatility` by `toBonusOptions`. */
     volatility?: 1 | 2 | 3 | 4 | 5;

package/dist/slot-result.d.ts

@@ -1,6 +1,9 @@
 /** Minimal, renderer-agnostic base every normalized slot result satisfies. */
 interface SlotSpinResultBase {
-    /** Currency win amount for this play (PlatformSession.play() already applied the bet). */
+    /** Currency win for the round SO FAR — CUMULATIVE, not this segment's win (PlatformSession.play()
+     *  already applied the bet). In a bonus every drained segment must report the running total, so
+     *  the host derives each spin's WIN readout as `totalWin - prevSegmentTotal` and the final base
+     *  return shows the round total. Feed the RGS `total_win` (accumulated), never `spin_win`. */
     totalWin: number;
     freeSpins?: {
         awarded?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energy8platform/platform-core",
-  "version": "0.30.3",
+  "version": "0.30.5",
   "description": "Energy8 platform core: Lua engine, DevBridge, RTP simulation, and SDK session orchestration. Renderer-agnostic — pair with any game framework (Pixi, Phaser, Three.js, custom).",
   "type": "module",
   "main": "./dist/index.cjs.js",

package/src/game-spec/types.ts

@@ -23,6 +23,10 @@ export interface ActionSpec {
   /** Shell display for buy/feature actions (SSOT). */
   title?: string;
   description?: string;
+  /** Transparent hero art for the top of the buy/feature card (no background plate). Forwarded
+   *  verbatim to `BonusOption.thumbnail` by `toBonusOptions` — the shell loads it as-is (pixi
+   *  `Assets.load`, html `<img src>`), so it's the same path/URL a static `thumbnail` would take. */
+  art?: string;
   /** Volatility rating (1–5 lightning bolts) shown on the buy/feature card in the shell's Buy bonus
    *  overlay. Forwarded to `BonusOption.volatility` by `toBonusOptions`. */
   volatility?: 1 | 2 | 3 | 4 | 5;

package/src/slot-result/types.ts

@@ -1,6 +1,9 @@
 /** Minimal, renderer-agnostic base every normalized slot result satisfies. */
 export interface SlotSpinResultBase {
-  /** Currency win amount for this play (PlatformSession.play() already applied the bet). */
+  /** Currency win for the round SO FAR — CUMULATIVE, not this segment's win (PlatformSession.play()
+   *  already applied the bet). In a bonus every drained segment must report the running total, so
+   *  the host derives each spin's WIN readout as `totalWin - prevSegmentTotal` and the final base
+   *  return shows the round total. Feed the RGS `total_win` (accumulated), never `spin_win`. */
   totalWin: number;
   freeSpins?: { awarded?: number; total?: number; remaining?: number };
   // ── Round-continuation metadata (Stake segment-drain) ──────────────────