hbengine 0.2.3

package/engine-examples/crash/math/crash-47.tsv

@@ -0,0 +1,2 @@
+741600	{"ok":1}
+115400	{"ok":0}

package/engine-examples/crash/math/crash-48.tsv

@@ -0,0 +1,2 @@
+857000	{"ok":1}
+133200	{"ok":0}

package/engine-examples/crash/math/crash-49.tsv

@@ -0,0 +1,2 @@
+990200	{"ok":1}
+154000	{"ok":0}

package/engine-examples/crash/math/crash-50.tsv

@@ -0,0 +1,2 @@
+1144200	{"ok":1}
+177900	{"ok":0}

package/engine-examples/crash/math/crash-51.tsv

@@ -0,0 +1,2 @@
+1322100	{"ok":1}
+205600	{"ok":0}

package/engine-examples/crash/math/crash-52.tsv

@@ -0,0 +1,2 @@
+1527700	{"ok":1}
+237500	{"ok":0}

package/engine-examples/crash/math/crash-53.tsv

@@ -0,0 +1,2 @@
+1765200	{"ok":1}
+274500	{"ok":0}

package/engine-examples/crash/math/crash-54.tsv

@@ -0,0 +1,2 @@
+2039700	{"ok":1}
+317200	{"ok":0}

package/engine-examples/crash/math/crash-55.tsv

@@ -0,0 +1,2 @@
+2356900	{"ok":1}
+366400	{"ok":0}

package/engine-examples/crash/math/crash-56.tsv

@@ -0,0 +1,2 @@
+2723300	{"ok":1}
+423500	{"ok":0}

package/engine-examples/crash/math/crash-57.tsv

@@ -0,0 +1,2 @@
+3146800	{"ok":1}
+489300	{"ok":0}

package/engine-examples/crash/math/crash-58.tsv

@@ -0,0 +1,2 @@
+3636100	{"ok":1}
+565400	{"ok":0}

package/engine-examples/crash/math/crash-59.tsv

@@ -0,0 +1,2 @@
+4201500	{"ok":1}
+653200	{"ok":0}

package/engine-examples/crash/math/crash-60.tsv

@@ -0,0 +1,2 @@
+4854700	{"ok":1}
+754900	{"ok":0}

package/engine-examples/crash/math/crash-61.tsv

@@ -0,0 +1,2 @@
+5609600	{"ok":1}
+872300	{"ok":0}

package/engine-examples/crash/math/crash-62.tsv

@@ -0,0 +1,2 @@
+6481900	{"ok":1}
+1007800	{"ok":0}

package/engine-examples/crash/math/crash-63.tsv

@@ -0,0 +1,2 @@
+7489700	{"ok":1}
+1164600	{"ok":0}

package/engine-examples/crash/math/crash-64.tsv

@@ -0,0 +1,2 @@
+8654300	{"ok":1}
+1345700	{"ok":0}

package/engine-examples/crash/math/gen.mjs

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+// Crash's maths, as a ladder with cash-out: 64 levels from 1.01× to about
+// 1,000× (every 0.05× up to 2×, then about 15% a level). Level k is
+// survived with weight m(k−1) against m(k) − m(k−1) (the first: 0.99
+// against what is left), so cashing out at any level returns exactly 99%.
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+const DIR = dirname(fileURLToPath(import.meta.url));
+const project = join(DIR, '..', 'hbengine.json');
+const GAME = process.argv[2] || (existsSync(project) ? JSON.parse(readFileSync(project, 'utf8')).slug : 'crash');
+const RTP = 9900;
+
+// The levels, in basis points, whole hundredths of ×.
+const levels = [10100];
+for (let x = 10500; x <= 20000; x += 500) levels.push(x);
+const rest = 64 - levels.length, ratio = (1000 / 2) ** (1 / rest);
+for (let i = 1; i <= rest; i++) levels.push(Math.max(levels.at(-1) + 100, Math.round(20000 * ratio ** i / 100) * 100));
+
+mkdirSync(DIR, { recursive: true });
+const steps = levels.map((m, k) => {
+    const table = `${GAME}-${String(k + 1).padStart(2, '0')}.tsv`;
+    const [live, bust] = k === 0 ? [RTP, m - RTP] : [levels[k - 1], m - levels[k - 1]];
+    writeFileSync(join(DIR, table), `${live}\t{"ok":1}\n${bust}\t{"ok":0}\n`);
+    return { table };
+});
+const manifest = { format: 'house-engine-math/1', game: GAME, rtpBp: RTP, modes: [{ id: 'crash', label: 'Crash', kind: 'ladder', steps, cashout: true, ladderBp: levels, bets: [{ id: 'play', label: 'Play', survive: [[0, 0]] }] }] };
+writeFileSync(join(DIR, 'manifest.json'), JSON.stringify(manifest) + '\n');
+console.log(`${levels.length} levels: ${levels.slice(0, 4).map((m) => m / 10000).join(', ')} … ${levels.at(-1) / 10000}×; 99% at every cash-out`);

package/engine-examples/crash/math/manifest.json

@@ -0,0 +1 @@
+{"format":"house-engine-math/1","game":"crash","rtpBp":9900,"modes":[{"id":"crash","label":"Crash","kind":"ladder","steps":[{"table":"crash-01.tsv"},{"table":"crash-02.tsv"},{"table":"crash-03.tsv"},{"table":"crash-04.tsv"},{"table":"crash-05.tsv"},{"table":"crash-06.tsv"},{"table":"crash-07.tsv"},{"table":"crash-08.tsv"},{"table":"crash-09.tsv"},{"table":"crash-10.tsv"},{"table":"crash-11.tsv"},{"table":"crash-12.tsv"},{"table":"crash-13.tsv"},{"table":"crash-14.tsv"},{"table":"crash-15.tsv"},{"table":"crash-16.tsv"},{"table":"crash-17.tsv"},{"table":"crash-18.tsv"},{"table":"crash-19.tsv"},{"table":"crash-20.tsv"},{"table":"crash-21.tsv"},{"table":"crash-22.tsv"},{"table":"crash-23.tsv"},{"table":"crash-24.tsv"},{"table":"crash-25.tsv"},{"table":"crash-26.tsv"},{"table":"crash-27.tsv"},{"table":"crash-28.tsv"},{"table":"crash-29.tsv"},{"table":"crash-30.tsv"},{"table":"crash-31.tsv"},{"table":"crash-32.tsv"},{"table":"crash-33.tsv"},{"table":"crash-34.tsv"},{"table":"crash-35.tsv"},{"table":"crash-36.tsv"},{"table":"crash-37.tsv"},{"table":"crash-38.tsv"},{"table":"crash-39.tsv"},{"table":"crash-40.tsv"},{"table":"crash-41.tsv"},{"table":"crash-42.tsv"},{"table":"crash-43.tsv"},{"table":"crash-44.tsv"},{"table":"crash-45.tsv"},{"table":"crash-46.tsv"},{"table":"crash-47.tsv"},{"table":"crash-48.tsv"},{"table":"crash-49.tsv"},{"table":"crash-50.tsv"},{"table":"crash-51.tsv"},{"table":"crash-52.tsv"},{"table":"crash-53.tsv"},{"table":"crash-54.tsv"},{"table":"crash-55.tsv"},{"table":"crash-56.tsv"},{"table":"crash-57.tsv"},{"table":"crash-58.tsv"},{"table":"crash-59.tsv"},{"table":"crash-60.tsv"},{"table":"crash-61.tsv"},{"table":"crash-62.tsv"},{"table":"crash-63.tsv"},{"table":"crash-64.tsv"}],"cashout":true,"ladderBp":[10100,10500,11000,11500,12000,12500,13000,13500,14000,14500,15000,15500,16000,16500,17000,17500,18000,18500,19000,19500,20000,23100,26700,30900,35700,41200,47600,55000,63600,73400,84900,98100,113300,130900,151300,174800,202000,233400,269700,311600,360100,416000,480700,555500,641800,741600,857000,990200,1144200,1322100,1527700,1765200,2039700,2356900,2723300,3146800,3636100,4201500,4854700,5609600,6481900,7489700,8654300,10000000],"bets":[{"id":"play","label":"Play","survive":[[0,0]]}]}]}

package/engine-examples/dice/AGENTS.md

@@ -0,0 +1,3 @@
+# For agents
+
+This is a House Engine game (Housebets). Read the guide first: `engine_guide` (MCP) or `engine-sdk/GUIDE.md`. Then `hbengine verify`, `hbengine dev`, `hbengine upload` (or the `engine_*` tools). The math is `math/`, the frontend `bundle/`; never compute money or outcomes in the frontend.

package/engine-examples/dice/README.md

@@ -0,0 +1,25 @@
+# Dice — a target bet on a 0–99 roll
+
+One table of 100 outcomes, two bet families on it: `under-N` (roll < N)
+and `over-N` (roll > N) for N in 2..98. The zone picks the bet by
+setting `game.bet`; `/engine-sdk/ui.js` draws the panel around it.
+
+## Multipliers and RTP (exact, integer arithmetic)
+
+For a bet with W winning rows out of 100:
+
+    multBp  = floor(99 * 10000 / W)
+    rtpBp   = W * multBp / 100
+
+- `under-N`:  W = N,       N in 2..98
+- `over-N`:   W = 99 - N,  N in 2..98
+
+Every bet pays. 67 of the 194 bets land on exactly 99.00% (every W that
+divides 990000); the rest lose at most 0.86 bp to the floor. The worst
+is `under-94` / `over-5` (W = 94): mult = 1.0531×, RTP = 98.9914%.
+
+The mode's `rtpBp` cap is 9900, so the engine's own check verifies this
+on every pack load (`report.rtp` per bet; see `curl /engine/v1/math/dice`).
+
+    npx hbengine verify .                      exact RTP per bet, the mathHash
+    npx hbengine init my-dice --template dice --slug my-dice   # make it yours, then: verify, dev, upload

package/engine-examples/dice/bundle/assets.json

@@ -0,0 +1 @@
+{ "groups": { "boot": { "files": ["index.html", "game.js", "game.css"] } } }

package/engine-examples/dice/bundle/game.css

@@ -0,0 +1,17 @@
+body { margin: 0; background: #08141a; color: #F9F9FB; font: 500 14px/1.4 'Figtree', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; }
+.dice { width: 100%; max-width: 560px; box-sizing: border-box; padding: 20px; display: grid; gap: 20px; }
+.facts { display: flex; flex-wrap: wrap; gap: 16px; justify-content: space-between; font-size: 13px; color: #8F96A8; font-variant-numeric: tabular-nums; }
+.facts b { color: #F9F9FB; font-weight: 700; font-size: 15px; }
+.track { position: relative; height: 48px; background: #0b1f28; border: 1px solid #0D2A38; border-radius: 24px; }
+.win { position: absolute; top: 0; bottom: 0; background: rgba(40, 243, 243, 0.22); border-left: 1px solid #28F3F3; border-right: 1px solid #28F3F3; border-radius: inherit; }
+.scale { position: absolute; inset: 100% 12px auto 12px; padding-top: 6px; display: flex; justify-content: space-between; color: #8F96A8; font-size: 11px; font-variant-numeric: tabular-nums; }
+.marker { position: absolute; top: 50%; left: 22px; transform: translate(-50%, -50%); min-width: 44px; height: 36px; padding: 0 10px; display: grid; place-items: center; border-radius: 18px; background: #28F3F3; color: #041015; font-weight: 700; font-size: 15px; font-variant-numeric: tabular-nums; box-shadow: 0 6px 20px rgba(0,0,0,.4); transition: left 620ms cubic-bezier(.2,.8,.2,1); }
+.marker.win { background: #58e879; }
+.marker.lose { background: #FA2E5D; color: #F9F9FB; }
+.pick { display: grid; gap: 12px; }
+.side { display: inline-flex; padding: 3px; gap: 3px; background: rgba(9,102,125,0.15); border-radius: 8px; justify-self: start; }
+.side button { height: 32px; padding: 0 14px; border: 0; border-radius: 6px; background: transparent; color: #8F96A8; font: inherit; font-weight: 600; cursor: pointer; }
+.side button[aria-pressed="true"] { background: #0D2A38; color: #F9F9FB; }
+.target { display: grid; grid-template-columns: 1fr auto; gap: 12px; align-items: center; }
+.target input[type="range"] { width: 100%; accent-color: #28F3F3; }
+.target output { color: #F9F9FB; font-weight: 700; font-variant-numeric: tabular-nums; min-width: 28px; text-align: right; }

package/engine-examples/dice/bundle/game.js

@@ -0,0 +1,61 @@
+// Dice: roll under or over N on 0–99. The zone picks the bet by setting
+// game.bet; /engine-sdk/ui.js draws the panel around it.
+import { mount } from '/engine-sdk/ui.js';
+
+const el = document.getElementById('game');
+const marker = document.getElementById('marker');
+const winBand = document.getElementById('win');
+const mult = document.getElementById('mult');
+const chance = document.getElementById('chance');
+const maxwin = document.getElementById('maxwin');
+const target = document.getElementById('target');
+const val = document.getElementById('val');
+const sides = el.querySelectorAll('[data-side]');
+const wait = (ms) => new Promise((r) => setTimeout(r, ms));
+const pct = (x) => (x / 99 * 100) + '%';
+
+let side = 'under';
+let n = 50;
+
+const game = await mount(el, {
+    async reveal(round) {
+        const roll = round.data[0].roll;
+        marker.classList.remove('win', 'lose');
+        marker.textContent = '?';
+        marker.style.transition = 'none';
+        marker.style.left = '22px';
+        void marker.offsetWidth;
+        marker.style.transition = '';
+        await wait(40);
+        marker.style.left = `clamp(22px, ${pct(roll)}, calc(100% - 22px))`; // the marker stays on the track at 0 and 99
+        await wait(620);
+        marker.textContent = String(roll);
+        marker.classList.add(round.payout > 0 ? 'win' : 'lose');
+    },
+});
+const { engine, field } = game;
+const money = engine.money;
+const bets = new Map(engine.config.modes[0].bets.map((b) => [b.id, b]));
+const range = () => (side === 'under' ? [0, n - 1] : [n + 1, 99]);
+
+function paint() {
+    val.textContent = String(n);
+    const [lo, hi] = range();
+    winBand.style.left = pct(lo);
+    winBand.style.width = pct(hi - lo);
+    chance.textContent = String(hi - lo + 1);
+    const bet = bets.get(`${side}-${n}`);
+    const m = bet.maxMultBp / 10000;
+    mult.textContent = m.toFixed(2) + '×';
+    maxwin.textContent = money.sign + money.format(money.payout(field.amount, m)) + (money.sign ? '' : ' ' + money.unit);
+    game.bet = bet.id;
+}
+
+for (const s of sides) s.addEventListener('click', () => {
+    side = s.dataset.side;
+    for (const o of sides) o.setAttribute('aria-pressed', String(o === s));
+    paint();
+});
+target.addEventListener('input', () => { n = +target.value; paint(); });
+field.addEventListener('change', paint);
+paint();

package/engine-examples/dice/bundle/hbtest.json

@@ -0,0 +1,4 @@
+{
+  "stake": { "page": "index.html", "selector": "hb-game hb-bet-amount input", "value": "1.00" },
+  "bet": { "page": "index.html", "selector": "hb-game [data-main]" }
+}

package/engine-examples/dice/bundle/index.html

@@ -0,0 +1,34 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+<title>Dice</title>
+<link rel="stylesheet" href="./game.css">
+<script type="module" src="/engine-sdk/bet-field.js"></script>
+<script type="module" src="./game.js"></script>
+</head>
+<body>
+<hb-game id="game">
+  <div slot="zone" class="dice" aria-live="polite">
+    <div class="facts">
+      <span>Payout <b id="mult">2.00×</b></span>
+      <span>Chance <b id="chance">50</b>%</span>
+      <span>Max win <b id="maxwin">—</b></span>
+    </div>
+    <div class="track" id="track">
+      <div class="win" id="win"></div>
+      <div class="scale"><span>0</span><span>25</span><span>50</span><span>75</span><span>99</span></div>
+      <div class="marker" id="marker">?</div>
+    </div>
+    <div class="pick">
+      <div class="side" role="tablist">
+        <button type="button" data-side="under" aria-pressed="true">Under</button>
+        <button type="button" data-side="over">Over</button>
+      </div>
+      <label class="target"><input id="target" type="range" min="2" max="98" step="1" value="50" aria-label="target"><output id="val">50</output></label>
+    </div>
+  </div>
+</hb-game>
+</body>
+</html>

package/engine-examples/dice/math/dice.tsv

@@ -0,0 +1,100 @@
+1	{"roll":0}
+1	{"roll":1}
+1	{"roll":2}
+1	{"roll":3}
+1	{"roll":4}
+1	{"roll":5}
+1	{"roll":6}
+1	{"roll":7}
+1	{"roll":8}
+1	{"roll":9}
+1	{"roll":10}
+1	{"roll":11}
+1	{"roll":12}
+1	{"roll":13}
+1	{"roll":14}
+1	{"roll":15}
+1	{"roll":16}
+1	{"roll":17}
+1	{"roll":18}
+1	{"roll":19}
+1	{"roll":20}
+1	{"roll":21}
+1	{"roll":22}
+1	{"roll":23}
+1	{"roll":24}
+1	{"roll":25}
+1	{"roll":26}
+1	{"roll":27}
+1	{"roll":28}
+1	{"roll":29}
+1	{"roll":30}
+1	{"roll":31}
+1	{"roll":32}
+1	{"roll":33}
+1	{"roll":34}
+1	{"roll":35}
+1	{"roll":36}
+1	{"roll":37}
+1	{"roll":38}
+1	{"roll":39}
+1	{"roll":40}
+1	{"roll":41}
+1	{"roll":42}
+1	{"roll":43}
+1	{"roll":44}
+1	{"roll":45}
+1	{"roll":46}
+1	{"roll":47}
+1	{"roll":48}
+1	{"roll":49}
+1	{"roll":50}
+1	{"roll":51}
+1	{"roll":52}
+1	{"roll":53}
+1	{"roll":54}
+1	{"roll":55}
+1	{"roll":56}
+1	{"roll":57}
+1	{"roll":58}
+1	{"roll":59}
+1	{"roll":60}
+1	{"roll":61}
+1	{"roll":62}
+1	{"roll":63}
+1	{"roll":64}
+1	{"roll":65}
+1	{"roll":66}
+1	{"roll":67}
+1	{"roll":68}
+1	{"roll":69}
+1	{"roll":70}
+1	{"roll":71}
+1	{"roll":72}
+1	{"roll":73}
+1	{"roll":74}
+1	{"roll":75}
+1	{"roll":76}
+1	{"roll":77}
+1	{"roll":78}
+1	{"roll":79}
+1	{"roll":80}
+1	{"roll":81}
+1	{"roll":82}
+1	{"roll":83}
+1	{"roll":84}
+1	{"roll":85}
+1	{"roll":86}
+1	{"roll":87}
+1	{"roll":88}
+1	{"roll":89}
+1	{"roll":90}
+1	{"roll":91}
+1	{"roll":92}
+1	{"roll":93}
+1	{"roll":94}
+1	{"roll":95}
+1	{"roll":96}
+1	{"roll":97}
+1	{"roll":98}
+1	{"roll":99}