@energy8platform/create-slot 0.2.0

package/README.md

@@ -0,0 +1,48 @@
+# @energy8platform/create-slot
+
+Scaffolder for a new PixiJS slot game on the Energy8 `@energy8platform/game-engine` framework,
+ready to run locally, test in the Stake dev harness, generate its math, and build for Stake Engine.
+
+```bash
+npm create @energy8platform/slot@latest my-game
+# or
+npx @energy8platform/create-slot my-game
+```
+
+It asks a few questions (id, title, mechanic, grid, …) and writes a complete, type-checking project.
+
+## What it generates
+
+| File | Role |
+|---|---|
+| `src/game.spec.ts` | **Single source of truth.** `defineGame(spec)` derives the Lua game definition, the `modeMap`, the math modes, the paytable, the shell's buy-bonus cards AND the Game Info per-mode table. Edit modes / symbols / bet levels / `rtp` / `maxWin` here. |
+| `src/scenes/GameScene.ts` | The render-only scene: `present(result, ctx)` + optional `onBonusEnter`/`onBonusExit`. The host owns the play loop; the scene never calls play/ack. |
+| `src/scenes/IntroScene.ts` | Tap-to-start splash (skipped on replay). |
+| `src/game/script.logic.lua` | The game's math logic (returns a bet-multiplier `total_win`). |
+| `src/game/normalize.ts` + `schema.ts` | Map the raw play result → the scene's typed `SpinData`. |
+| `src/stake/adapter.ts` | The Stake book adapter (`createGameAdapter`) — slices a round-book into segments. |
+| `math.config.ts` | Per-mode sim + curate tuning for the math pipeline (independent of the spec's declared rtp/maxWin). |
+| `CLAUDE.md` | Guidance for Claude Code on how the project is wired and what the framework already handles. |
+| `vite.config.ts` | Dev (DevBridge), the Stake harness, and the `build:stake` frontend target. |
+
+## Workflow
+
+```bash
+npm install
+npm run dev          # local dev via Energy8 DevBridge (config + Lua)
+npm run stake        # Stake dev harness: iframe wrapper + dev-RGS backed by curated books
+npm run math:pool    # Stage A — honest large simulation (the pool)
+npm run math:curate  # Stage B — compress into the publishable stake-math/ bundle
+npm run build:stake  # the Stake frontend build → dist-stake/
+```
+
+The framework handles the Stake integration end-to-end (RGS bridge, shell, play loop, bonus
+segment-drain, resume, autoplay, social mode, jurisdiction, money formatting, the math pipeline).
+You write the spec, the Lua math, and the rendering — see the generated `CLAUDE.md` for the full map.
+
+## Related packages
+
+- `@energy8platform/game-engine` — the PixiJS engine + host the game runs on.
+- `@energy8platform/platform-core` — renderer-agnostic platform (Lua engine, shell, SDK session).
+- `@energy8platform/stake-kit` — the Stake book adapter + dev harness used by the scaffold.
+- `@energy8platform/stake-math-tools` — the `e8-math` simulation + curation pipeline.

package/dist/cli.js

@@ -0,0 +1,784 @@
+#!/usr/bin/env node
+import { stdout, stdin, exit, argv } from 'node:process';
+import { resolve, join } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { mkdirSync, cpSync, existsSync, renameSync, writeFileSync, rmSync, readdirSync, statSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+const DEFAULT_GRID = {
+    lines: { cols: 5, rows: 3 },
+    ways: { cols: 5, rows: 3 },
+    cluster: { cols: 7, rows: 7 },
+    anywhere: { cols: 5, rows: 4 },
+    custom: { cols: 6, rows: 6 },
+};
+function titleCase(id) {
+    return id.split(/[-_]/).filter(Boolean).map((w) => w[0].toUpperCase() + w.slice(1)).join(' ');
+}
+function parseFlags(argv) {
+    // normalize --flag=value → --flag value
+    const args = [];
+    for (const tok of argv) {
+        if (tok.startsWith('--') && tok.includes('=')) {
+            const i = tok.indexOf('=');
+            args.push(tok.slice(0, i), tok.slice(i + 1));
+        }
+        else {
+            args.push(tok);
+        }
+    }
+    const out = {};
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--id')
+            out.id = args[++i];
+        else if (a === '--title')
+            out.title = args[++i];
+        else if (a === '--mechanic')
+            out.mechanic = args[++i];
+        else if (a === '--grid') {
+            const [c, r] = args[++i].split('x').map(Number);
+            out.grid = { cols: c, rows: r };
+        }
+        else if (a === '--cascades')
+            out.cascades = true;
+        else if (a === '--no-cascades')
+            out.cascades = false;
+        else if (a === '--stake')
+            out.stake = true;
+        else if (a === '--no-stake')
+            out.stake = false;
+    }
+    return out;
+}
+function applyDefaults(partial) {
+    const mechanic = partial.mechanic ?? 'cluster';
+    return {
+        id: partial.id ?? '',
+        title: partial.title ?? titleCase(partial.id ?? ''),
+        mechanic,
+        grid: partial.grid ?? DEFAULT_GRID[mechanic],
+        stake: partial.stake ?? true,
+        cascades: partial.cascades ?? (mechanic !== 'lines'),
+    };
+}
+function validate(a) {
+    if (!/^[a-z][a-z0-9-]*$/.test(a.id))
+        throw new Error(`invalid id (must be kebab-case): "${a.id}"`);
+    if (!['lines', 'ways', 'cluster', 'anywhere', 'custom'].includes(a.mechanic))
+        throw new Error(`invalid mechanic: "${a.mechanic}"`);
+    if (a.grid.cols <= 0 || a.grid.rows <= 0)
+        throw new Error('grid dimensions must be > 0');
+}
+/** Flags that consume the next token as their value — used to skip those tokens during positional scan. */
+const VALUE_FLAGS = new Set(['--id', '--title', '--mechanic', '--grid']);
+/**
+ * Build an answers seed from argv: flags, plus a lone positional used as
+ * the id when --id is absent. Correctly skips tokens that are values of
+ * known value-taking flags (e.g. `--mechanic cluster` — `cluster` is NOT
+ * treated as a positional even when no --id is supplied).
+ */
+function seedFromArgv(argv) {
+    // Normalize --flag=value to ['--flag', 'value'] for uniform processing
+    const args = [];
+    for (const tok of argv) {
+        if (tok.startsWith('--') && tok.includes('=')) {
+            const i = tok.indexOf('=');
+            args.push(tok.slice(0, i), tok.slice(i + 1));
+        }
+        else {
+            args.push(tok);
+        }
+    }
+    // Collect indices that are consumed as flag values so we don't
+    // accidentally treat them as positionals.
+    const valueIndices = new Set();
+    for (let i = 0; i < args.length; i++) {
+        if (VALUE_FLAGS.has(args[i]) && i + 1 < args.length) {
+            valueIndices.add(i + 1);
+        }
+    }
+    const flags = parseFlags(argv);
+    if (!flags.id) {
+        const positional = args.find((a, idx) => !a.startsWith('--') && !valueIndices.has(idx));
+        if (positional)
+            flags.id = positional;
+    }
+    return flags;
+}
+
+/** Ask the 5 questions interactively, applying defaults for blank answers. */
+async function prompt(seed) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        const id = seed.id ?? (await rl.question('Game id (kebab-case): ')).trim();
+        const titleInput = (await rl.question(`Title [${applyDefaults({ id }).title}]: `)).trim();
+        const title = seed.title ?? (titleInput || undefined);
+        const mechanic = (seed.mechanic ?? ((await rl.question('Mechanic (lines|ways|cluster|anywhere|custom) [cluster]: ')).trim() || 'cluster'));
+        const gridStr = (await rl.question('Grid colsxrows [default for mechanic]: ')).trim();
+        const grid = seed.grid ?? (gridStr ? { cols: Number(gridStr.split('x')[0]), rows: Number(gridStr.split('x')[1]) } : undefined);
+        const stakeAns = seed.stake ?? ((await rl.question('Stake integration? (Y/n): ')).trim().toLowerCase() !== 'n');
+        return applyDefaults({ id, title, mechanic, grid, stake: stakeAns });
+    }
+    finally {
+        rl.close();
+    }
+}
+
+/** Emit a game.spec.ts with a sensible default symbol set + actions; author edits it. */
+function genGameSpec(a) {
+    return `import { defineGame, type GameSpec } from '@energy8platform/platform-core/game-spec';
+
+// Single source of truth. Edit symbols / paytable / bet levels / actions to design your game.
+export const spec: GameSpec = {
+  id: '${a.id}',
+  type: 'slot',
+  mechanic: '${a.mechanic}',
+  grid: { cols: ${a.grid.cols}, rows: ${a.grid.rows} },
+  betLevels: [0.01, 0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, 100, 200, 500, 1000, 10000, 100000, 1000000],
+  defaultBet: 1,
+  maxWin: 5000,
+  currency: 'EUR',
+  symbols: [
+    { id: 'H1', name: 'High 1', kind: 'high', pay: { 3: 10, 4: 25, 5: 100 } },
+    { id: 'H2', name: 'High 2', kind: 'high', pay: { 3: 8, 4: 20, 5: 80 } },
+    { id: 'H3', name: 'High 3', kind: 'high', pay: { 3: 6, 4: 15, 5: 60 } },
+    { id: 'H4', name: 'High 4', kind: 'high', pay: { 3: 5, 4: 12, 5: 50 } },
+    { id: 'L1', name: 'Low 1', kind: 'low', pay: { 3: 1, 4: 2, 5: 5 } },
+    { id: 'L2', name: 'Low 2', kind: 'low', pay: { 3: 0.8, 4: 1.5, 5: 4 } },
+    { id: 'L3', name: 'Low 3', kind: 'low', pay: { 3: 0.6, 4: 1.2, 5: 3 } },
+    { id: 'L4', name: 'Low 4', kind: 'low', pay: { 3: 0.5, 4: 1, 5: 2.5 } },
+    { id: 'WILD', name: 'Wild', kind: 'wild' },
+    { id: 'SCATTER', name: 'Scatter', kind: 'scatter' },
+  ],
+  // All player-facing spec copy is socialized automatically in social mode — symbol names shown
+  // in the paytable AND the action title/description below (e.g. 'BUY BONUS' -> 'GET BONUS',
+  // 'Pay more...' -> 'Win more...'). Write normal casino wording here; it stays compliant in social.
+  //
+  // Modes are declared ONCE here. \`rtp\` (target RTP, 0..1) and \`maxWin\` (per-mode cap; defaults to
+  // the game-level maxWin) feed the Game Info per-mode table automatically. NOTE: these are the
+  // DECLARED/displayed values — the math pipeline's targets live in math.config.ts and may differ
+  // (e.g. while tuning). Keep the declared values honest against the published math.
+  actions: {
+    spin: { role: 'base', rtp: 0.96 },
+    ante: { role: 'feature', cost: 1.5, rtp: 0.96, title: 'ANTE BET', description: 'Pay more for a boosted chance' },
+    free_spin: { role: 'free' },
+    buy_bonus: { role: 'buy', cost: 100, rtp: 0.96, maxWin: 5000, title: 'BUY BONUS', description: 'Buy the feature', feature: { spins: 10 } },
+  },
+};
+
+export const model = defineGame(spec);
+`;
+}
+
+/** Generate CLAUDE.md for a scaffolded game — guidance for Claude Code (and humans) on how the
+ *  project is wired, what to edit, and what the framework already handles. */
+function genClaudeMd(a) {
+    const cascade = a.cascades === true;
+    return `# CLAUDE.md
+
+Guidance for Claude Code (claude.ai/code) working in this repository — a slot game built on the
+Energy8 \`@energy8platform/game-engine\` framework, targeting Stake Engine.
+
+## What this project is
+
+\`${a.id}\` — a PixiJS slot game. The framework (\`@energy8platform/*\`) owns the boot sequence, the
+Stake RGS bridge, the shell (control bar / modals / Game Info), the play loop, and the math
+pipeline. This repo contains only the GAME: its spec, math logic, rendering, and assets.
+
+## Single source of truth: \`src/game.spec.ts\`
+
+\`defineGame(spec)\` derives everything from one file: the Lua \`GameDefinition\`, the \`modeMap\`
+(action → Stake mode), the math modes, the paytable, AND the shell's buy-bonus cards + Game Info
+per-mode table. **Edit modes/symbols/bet levels/RTP/maxWin there — never duplicate them elsewhere.**
+Each \`actions[key]\` carries \`role\` (base/feature/buy/free), \`cost\`, \`rtp\`, \`maxWin\`, \`title\`,
+\`description\`, \`feature\`. \`rtp\`/\`maxWin\` are the DECLARED (displayed) values; the math pipeline's
+TARGETS live in \`math.config.ts\` and may legitimately differ while tuning.
+
+## The scene contract (\`src/scenes/GameScene.ts\`)
+
+The host owns the entire play loop (play → present → ack → drain). The scene only RENDERS:
+- \`present(result, ctx)\` — draw ONE segment (a spin, or one free spin). All pacing lives here.
+- \`onBonusEnter(trigger, ctx)\` / \`onBonusExit(last, ctx)\` — optional bonus intro / summary.
+
+\`ctx\` = \`{ bet, action, mode, formatAmount(v), turbo }\`. The scene NEVER calls play/ack/roundId,
+never touches the balance/win readouts (the host does, post-present), and never runs the FS loop —
+a bonus is one round the host drains segment-by-segment.${cascade ? '\n\nThis game uses a CASCADE mechanic: `present` runs `result.steps` through the CascadeController and reflects `result.multiplier`.' : ''}
+
+## Commands
+
+\`\`\`bash
+npm run dev            # local dev via Energy8 DevBridge (config + Lua)
+npm run stake          # the Stake dev harness — iframe wrapper + dev-RGS backed by curated books
+npm run build:stake    # the Stake frontend build → dist-stake/ (base './', no DevBridge)
+npm run math:pool      # Stage A — honest large simulation (the pool); see math.config.ts
+npm run math:curate    # Stage B — compress the pool into the publishable stake-math/ bundle
+\`\`\`
+
+## Math pipeline
+
+\`math.config.ts\` declares per-mode sim + curate tuning (iterations, CV, hit-rate, nRowsOut,
+tolerances). The pipeline (\`e8-math\`) runs the native Go simulator, builds a pool, then curates a
+~Stake-canonical book bundle (\`stake-math/\`: \`books_<MODE>.jsonl.zst\` + \`lookUpTable_<MODE>_0.csv\`
++ \`index.json\`). Book events are canonical \`{ type, spin }\`. The harness replays from these books.
+
+## What the framework already handles — do NOT reimplement
+
+Segment-drain of bonuses, \`roundId\` forwarding, free-spins counter (with retriggers), resume of an
+unfinished round, win/balance HUD timing, social-mode vocabulary, the legal disclaimer, currency
+formatting, jurisdiction → feature restrictions, the insufficient-funds guard, the play-error modal
++ reconnect overlay, autoplay, the bet ladder + default bet from \`/wallet/authenticate\`, the
+open-redirect \`rgs_url\` guard, and spacebar handling. Write player-facing copy normally — it is
+socialized automatically in social mode.
+
+## Conventions
+
+- Keep \`game.spec.ts\` the source of truth; regenerate / reason from it.
+- The math TARGETS (math.config.ts) and the DECLARED rtp/maxWin (game.spec) are separate — keep the
+  declared values honest against the published math before submitting.
+- Tests: \`npm test\` (vitest). Typecheck: \`npx tsc --noEmit\`.
+`;
+}
+
+function genPackageJson(a, v) {
+    const scripts = {
+        dev: 'vite',
+        build: 'tsc --noEmit && vite build',
+        postbuild: `rm -f ${a.id}.zip && cd dist && zip -r ../${a.id}.zip .`,
+        typecheck: 'tsc --noEmit',
+        smoke: 'tsx smoke.ts',
+        sim: 'e8-math sim --config ./math.config.ts',
+        pool: 'e8-math pool --config ./math.config.ts',
+        curate: 'e8-math curate --config ./math.config.ts',
+        math: 'e8-math all --config ./math.config.ts',
+    };
+    if (a.stake) {
+        scripts['dev:stake'] = 'BUILD_TARGET=stake vite';
+        scripts['build:stake'] = 'BUILD_TARGET=stake vite build';
+        scripts['stake'] = 'BUILD_TARGET=stake-harness vite';
+        scripts['stake:bundle'] =
+            `rm -rf dist-stake stake-math ${a.id}-stake.zip stake-math.zip && npm run build:stake && npm run math && cd dist-stake && zip -r ../${a.id}-stake.zip . && cd ../stake-math && zip -r ../stake-math.zip . && cd .. && echo 'Stake artifacts: ${a.id}-stake.zip + stake-math.zip'`;
+    }
+    const pkg = {
+        name: a.id,
+        private: true,
+        type: 'module',
+        scripts,
+        dependencies: {
+            '@energy8platform/platform-core': v['platform-core'],
+            '@energy8platform/game-engine': v['game-engine'],
+            ...(a.stake ? { '@energy8platform/stake-kit': v['stake-kit'], '@energy8platform/stake-bridge': v['stake-bridge'] } : { '@energy8platform/stake-kit': v['stake-kit'] }),
+            'pixi.js': '^8.16.0',
+            zod: '^3.23.0',
+        },
+        devDependencies: {
+            '@energy8platform/stake-math-tools': v['stake-math-tools'],
+            '@types/node': '^20.0.0',
+            tsx: '^4.21.0',
+            typescript: '^5.6.0',
+            vite: '^6.0.0',
+        },
+    };
+    return JSON.stringify(pkg, null, 2) + '\n';
+}
+
+function genGameScene(a) {
+    const cascade = a.cascades === true;
+    const ctrl = cascade ? 'CascadeController' : 'ReelSpinController';
+    const present = cascade
+        ? `  /** Render one normalized result. Tune MultiplierAccumulator policy/reset() to your mechanic. */
+  async present(result: SpinData, ctx: RenderContext): Promise<void> {
+    const turbo = ctx.turbo > 0;
+    if (typeof result.multiplier === 'number') this.multiplier.set(result.multiplier);
+    for (const step of result.steps) await this.controller.run(step, { turbo });
+    if (result.totalWin > 0) await this.overlay.show(result.totalWin, ctx.bet, ctx.formatAmount);
+  }`
+        : `  /** Render one normalized result (one spin, or one free spin of a bonus). */
+  async present(result: SpinData, ctx: RenderContext): Promise<void> {
+    const turbo = ctx.turbo > 0;
+    await this.controller.run({ targetGrid: result.targetGrid }, { turbo });
+    if (result.totalWin > 0) await this.overlay.show(result.totalWin, ctx.bet, ctx.formatAmount);
+  }`;
+    const multiplierImport = cascade ? ', MultiplierAccumulator' : '';
+    const multiplierField = cascade
+        ? `  private readonly multiplier = new MultiplierAccumulator({ policy: 'session' });\n` : '';
+    return `import { Scene } from '@energy8platform/game-engine/core';
+import { ReelGrid, ${ctrl}, BigWinOverlay${multiplierImport} } from '@energy8platform/game-engine/slot';
+import type { SlotSceneController, RenderContext } from '@energy8platform/game-engine/host';
+import { model } from '../game.spec';
+import { resolveSymbol } from '../slot/symbols';
+import type { SpinData } from '../game/normalize';
+
+/**
+ * The host owns the play loop (play -> present -> ack -> drain). This scene only RENDERS:
+ *  - present(result, ctx): draw ONE segment (a spin, or one free spin). Put all pacing here.
+ *  - onBonusEnter(trigger, ctx): fires right before the first free spin (bonus intro).
+ *  - onBonusExit(last, ctx): fires after the last free spin (bonus summary).
+ * ctx gives you { bet, action, mode, formatAmount(value), turbo } — turbo is live (0..3).
+ */
+export class GameScene extends Scene implements SlotSceneController<SpinData> {
+  private grid!: ReelGrid;
+  private controller!: ${ctrl};
+  private overlay!: BigWinOverlay;
+${multiplierField}
+  private _vw = 1920;
+  private _vh = 1080;
+
+  async onEnter(): Promise<void> {
+    const { cols, rows } = model.spec.grid;
+    this.grid = new ReelGrid({ cols, rows, cellSize: 110, gap: 6, resolve: resolveSymbol });
+    this.container.addChild(this.grid);
+    this.controller = new ${ctrl}(this.grid);
+    this.overlay = new BigWinOverlay({
+      tiers: [
+        { id: 'big', minMultiplier: 10, title: 'BIG WIN', accentColor: 0xffd24a },
+        { id: 'mega', minMultiplier: 50, title: 'MEGA WIN', accentColor: 0x7ad7ff },
+      ],
+      formatMoney: (v) => v.toFixed(2),
+      width: 1920, height: 1080,
+    });
+    this.container.addChild(this.overlay);
+    this.layout(this._vw, this._vh);
+  }
+
+${present}
+
+  /** Bonus starting — show an intro. trigger.freeSpins?.total = how many free spins were awarded. */
+  async onBonusEnter(trigger: SpinData, _ctx: RenderContext): Promise<void> {
+    // TODO: show a bonus intro (e.g. "10 FREE SPINS"). Defaults to nothing.
+    void trigger;
+  }
+
+  /** Bonus finished — show a summary. ctx.formatAmount(last.totalWin) = the bonus total win. */
+  async onBonusExit(last: SpinData, ctx: RenderContext): Promise<void> {
+    // TODO: show a bonus summary. Defaults to nothing.
+    void last; void ctx;
+  }
+
+  onResize(width: number, height: number): void {
+    this._vw = width;
+    this._vh = height;
+    this.layout(width, height);
+  }
+
+  private layout(w: number, h: number): void {
+    this._vw = w; this._vh = h;
+    if (!this.grid) return;
+    const cols = model.spec.grid.cols, rows = model.spec.grid.rows;
+    const cellSize = 110, gap = 6;            // must match the ReelGrid constructor above
+    const gridW = cols * cellSize + (cols - 1) * gap;
+    const gridH = rows * cellSize + (rows - 1) * gap;
+    const fit = Math.min((w * 0.92) / gridW, (h * 0.78) / gridH);
+    this.grid.scale.set(fit);
+    this.grid.x = Math.round((w - gridW * fit) / 2);
+    this.grid.y = Math.round((h - gridH * fit) / 2);
+    this.overlay?.resize?.(w, h);
+  }
+}
+`;
+}
+
+function genLuaLogic(a) {
+    const cascade = a.cascades === true;
+    const ret = cascade
+        ? `  return {
+    total_win = win,          -- bet-multiplier; the platform multiplies by the actual bet
+    cascades = {},            -- TODO: emit cascade steps { winning, removed, new, grid }
+    free_spins = free_spins_result,
+    -- The engine reads these VARIABLES (not the nested free_spins table) to open / retrigger the
+    -- free-spins SESSION. Without them, free_spin would fail "requires an active session".
+    variables = { free_spins_awarded = fs_awarded, retrigger_spins = retrigger_awarded },
+  }`
+        : `  return {
+    total_win = win,          -- bet-multiplier
+    matrix = grid,            -- 2D array of SYM.* ids
+    wins = {},                -- TODO: emit line/way wins
+    free_spins = free_spins_result,
+    -- The engine reads these VARIABLES (not the nested free_spins table) to open / retrigger the
+    -- free-spins SESSION. Without them, free_spin would fail "requires an active session".
+    variables = { free_spins_awarded = fs_awarded, retrigger_spins = retrigger_awarded },
+  }`;
+    return `-- Game logic. The spec-derived prelude (SPEC/SYMBOLS/SYM/PAYTABLE) is injected above this file.
+-- Reel weights / RTP tuning live here. Implement your mechanic; return a bet-multiplier in total_win.
+function execute(state)
+  -- state.action: 'spin' | 'ante' | 'buy_bonus' | 'free_spin'
+  -- state.bet, state.action_config.feature_data
+  local action = state.action or 'spin'
+  local grid = {}
+  for c = 1, SPEC.cols do
+    grid[c] = {}
+    for r = 1, SPEC.rows do
+      grid[c][r] = engine.random(1, #SYMBOLS)
+    end
+  end
+
+  -- Placeholder random payout (replace with your real mechanic).
+  local win = 0
+  local free_spins_result = nil
+  local fs_awarded = 0        -- engine VARIABLE: spins this round awards (opens the session)
+  local retrigger_awarded = 0 -- engine VARIABLE: extra spins a free_spin retrigger awards
+
+  if action == 'buy_bonus' then
+    -- Player bought free spins: always award them, no base win.
+    fs_awarded = 10
+    free_spins_result = { awarded = fs_awarded, total = fs_awarded }
+
+  elseif action == 'free_spin' then
+    -- Free-spin round: random payout + small retrigger chance (~5%).
+    local roll = engine.random(1, 1000)
+    if roll <= 400 then        -- ~40% small win (higher hit-rate in bonus)
+      win = engine.random(1, 8) * 0.3
+    elseif roll <= 440 then    -- ~4% medium win
+      win = engine.random(10, 50)
+    elseif roll <= 442 then    -- ~0.2% large win
+      win = engine.random(100, 800)
+    end
+    -- Retrigger: ~5% chance to award extra spins (read via retrigger_spins).
+    local retrigger_roll = engine.random(1, 100)
+    if retrigger_roll <= 5 then
+      retrigger_awarded = 5
+      free_spins_result = { awarded = retrigger_awarded, total = retrigger_awarded }
+    end
+
+  elseif action == 'ante' then
+    -- Ante (paid-boost) spin: same payouts as base but higher free-spins trigger (~5%).
+    local roll = engine.random(1, 1000)
+    if roll <= 250 then        -- ~25% small win
+      win = engine.random(1, 5) * 0.2
+    elseif roll <= 270 then    -- ~2% medium win
+      win = engine.random(5, 30)
+    elseif roll <= 272 then    -- ~0.2% large win
+      win = engine.random(50, 500)
+    end
+    local fs_roll = engine.random(1, 100)
+    if fs_roll <= 5 then       -- ~5% free-spins trigger
+      fs_awarded = 8
+      free_spins_result = { awarded = fs_awarded, total = fs_awarded }
+    end
+
+  else
+    -- Base spin ('spin'): random payout + small free-spins trigger (~2%).
+    local roll = engine.random(1, 1000)
+    if roll <= 250 then        -- ~25% small win
+      win = engine.random(1, 5) * 0.2
+    elseif roll <= 270 then    -- ~2% medium win
+      win = engine.random(5, 30)
+    elseif roll <= 272 then    -- ~0.2% large win
+      win = engine.random(50, 500)
+    end
+    local fs_roll = engine.random(1, 100)
+    if fs_roll <= 2 then       -- ~2% free-spins trigger
+      fs_awarded = 8
+      free_spins_result = { awarded = fs_awarded, total = fs_awarded }
+    end
+  end
+
+${ret}
+end
+`;
+}
+
+/** Generate src/stake/adapter.ts. The spin schema is the shared src/game/schema.ts (one schema for all games). */
+function genStakeAdapter(_a) {
+    const adapter = `import { createGameAdapter, type SegmentCore } from '@energy8platform/stake-kit';
+import { model } from '../game.spec';
+import { spinSchema, type SpinDataRaw } from '../game/schema';
+
+export const adapter = createGameAdapter<SpinDataRaw>({
+  model,
+  schema: spinSchema,
+  segmentOf: ({ event, payload, round }) => {
+    // Canonical Stake book events are { type, spin }; a free spin is type 'free_spin'.
+    const isFs = (event as { type?: string }).type === 'free_spin';
+    const core: SegmentCore<SpinDataRaw> = {
+      action: isFs ? 'free_spin' : round.triggerAction,
+      winX: payload.total_win ?? 0,
+      session: { roundId: round.roundId },
+    };
+    const awarded = payload.free_spins?.awarded ?? 0;
+    if (!isFs && awarded > 0) {
+      core.bonusFreeSpin = { grantId: 1, remainingSpins: awarded };
+    }
+    return core;
+  },
+});
+
+export default adapter;
+`;
+    return { adapter };
+}
+
+function genMainTs(a) {
+    const stakeImport = a.stake ? `import adapter from './stake/adapter';\n` : '';
+    const stakeOpt = a.stake ? `  stake: { adapter },\n` : '';
+    return `import { createSlotGame } from '@energy8platform/game-engine/host';
+import { ScaleMode } from '@energy8platform/game-engine';
+import { model } from './game.spec';
+import { GameScene } from './scenes/GameScene';
+import { IntroScene } from './scenes/IntroScene';
+import { normalize } from './game/normalize';
+${stakeImport}
+createSlotGame({
+  model,
+  normalize,
+  // Scenes in order — the first eligible one starts. 'intro' is skipped on a replay launch, so a
+  // replay opens directly on the game scene.
+  scenes: [
+    { key: 'intro', scene: IntroScene, skipOnReplay: true },
+    { key: 'game', scene: GameScene },
+  ],
+  manifest: { bundles: [] },
+  design: { width: 1920, height: 1080 },
+  scaleMode: ScaleMode.FILL,
+  fonts: ['400 24px "Inter"'],
+  textureDefaults: true,
+  dev: (import.meta as any).env?.DEV ?? false,
+${stakeOpt}  shell: {
+    // buy/ante cards + currency derive from the spec + initData.
+    // Base game-info sections. Wrap player-facing copy in t(...) so restricted gambling words are
+    // rewritten to social-casino vocabulary in social mode (t is the identity otherwise). The
+    // built-in sections (max win, paytable, controls, disclaimer) and the spec's buy/ante card copy
+    // are socialized automatically; t() is how YOUR custom copy joins in.
+    gameInfo: (t) => ({
+      sections: [
+        {
+          type: 'custom',
+          title: t('How to Play'),
+          html: \`<p>\${t('Spin the reels and match symbols to win. Buy the bonus to trigger free spins instantly.')}</p>\`,
+        },
+      ],
+    }),
+  },
+}).catch((err) => { console.error('[${a.id}] failed to start', err); });
+`;
+}
+
+/** Generate src/scenes/IntroScene.ts: a real game-owned Scene subclass (edit freely).
+ * The host injects goto() via scene start data; call goto('game') to advance. */
+function genIntroScene(a) {
+    return `import { Container, Graphics, Text } from 'pixi.js';
+import { Scene } from '@energy8platform/game-engine/core';
+import { Tween } from '@energy8platform/game-engine/animation';
+
+/** Start data the host injects into every scene (goto navigates between scenes). */
+interface IntroData { goto?: (key: string, data?: unknown) => void; }
+
+/** Full intro scene for ${a.title}. Edit this freely — background, logo, buttons, animation. */
+export class IntroScene extends Scene {
+  private layer?: Container;
+
+  async onEnter(data?: unknown): Promise<void> {
+    const { goto } = (data ?? {}) as IntroData;
+    const layer = new Container();
+    this.layer = layer;
+    this.container.addChild(layer);
+
+    // Background — replace with a texture sprite once you have art.
+    const bg = new Graphics().rect(0, 0, 1920, 1080).fill({ color: 0x0b0f1a });
+    layer.addChild(bg);
+
+    const title = new Text({ text: '${a.title}', style: { fill: 0xffffff, fontSize: 110, fontFamily: 'Inter', fontWeight: '700', align: 'center' } });
+    title.anchor.set(0.5); title.position.set(960, 420);
+    layer.addChild(title);
+
+    const subtitle = new Text({ text: 'Press PLAY to begin', style: { fill: 0x9fb3c8, fontSize: 34, fontFamily: 'Inter' } });
+    subtitle.anchor.set(0.5); subtitle.position.set(960, 520);
+    layer.addChild(subtitle);
+
+    // PLAY button (replace with the engine UI Button or your own art).
+    const btn = new Container(); btn.position.set(960, 660);
+    const bgBtn = new Graphics().roundRect(-150, -45, 300, 90, 16).fill({ color: 0xffd24a });
+    const label = new Text({ text: 'PLAY', style: { fill: 0x0b0f1a, fontSize: 40, fontFamily: 'Inter', fontWeight: '700' } });
+    label.anchor.set(0.5);
+    btn.addChild(bgBtn, label);
+    btn.eventMode = 'static'; btn.cursor = 'pointer';
+    btn.once('pointerdown', () => goto?.('game'));
+    layer.addChild(btn);
+
+    layer.alpha = 0;
+    await Tween.to(layer, { alpha: 1 }, 400);
+  }
+
+  onExit(): void {
+    this.layer?.destroy({ children: true });
+    this.layer = undefined;
+  }
+}
+`;
+}
+
+/** Generate src/game/normalize.ts: game-declared SpinData + the host normalizer.
+ * Coercion (Lua {} → []) is schema-driven via stake-kit's deriveArrayFields + coerceLuaArrays. */
+function genNormalize(a) {
+    const cascade = a.cascades === true;
+    const dataShape = cascade
+        ? `  /** Cascade steps the scene animates via CascadeController. */
+  steps: CascadeStepData[];
+  /** Optional running multiplier the scene reflects. */
+  multiplier?: number;`
+        : `  /** Result grid by column for the reel spin. */
+  targetGrid: CellData[][];`;
+    const mapBody = cascade
+        ? `    steps: Array.isArray(d.cascades) ? d.cascades.map((step: any) => ({
+      winningCells: step.winning ?? [],
+      removedCells: step.removed ?? [],
+      newCells: step.new ?? [],
+      settledGrid: step.grid ?? [],
+    })) : [],
+    multiplier: d.multiplier,`
+        : `    targetGrid: d.matrix ?? [],`;
+    return `import type { SlotSpinResultBase, SlotResultNormalizer } from '@energy8platform/platform-core/slot-result';
+import type { ${cascade ? 'CascadeStepData' : 'CellData'} } from '@energy8platform/game-engine/slot';
+import { deriveArrayFields, coerceLuaArrays } from '@energy8platform/stake-kit';
+import { spinSchema, type SpinDataRaw } from './schema';
+
+/** The game's typed play result. Extend with any fields your script.logic.lua returns. */
+export interface SpinData extends SlotSpinResultBase {
+${dataShape}
+}
+
+// Array fields are derived from the schema once (Lua empty tables {} → []), so the
+// scene-facing mapping below can rely on real arrays — no crashes from Lua empty tables.
+const arrayFields = deriveArrayFields(spinSchema);
+
+/** REQUIRED: map the raw play result into SpinData. The host calls this on every play. */
+export const normalize: SlotResultNormalizer<SpinData> = (raw) => {
+  const r = (raw ?? {}) as { totalWin?: number; data?: unknown };
+  const coerced = coerceLuaArrays((r.data ?? {}) as Record<string, unknown>, arrayFields);
+  const parsed = spinSchema.safeParse(coerced);
+  const d = (parsed.success ? parsed.data : coerced) as SpinDataRaw;
+  return {
+    totalWin: r.totalWin ?? 0,
+    freeSpins: d.free_spins ? { awarded: d.free_spins.awarded, total: d.free_spins.total } : undefined,
+${mapBody}
+  };
+};
+`;
+}
+
+/** Generate src/game/schema.ts: the zod schema for the inner Lua data table.
+ * Array fields are plain z.array(...) so stake-kit's deriveArrayFields() finds them
+ * and coerceLuaArrays() can turn Lua {} into [] (used by normalize AND the stake adapter). */
+function genSchema(a) {
+    const cascade = a.cascades === true;
+    const arrayFields = cascade
+        ? `    cascades: z.array(z.object({}).passthrough()).optional(),`
+        : `    matrix: z.array(z.array(z.number())).optional(),
+    wins: z.array(z.object({}).passthrough()).optional(),`;
+    return `import { z } from 'zod';
+
+/** The inner Lua "data" table your script.logic.lua returns (the engine nests it under result.data).
+ * Edit these fields to match your math. Array fields MUST stay z.array(...) so Lua {} coerces to []. */
+export const spinSchema = z.object({
+  total_win: z.number().optional(),
+${arrayFields}
+  multiplier: z.number().optional(),
+  free_spins: z.object({ awarded: z.number(), total: z.number() }).optional(),
+});
+export type SpinDataRaw = z.infer<typeof spinSchema>;
+`;
+}
+
+function genMathConfig(_a) {
+    return `import { readFileSync } from 'node:fs';
+import { buildLuaScript } from '@energy8platform/platform-core/game-spec';
+import { model } from './src/game.spec';
+import type { MathConfig } from '@energy8platform/stake-math-tools';
+
+// node-only (the e8-math CLI runs in node) — reads the Lua via node:fs, not Vite raw imports.
+const logic = readFileSync(new URL('./src/game/script.logic.lua', import.meta.url), 'utf8');
+
+export default {
+  model,
+  luaScript: buildLuaScript(model, logic),
+  // One block per Stake mode key. Tune sim iterations + curate targets per mode.
+  // Missing modes use seeded defaults (see resolveModes in stake-math-tools).
+  modes: {
+    BASE: {
+      sim: { iterations: 100_000, bet: 1, rng: 'provably-fair' },
+      curate: {
+        capMaxWin: model.spec.maxWin * 100, // cents (bet-multiplier × 100)
+        algorithm: 'tiered',
+        targetRTP: 0.96,
+        toleranceRTP: 0.01,
+        targetCV: 5,
+        toleranceCV: 2,
+        targetHitRate: 0.25,
+        toleranceHitRate: 0.05,
+        nRowsOut: 50_000, // keep nRowsOut < iterations
+      },
+    },
+    // Feature modes. Only sim.iterations is set by default — the remaining sim params and all
+    // curate targets fall back to seeded defaults (capMaxWin from spec.maxWin); tune as needed.
+    BUY_BONUS: { sim: { iterations: 100_000 } },
+    ANTE: { sim: { iterations: 100_000 } },
+  },
+} satisfies MathConfig;
+`;
+}
+
+const TEMPLATE_DIR = resolve(fileURLToPath(new URL('.', import.meta.url)), '../template');
+function substituteTree(dir, vars) {
+    // NOTE: template is text-only. If binary placeholders are ever added under template/,
+    // add a file-extension allowlist here — readFileSync(p,'utf8') would corrupt them.
+    for (const name of readdirSync(dir)) {
+        const p = join(dir, name);
+        if (statSync(p).isDirectory()) {
+            substituteTree(p, vars);
+            continue;
+        }
+        let text = readFileSync(p, 'utf8');
+        for (const [k, val] of Object.entries(vars))
+            text = text.split('${' + k + '}').join(val);
+        writeFileSync(p, text);
+    }
+}
+async function generate(a, targetDir, versions) {
+    validate(a);
+    mkdirSync(targetDir, { recursive: true });
+    // 1) copy fixed template
+    cpSync(TEMPLATE_DIR, targetDir, { recursive: true });
+    // _gitignore → .gitignore
+    if (existsSync(join(targetDir, '_gitignore')))
+        renameSync(join(targetDir, '_gitignore'), join(targetDir, '.gitignore'));
+    // 2) substitute ${id}/${title}
+    substituteTree(targetDir, { id: a.id, title: a.title });
+    // 3) codegen files
+    mkdirSync(join(targetDir, 'src/game'), { recursive: true });
+    mkdirSync(join(targetDir, 'src/scenes'), { recursive: true });
+    writeFileSync(join(targetDir, 'src/game.spec.ts'), genGameSpec(a));
+    writeFileSync(join(targetDir, 'CLAUDE.md'), genClaudeMd(a));
+    writeFileSync(join(targetDir, 'package.json'), genPackageJson(a, versions));
+    writeFileSync(join(targetDir, 'math.config.ts'), genMathConfig());
+    writeFileSync(join(targetDir, 'src/scenes/GameScene.ts'), genGameScene(a));
+    writeFileSync(join(targetDir, 'src/main.ts'), genMainTs(a));
+    writeFileSync(join(targetDir, 'src/scenes/IntroScene.ts'), genIntroScene(a));
+    writeFileSync(join(targetDir, 'src/game/script.logic.lua'), genLuaLogic(a));
+    writeFileSync(join(targetDir, 'src/game/normalize.ts'), genNormalize(a));
+    writeFileSync(join(targetDir, 'src/game/schema.ts'), genSchema(a));
+    if (a.stake) {
+        mkdirSync(join(targetDir, 'src/stake'), { recursive: true });
+        const { adapter } = genStakeAdapter();
+        writeFileSync(join(targetDir, 'src/stake/adapter.ts'), adapter);
+    }
+    else if (existsSync(join(targetDir, 'src/stake'))) {
+        rmSync(join(targetDir, 'src/stake'), { recursive: true, force: true });
+    }
+}
+
+// Dependency versions written into a scaffolded game's package.json. Keep in lock-step with the
+// published @energy8platform/* versions (a create-slot test asserts these match the workspace).
+const PUBLISHED = {
+    'platform-core': '^0.25.0', 'game-engine': '^0.18.0', 'stake-kit': '^0.2.0', 'stake-bridge': '^0.3.0',
+    'stake-math-tools': '^0.8.0',
+};
+async function main() {
+    const seed = seedFromArgv(argv.slice(2));
+    const yes = argv.includes('--yes');
+    const answers = yes ? applyDefaults(seed) : await prompt(seed);
+    const dir = resolve(process.cwd(), answers.id);
+    await generate(answers, dir, PUBLISHED);
+    console.log(`\n✓ Created ${answers.id} at ${dir}\n  cd ${answers.id} && npm install && npm run dev\n`);
+}
+main().catch((err) => { console.error(err.message); exit(1); });
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../src/answers.ts","../src/prompts.ts","../src/codegen/gameSpec.ts","../src/codegen/claudeMd.ts","../src/codegen/packageJson.ts","../src/codegen/gameScene.ts","../src/codegen/luaLogic.ts","../src/codegen/stakeAdapter.ts","../src/codegen/mainTs.ts","../src/codegen/introScene.ts","../src/codegen/normalize.ts","../src/codegen/schema.ts","../src/codegen/mathConfig.ts","../src/generate.ts","../src/cli.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@energy8platform/create-slot",
+  "version": "0.2.0",
+  "type": "module",
+  "bin": { "create-slot": "dist/cli.js" },
+  "files": ["dist", "template"],
+  "scripts": {
+    "build": "rollup -c rollup.config.ts --configPlugin @rollup/plugin-typescript",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "^12.1.0",
+    "@types/node": "^20.0.0",
+    "rollup": "^4.24.0",
+    "tslib": "^2.8.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}

package/template/README.md

@@ -0,0 +1,15 @@
+# ${title}
+
+Generated with `npm create @energy8platform/slot`. Built on @energy8platform game-spec / host / stake-kit / slot.
+
+## Develop
+- `npm install`
+- `npm run dev` — runs the game in a browser (Vite + in-process DevBridge running your Lua)
+- Edit `src/game.spec.ts` (symbols/paytable/bet levels/actions) and `src/game/script.logic.lua` (math).
+- Swap placeholder art in `public/assets/` (see NAMING.md) and wire it in `src/slot/symbols.ts`.
+
+## Verify
+- `npm run typecheck`
+- `npm run smoke` — proves spec → export artifacts
+
+See the `slot-game-creator` skill for the full mechanics → math → art → UI workflow.

package/template/_gitignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+dist-stake

package/template/dev.config.ts

@@ -0,0 +1,13 @@
+import { buildLuaScript } from '@energy8platform/platform-core/game-spec';
+import { model } from './src/game.spec';
+import logic from './src/game/script.logic.lua?raw';
+
+export default {
+  balance: 100000,
+  currency: model.spec.currency ?? 'EUR',
+  networkDelay: 80,
+  debug: true,
+  gameDefinition: model.gameDefinition,
+  luaScript: buildLuaScript(model, logic),
+  luaSeed: 12345,
+};

package/template/index.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover" />
+    <title>${title}</title>
+    <style>
+      html, body { margin: 0; padding: 0; height: 100%; overflow: hidden; background: #0a0a12; }
+      #game { position: fixed; inset: 0; }
+      canvas { display: block; }
+    </style>
+  </head>
+  <body>
+    <div id="game"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/template/public/assets/audio/NAMING.md

@@ -0,0 +1,3 @@
+# Asset naming
+Name each symbol sprite after its spec symbol id, lowercased: `h1.webp`, `wild.webp`, `scatter.webp`.
+Backgrounds: `bg-base.webp`, `bg-fs.webp`. Audio: `bgm-base.mp3`, `sfx-spin.mp3`. VFX: spritesheets per effect.

package/template/public/assets/bg/NAMING.md

@@ -0,0 +1,3 @@
+# Asset naming
+Name each symbol sprite after its spec symbol id, lowercased: `h1.webp`, `wild.webp`, `scatter.webp`.
+Backgrounds: `bg-base.webp`, `bg-fs.webp`. Audio: `bgm-base.mp3`, `sfx-spin.mp3`. VFX: spritesheets per effect.

package/template/public/assets/symbols/NAMING.md

@@ -0,0 +1,3 @@
+# Asset naming
+Name each symbol sprite after its spec symbol id, lowercased: `h1.webp`, `wild.webp`, `scatter.webp`.
+Backgrounds: `bg-base.webp`, `bg-fs.webp`. Audio: `bgm-base.mp3`, `sfx-spin.mp3`. VFX: spritesheets per effect.

package/template/public/assets/vfx/NAMING.md

@@ -0,0 +1,3 @@
+# Asset naming
+Name each symbol sprite after its spec symbol id, lowercased: `h1.webp`, `wild.webp`, `scatter.webp`.
+Backgrounds: `bg-base.webp`, `bg-fs.webp`. Audio: `bgm-base.mp3`, `sfx-spin.mp3`. VFX: spritesheets per effect.

package/template/src/slot/symbols.ts

@@ -0,0 +1,6 @@
+import { Texture } from 'pixi.js';
+import { AnimatedSymbol, type SymbolResolver } from '@energy8platform/game-engine/slot';
+
+// Placeholder resolver: every symbol is a blank tile. Swap in real textures from public/assets/symbols.
+export const resolveSymbol: SymbolResolver = (id: string) =>
+  new AnimatedSymbol({ textures: { base: id ? Texture.WHITE : Texture.EMPTY }, size: 110 });

package/template/src/theme.ts

@@ -0,0 +1,3 @@
+export const DESIGN_W = 1920;
+export const DESIGN_H = 1080;
+export const COLORS = { bg: 0x0a0a12, accent: 0xffd24a };

package/template/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM"],
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}

package/template/vite.config.ts

@@ -0,0 +1,19 @@
+import { defineGameConfig } from '@energy8platform/game-engine/vite';
+import { stakeHarnessPlugin } from '@energy8platform/stake-kit/harness';
+
+const target = process.env.BUILD_TARGET;
+const isStake = target === 'stake';
+const isHarness = target === 'stake-harness';
+
+export default defineGameConfig({
+  base: './',
+  // Stake builds and harness run inside the Stake RGS shell — no local DevBridge.
+  devBridge: !isStake && !isHarness,
+  devBridgeConfig: './dev.config',
+  vite: {
+    server: { port: 5173 },
+    optimizeDeps: { include: ['pixi.js'], exclude: ['fengari'] },
+    ...(isStake ? { build: { outDir: 'dist-stake' } } : {}),
+    ...(isHarness ? { plugins: [stakeHarnessPlugin({ config: './math.config.ts', booksDir: 'stake-math' })] } : {}),
+  },
+});