@imperialbower/bowery 0.0.0 → 0.1.0

package/MANIFEST.sha256

@@ -0,0 +1,8 @@
+775ebac50d3042c8c90b52418414588ea1b7b433fbc854899e908b6f8ec92158  LICENSE-APACHE
+a5fb933e5d0221688f909047fbe29b70b11cb25d5cb9a08e59a269df7ee15266  LICENSE-MIT
+d15cfb86c381c17f40bcae4977098e77aa74caf1cad1f49cf409c1c89e3702cd  README.md
+a9224c7609958d7222e9dcf3718020873e05c56535c24e09c21a71587f2170ae  bowery.css
+69b0d329338f15d473a4fb3920863948dc8f92fba01857882dade8752ebc5eec  bowery.js
+47cd091c2d631f544ba4c9c6ae902b338773dceec3deb42571f40b19b32acf80  bowery_wasm.js
+b8412512d47cb9fdbbeb8c434d0e93d5b69b65f851eb6c91318c2dca90f68c03  bowery_wasm_bg.wasm
+39b49a99faf77e9dde1703dfad704b28c90f88587dd0e6d7ae6197676759cbb5  package.json

package/README.md

@@ -1,4 +1,5 @@
 [![Crates.io](https://img.shields.io/crates/v/bowery.svg)](https://crates.io/crates/bowery)
+[![npm](https://img.shields.io/npm/v/@imperialbower/bowery.svg)](https://www.npmjs.com/package/@imperialbower/bowery)
 [![Build and Test](https://github.com/ImperialBower/bowery/actions/workflows/ci.yaml/badge.svg)](https://github.com/ImperialBower/bowery/actions/workflows/ci.yaml)
 [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.0-4baaaa.svg)](CODE_OF_CONDUCT.md)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE-MIT)
@@ -20,18 +21,61 @@ crate builds two ways: an rlib kernel (config, check, game, frame, SVG
 drawing) and, behind a `wasm` feature, the browser element. The design is
 bower's [EPIC-20](https://github.com/ImperialBower/bower/blob/main/docs/EPIC-20_Bowery.md).
 
-This repository is freshly scaffolded: the crate holds no table code yet.
+## In a web page
 
-## How to use
+```html
+<script type="module" src="https://cdn.jsdelivr.net/npm/@imperialbower/bowery@0.1.0/bowery.js"></script>
+
+<bowery-table>
+  <script type="application/yaml">
+mode: play
+seat: 0
+table: { stakes: { small_blind: 50.0, big_blind: 100.0 } }
+players:
+  - { seat: 0, name: You, stack: 10000 }
+  - { seat: 1, stack: 10000, bot: tight_aggressive }
+  - { seat: 2, stack: 10000, bot: maniac }
+  </script>
+  <p>A poker table: it needs JavaScript.</p>   <!-- the fallback, kept until the table is ready -->
+</bowery-table>
+```
+
+The element loads its wasm from beside `bowery.js` (or from its `base`
+attribute) and asks nothing of any other origin. To serve it yourself, take
+`bowery-vX.Y.Z.tar.gz` from a [release](https://github.com/ImperialBower/bowery/releases):
+one flat directory whose files `MANIFEST.sha256` lists. A config can also
+come from a file (`src="table.yaml"`), and `mode: replay` or
+`mode: interactive` take a recorded pkcore hand history as `hand:`. The
+config's fields are documented on [`Config`](https://docs.rs/bowery/latest/bowery/config/struct.Config.html).
+
+## In Rust
+
+```rust
+use bowery::check::check;
+use bowery::config::{Config, View};
+use bowery::draw::{Theme, svg};
+use bowery::game::Game;
+
+let config = Config::from_yaml(yaml)?;
+let game = Game::new(check(&config).map_err(|problems| problems[0].clone())?)?;
+let picture = svg(&game.frame(View::All), config.layout, 680, Theme::Light);
+```
+
+`cargo run --example bowery-still -- fixtures/the_hand.yaml --layout spotlight --at river`
+prints The Hand on the river as one SVG.
+
+## Develop
 
 ```sh
 git clone https://github.com/ImperialBower/bowery.git
 cd bowery
-make install-tools   # cargo-deny, cargo-audit, cargo-watch
-make ayce            # the full gate: clean, fmt, build, test, lint, security-scan, docs
+make install-tools   # the wasm target, cargo-deny, cargo-audit, cargo-watch
+make ayce            # the full gate, the wasm size gate and the Playwright proof included
+make serve           # the demo at http://localhost:8000
 ```
 
-`make help` lists every target.
+`make ayce` also needs `wasm-pack` and Node (see `.tool-versions`). `make help`
+lists every target.
 
 ## What's in the box
 

package/bowery.css

@@ -0,0 +1,73 @@
+/* <bowery-table>: loaded into the element's shadow root, so nothing here
+   reaches the page. Black on white, 2 px strokes, the system monospace;
+   :host([data-dark]) when the page is dark. No fonts, no url(). */
+:host {
+  --bowery-bg: #ffffff;
+  --bowery-fg: #000000;
+  --bowery-to-act: #ffe94d;
+  display: block;
+  max-width: 100%;
+  border: 2px solid var(--bowery-fg);
+  background: var(--bowery-bg);
+  color: var(--bowery-fg);
+  font-family: ui-monospace, Menlo, Consolas, monospace;
+  font-size: 13px;
+}
+:host([data-dark]) {
+  --bowery-bg: #111111;
+  --bowery-fg: #f2f2f2;
+  --bowery-to-act: #5e5200;
+}
+:host(:focus-visible) {
+  outline: 3px solid var(--bowery-to-act);
+  outline-offset: 2px;
+}
+.stage svg {
+  display: block;
+  max-width: 100%;
+  height: auto;
+}
+.bar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  align-items: center;
+  border-top: 2px solid var(--bowery-fg);
+  padding: 6px 8px;
+}
+.bar:empty {
+  display: none;
+}
+button,
+select,
+input {
+  font: inherit;
+  color: var(--bowery-fg);
+  background: var(--bowery-bg);
+  border: 2px solid var(--bowery-fg);
+  border-radius: 0;
+  padding: 2px 8px;
+}
+button {
+  font-weight: 700;
+  cursor: pointer;
+}
+button:hover,
+button:focus-visible {
+  background: var(--bowery-fg);
+  color: var(--bowery-bg);
+}
+input[type='number'] {
+  width: 9ch;
+}
+.readout {
+  flex: 1;
+  min-width: 8ch;
+}
+.status {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+}

package/bowery.js

@@ -0,0 +1,413 @@
+// <bowery-table>: one poker table control, configured not compiled.
+//
+// Usage:
+//   <script type="module" src="bowery/bowery.js"></script>
+//   <bowery-table base="bowery/">
+//     <script type="application/yaml">mode: replay …</script>
+//     <svg …>the fallback picture</svg>
+//   </bowery-table>
+//
+// Nothing loads until the element is within a screen of the viewport. The
+// first element instantiates the wasm module; every later one reuses it and
+// builds its own BoweryTable, so tables on a page are independent. The
+// fallback picture stays if the config, the import or the init fails, and a
+// config's problems are printed under it. Every request goes to `base`
+// (default: this module's directory) or to `src`, both on the page's origin.
+// Contract: bower docs/EPIC-20_Bowery.md § <bowery-table>.
+
+const HERE = new URL('.', import.meta.url);
+const GLUE = 'bowery_wasm.js';
+const WASM = 'bowery_wasm_bg.wasm';
+const STYLE = 'bowery.css';
+
+/** One import and one init per base, shared by every element. */
+const modules = new Map();
+
+function loadModule(base) {
+  const key = base.href;
+  if (!modules.has(key)) {
+    modules.set(
+      key,
+      import(new URL(GLUE, base).href).then(async (glue) => {
+        await glue.default({ module_or_path: new URL(WASM, base) });
+        return glue;
+      }),
+    );
+  }
+  return modules.get(key);
+}
+
+/** mdBook's dark themes, or the system's dark preference. */
+function prefersDark() {
+  const html = document.documentElement.classList;
+  if (html.contains('coal') || html.contains('navy') || html.contains('ayu')) return true;
+  if (html.contains('light') || html.contains('rust')) return false;
+  return window.matchMedia('(prefers-color-scheme: dark)').matches;
+}
+
+/** A button; `name` is its accessible name when the label is a symbol. */
+function button(label, onClick, name) {
+  const element = document.createElement('button');
+  element.type = 'button';
+  element.textContent = label;
+  if (name) {
+    element.setAttribute('aria-label', name);
+    element.title = name;
+  }
+  element.addEventListener('click', onClick);
+  return element;
+}
+
+class BoweryTableElement extends HTMLElement {
+  static get observedAttributes() {
+    return ['src'];
+  }
+
+  connectedCallback() {
+    if (this._wired) return;
+    this._wired = true;
+    this._base = new URL(this.getAttribute('base') || HERE.href, document.baseURI);
+    if (!this.hasAttribute('tabindex')) this.tabIndex = 0;
+    const observer = new IntersectionObserver(
+      (entries) => {
+        if (entries.some((entry) => entry.isIntersecting)) {
+          observer.disconnect();
+          this._start();
+        }
+      },
+      { rootMargin: '100% 0px' },
+    );
+    observer.observe(this);
+  }
+
+  disconnectedCallback() {
+    clearTimeout(this._timer);
+    this._resize?.disconnect();
+  }
+
+  attributeChangedCallback(name, before, after) {
+    if (name === 'src' && this._table && before !== after) this._reload();
+  }
+
+  async _reload() {
+    clearTimeout(this._timer);
+    this._table?.free?.();
+    this._table = null;
+    await this._start();
+  }
+
+  async _start() {
+    if (location.protocol === 'file:') {
+      this._fail('this table needs a served page');
+      return;
+    }
+    let yaml;
+    try {
+      yaml = await this._config();
+    } catch (error) {
+      this._fail(`the config did not load: ${error.message}`);
+      return;
+    }
+    let glue;
+    try {
+      glue = await loadModule(this._base);
+    } catch (error) {
+      this._fail('the table did not load');
+      this._emit('bowery:error', { message: String(error) });
+      return;
+    }
+    try {
+      this._table = new glue.BoweryTable(yaml);
+    } catch (error) {
+      this._problems(String(error));
+      return;
+    }
+    this._version = glue.BoweryTable.version();
+    this._mount();
+    this._render();
+    this._emit('bowery:ready', { version: this._version });
+    this._pace();
+  }
+
+  /** The inline YAML, or the file `src` names (same origin only). */
+  async _config() {
+    const src = this.getAttribute('src');
+    if (src) {
+      const url = new URL(src, document.baseURI);
+      if (url.origin !== location.origin) throw new Error('src must be on this page\'s origin');
+      const response = await fetch(url);
+      if (!response.ok) throw new Error(`${response.status} ${response.statusText}`);
+      return response.text();
+    }
+    const script = this.querySelector('script[type="application/yaml"]');
+    if (!script) throw new Error('no <script type="application/yaml"> and no src');
+    return script.textContent;
+  }
+
+  /** The fallback stays; a note goes under it. */
+  _fail(message) {
+    const note = document.createElement('p');
+    note.className = 'bowery-note';
+    note.textContent = message;
+    this.append(note);
+  }
+
+  /** The fallback stays; the config's problems go under it. */
+  _problems(json) {
+    let lines;
+    try {
+      lines = JSON.parse(json).map((problem) => (problem.path ? `${problem.path}: ${problem.message}` : problem.message));
+    } catch {
+      lines = [json];
+    }
+    const pre = document.createElement('pre');
+    pre.className = 'bowery-problems';
+    pre.textContent = lines.join('\n');
+    this.append(pre);
+    this._emit('bowery:error', { problems: lines });
+  }
+
+  _mount() {
+    const root = this.shadowRoot || this.attachShadow({ mode: 'open' });
+    root.replaceChildren();
+    // A custom element is inline until bowery.css arrives; block at once, so
+    // the first frame is measured and drawn at the element's real width.
+    const block = document.createElement('style');
+    block.textContent = ':host { display: block; }';
+    const style = document.createElement('link');
+    style.rel = 'stylesheet';
+    style.href = new URL(STYLE, this._base).href;
+    this._stage = document.createElement('div');
+    this._stage.className = 'stage';
+    this._bar = document.createElement('div');
+    this._bar.className = 'bar';
+    this._status = document.createElement('div');
+    this._status.className = 'status';
+    this._status.setAttribute('aria-live', 'polite');
+    root.append(block, style, this._stage, this._bar, this._status);
+
+    this._width = this.clientWidth || 680;
+    this._resize = new ResizeObserver((entries) => {
+      const width = Math.round(entries[0].contentRect.width);
+      if (width > 0 && width !== this._width) {
+        this._width = width;
+        this._draw();
+      }
+    });
+    this._resize.observe(this);
+    window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', () => this._render());
+    new MutationObserver(() => this._render()).observe(document.documentElement, {
+      attributes: true,
+      attributeFilter: ['class'],
+    });
+    this.addEventListener('keydown', (event) => this._key(event));
+  }
+
+  _state() {
+    return JSON.parse(this._table.state());
+  }
+
+  _draw() {
+    const dark = prefersDark();
+    this.toggleAttribute('data-dark', dark);
+    // The SVG is bowery's own renderer's: every name and caption from the
+    // config is XML-escaped there (tests/draw.rs draw__names_are_escaped),
+    // and it holds no script.
+    this._stage.innerHTML = this._table.svg(this._width, dark);
+  }
+
+  _render() {
+    if (!this._table) return;
+    const before = this._last;
+    const state = this._state();
+    this._last = state;
+    this._draw();
+    this._controls(state);
+    this._status.textContent = state.caption;
+    this._emit('bowery:moment', { moment: state.moment - 1, moments: state.moments });
+    if (state.record === 'off' && before?.record !== 'off') this._emit('bowery:off-record', { since: state.since });
+    if (state.hand_over && !before?.hand_over) this._emit('bowery:hand-over', { result: state.result });
+  }
+
+  /** The bar under the table, rebuilt for the state; focus stays put. */
+  _controls(state) {
+    const focused = this.shadowRoot.activeElement?.dataset?.control;
+    const bar = this._bar;
+    bar.replaceChildren();
+    const add = (element, control) => {
+      element.dataset.control = control;
+      bar.append(element);
+      return element;
+    };
+    if (state.controls.seek) {
+      add(button('⏮', () => this._seek(0), 'first'), 'first');
+      add(button('◀', () => this._seek(state.moment - 2), 'back'), 'back');
+      add(button('▶', () => this._step(), 'next'), 'next');
+      add(button('⏭', () => this._seek(state.moments - 1), 'last'), 'last');
+      const readout = document.createElement('span');
+      readout.className = 'readout';
+      readout.textContent = `${state.moment} / ${state.moments}`;
+      add(readout, 'readout');
+    }
+    if (state.controls.take_seat && !state.hand_over) {
+      const select = document.createElement('select');
+      select.setAttribute('aria-label', 'seat');
+      for (const seat of state.seats.filter((seat) => seat.live)) {
+        const option = document.createElement('option');
+        option.value = seat.seat;
+        option.textContent = seat.name;
+        option.selected = seat.seat === state.reader;
+        select.append(option);
+      }
+      add(select, 'seat');
+      add(button('Take this seat', () => this._take(Number(select.value))), 'take');
+    }
+    if (state.controls.back_to_record) add(button('Back to the record', () => this._back()), 'back-to-record');
+    // Empty unless the reader can act at this moment.
+    if (state.legal.length > 0) this._actions(state, add);
+    if (state.controls.next_hand) add(button('Next hand', () => this._next()), 'next-hand');
+    if (state.controls.shuffle) add(button('Shuffle', () => this._shuffle()), 'shuffle');
+    if (state.controls.view) {
+      add(button(`👁 ${state.view}`, () => this._toggleView(state.view)), 'view');
+    }
+    if (state.controls.layout) {
+      add(button(`▦ ${state.layout}`, () => this._toggleLayout(state.layout)), 'layout');
+    }
+    const again = focused && bar.querySelector(`[data-control="${focused}"]`);
+    if (again) again.focus();
+  }
+
+  /** The reader's legal actions as buttons; a size box for bet or raise. */
+  _actions(state, add) {
+    for (const legal of state.legal) {
+      if (legal.action === 'bet' || legal.action === 'raise') {
+        const size = document.createElement('input');
+        size.type = 'number';
+        size.min = legal.min;
+        size.max = legal.max;
+        size.value = legal.min;
+        size.setAttribute('aria-label', `${legal.action} to`);
+        add(size, `${legal.action}-size`);
+        add(
+          button(legal.action === 'bet' ? 'Bet' : 'Raise to', () =>
+            this._act({ action: legal.action, amount: Number(size.value) }),
+          ),
+          legal.action,
+        );
+      } else {
+        const label = {
+          fold: 'Fold',
+          check: 'Check',
+          call: `Call ${legal.amount?.toLocaleString('en-US') ?? ''}`.trim(),
+          all_in: 'All in',
+        }[legal.action];
+        add(button(label, () => this._act({ action: legal.action })), legal.action);
+      }
+    }
+  }
+
+  _key(event) {
+    const state = this._last;
+    if (!state?.controls.seek || event.target !== this) return;
+    const moves = {
+      ArrowLeft: state.moment - 2,
+      ArrowRight: state.moment,
+      Home: 0,
+      End: state.moments - 1,
+    };
+    if (event.key in moves) {
+      event.preventDefault();
+      this._seek(moves[event.key]);
+    }
+  }
+
+  _seek(index) {
+    clearTimeout(this._timer);
+    this._table.seek(Math.max(0, index));
+    this._render();
+  }
+
+  /** ▶: one moment on; on the record it stops at the reader's turn. */
+  _step() {
+    this._try(() => this._table.advance());
+    this._pace();
+  }
+
+  _take(seat) {
+    this._try(() => this._table.take_seat(seat));
+  }
+
+  _back() {
+    clearTimeout(this._timer);
+    this._table.back_to_record();
+    this._render();
+  }
+
+  _act(action) {
+    this._try(() => this._table.act(JSON.stringify(action)));
+    this._pace();
+  }
+
+  _next() {
+    this._try(() => this._table.next_hand());
+    this._pace();
+  }
+
+  _shuffle() {
+    clearTimeout(this._timer);
+    this._try(() => this._table.shuffle((Math.random() * 0xffffffff) >>> 0));
+    this._pace();
+  }
+
+  _toggleView(view) {
+    this._table.set_view(view === 'all' ? 'seat' : 'all');
+    this._render();
+  }
+
+  _toggleLayout(layout) {
+    const order = ['ring', 'spotlight', 'ledger'];
+    this._table.set_layout(order[(order.indexOf(layout) + 1) % order.length]);
+    this._render();
+  }
+
+  _try(move) {
+    try {
+      move();
+    } catch (error) {
+      this._status.textContent = String(error);
+      this._emit('bowery:error', { message: String(error) });
+    }
+    this._render();
+  }
+
+  /**
+   * Off the record and in play, bots and deals go on by themselves, one
+   * moment per `delay_ms`, while the latest moment is on screen and it is
+   * not the reader's turn.
+   */
+  _pace() {
+    clearTimeout(this._timer);
+    const state = this._state();
+    const live = state.mode === 'play' || state.record === 'off';
+    if (!live || state.hand_over || state.moment !== state.moments) return;
+    this._timer = setTimeout(() => {
+      let answer;
+      try {
+        answer = this._table.advance();
+      } catch (error) {
+        this._emit('bowery:error', { message: String(error) });
+        return;
+      }
+      this._render();
+      if (answer === 'acted' || answer === 'dealt') this._pace();
+    }, state.delay_ms);
+  }
+
+  _emit(name, detail) {
+    this.dispatchEvent(new CustomEvent(name, { detail, bubbles: true, composed: true }));
+  }
+}
+
+if (!customElements.get('bowery-table')) customElements.define('bowery-table', BoweryTableElement);
+
+export { BoweryTableElement };

package/bowery_wasm.js

@@ -0,0 +1,609 @@
+/**
+ * One element's table, for JavaScript.
+ *
+ * # Examples
+ *
+ * ```
+ * use bowery::wasm::BoweryTable;
+ *
+ * let table = BoweryTable::new("
+ * mode: play
+ * table: { stakes: { small_blind: 1.0, big_blind: 2.0 } }
+ * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+ * ").unwrap();
+ * assert!(table.state().contains(r#""mode":"play""#));
+ * ```
+ */
+export class BoweryTable {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        BoweryTableFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_bowerytable_free(ptr, 0);
+    }
+    /**
+     * The reader acts: `{"action":"raise","amount":600}`.
+     *
+     * # Errors
+     *
+     * The JSON does not read, or the game refuses the action.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let mut table = BoweryTable::new("
+     * mode: play
+     * table: { button: 0, stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * assert!(table.act(r#"{"action":"call"}"#).is_ok());
+     * ```
+     * @param {string} action_json
+     */
+    act(action_json) {
+        const ptr0 = passStringToWasm0(action_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.bowerytable_act(this.__wbg_ptr, ptr0, len0);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * One step: `"acted"`, `"dealt"`, `"waiting"` or `"over"`.
+     *
+     * # Errors
+     *
+     * The engine failed.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let mut table = BoweryTable::new("
+     * mode: play
+     * table: { button: 0, stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * assert_eq!("waiting", table.advance().unwrap());
+     * ```
+     * @returns {string}
+     */
+    advance() {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const ret = wasm.bowerytable_advance(this.__wbg_ptr);
+            var ptr1 = ret[0];
+            var len1 = ret[1];
+            if (ret[3]) {
+                ptr1 = 0; len1 = 0;
+                throw takeFromExternrefTable0(ret[2]);
+            }
+            deferred2_0 = ptr1;
+            deferred2_1 = len1;
+            return getStringFromWasm0(ptr1, len1);
+        } finally {
+            wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        }
+    }
+    /**
+     * Back to the record at the takeover moment.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let mut table = BoweryTable::new("
+     * mode: play
+     * table: { stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * table.back_to_record();
+     * assert!(table.state().contains(r#""record":"none""#));
+     * ```
+     */
+    back_to_record() {
+        wasm.bowerytable_back_to_record(this.__wbg_ptr);
+    }
+    /**
+     * Reads, checks and builds a table from a YAML config.
+     *
+     * # Errors
+     *
+     * The config's problems as a JSON string (see
+     * [`crate::element::problems_json`]).
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let table = BoweryTable::new("
+     * mode: play
+     * table: { stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ");
+     * assert!(table.is_ok());
+     * ```
+     * @param {string} config_yaml
+     */
+    constructor(config_yaml) {
+        const ptr0 = passStringToWasm0(config_yaml, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.bowerytable_new(ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0];
+        BoweryTableFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * Play: deals the next hand.
+     *
+     * # Errors
+     *
+     * Not play mode, the hand is not over, or the table is broken.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let mut table = BoweryTable::new("
+     * mode: play
+     * table: { button: 0, stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * table.act(r#"{"action":"fold"}"#).unwrap();
+     * while table.advance().unwrap() != "over" {}
+     * assert!(table.next_hand().is_ok());
+     * ```
+     */
+    next_hand() {
+        const ret = wasm.bowerytable_next_hand(this.__wbg_ptr);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Moves to moment `index`, from 0; past the end, to the last.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let mut table = BoweryTable::new("
+     * mode: play
+     * table: { stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * table.seek(0);
+     * assert!(table.state().contains(r#""moment":1"#));
+     * ```
+     * @param {number} index
+     */
+    seek(index) {
+        wasm.bowerytable_seek(this.__wbg_ptr, index);
+    }
+    /**
+     * Draws in `layout` from now on: `ring`, `spotlight` or `ledger`.
+     *
+     * # Errors
+     *
+     * Any other name.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let mut table = BoweryTable::new("
+     * mode: play
+     * table: { stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * assert!(table.set_layout("ledger").is_ok());
+     * ```
+     * @param {string} layout
+     */
+    set_layout(layout) {
+        const ptr0 = passStringToWasm0(layout, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.bowerytable_set_layout(this.__wbg_ptr, ptr0, len0);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Draws in `view` from now on: `all` or `seat`.
+     *
+     * # Errors
+     *
+     * Any other name.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let mut table = BoweryTable::new("
+     * mode: play
+     * table: { stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * assert!(table.set_view("all").is_ok());
+     * ```
+     * @param {string} view
+     */
+    set_view(view) {
+        const ptr0 = passStringToWasm0(view, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.bowerytable_set_view(this.__wbg_ptr, ptr0, len0);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Play: a new game seeded with `seed`.
+     *
+     * # Errors
+     *
+     * Not play mode.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let mut table = BoweryTable::new("
+     * mode: play
+     * table: { stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * assert!(table.shuffle(9).is_ok());
+     * ```
+     * @param {number} seed
+     */
+    shuffle(seed) {
+        const ret = wasm.bowerytable_shuffle(this.__wbg_ptr, seed);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * The controls' state as JSON (see [`crate::element::State`]).
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let table = BoweryTable::new("
+     * mode: play
+     * table: { stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * assert!(table.state().contains(r#""moment":1"#));
+     * ```
+     * @returns {string}
+     */
+    state() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.bowerytable_state(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * The table on screen as SVG, `width` pixels wide, dark or light.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let table = BoweryTable::new("
+     * mode: play
+     * table: { stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     * players: [ { seat: 0, stack: 200 }, { seat: 1, stack: 200, bot: abc } ]
+     * ").unwrap();
+     * assert!(table.svg(400, true).contains(r#"width="400""#));
+     * ```
+     * @param {number} width
+     * @param {boolean} dark
+     * @returns {string}
+     */
+    svg(width, dark) {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.bowerytable_svg(this.__wbg_ptr, width, dark);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * The reader takes `seat` (interactive).
+     *
+     * # Errors
+     *
+     * The game's reason, as a string.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * let mut table = BoweryTable::new("
+     * mode: interactive
+     * hand:
+     *   hand: { id: ex, game: holdem }
+     *   table: { seats: 2, button: 0, stakes: { small_blind: 1.0, big_blind: 2.0 } }
+     *   players: [ { seat: 0, name: A, stack: 100.0 }, { seat: 1, name: B, stack: 100.0 } ]
+     *   streets: { preflop: { actions: [ { seat: 0, action: fold } ] } }
+     * ").unwrap();
+     * assert!(table.take_seat(0).is_ok());
+     * ```
+     * @param {number} seat
+     */
+    take_seat(seat) {
+        const ret = wasm.bowerytable_take_seat(this.__wbg_ptr, seat);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * This crate's version.
+     *
+     * # Examples
+     *
+     * ```
+     * use bowery::wasm::BoweryTable;
+     *
+     * assert_eq!(env!("CARGO_PKG_VERSION"), BoweryTable::version());
+     * ```
+     * @returns {string}
+     */
+    static version() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.bowerytable_version();
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
+}
+if (Symbol.dispose) BoweryTable.prototype[Symbol.dispose] = BoweryTable.prototype.free;
+function __wbg_get_imports() {
+    const import0 = {
+        __proto__: null,
+        __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
+            throw new Error(getStringFromWasm0(arg0, arg1));
+        },
+        __wbindgen_generic_0000000000000001: function(arg0, arg1) {
+            // Cast intrinsic for `Ref(String) -> Externref`.
+            const ret = getStringFromWasm0(arg0, arg1);
+            return ret;
+        },
+        __wbindgen_init_externref_table: function() {
+            const table = wasm.__wbindgen_externrefs;
+            const offset = table.grow(4);
+            table.set(0, undefined);
+            table.set(offset + 0, undefined);
+            table.set(offset + 1, null);
+            table.set(offset + 2, true);
+            table.set(offset + 3, false);
+        },
+    };
+    return {
+        __proto__: null,
+        "./bowery_wasm_bg.js": import0,
+    };
+}
+
+const BoweryTableFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_bowerytable_free(ptr, 1));
+
+function getStringFromWasm0(ptr, len) {
+    return decodeText(ptr >>> 0, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function passStringToWasm0(arg, malloc, realloc) {
+    if (realloc === undefined) {
+        const buf = cachedTextEncoder.encode(arg);
+        const ptr = malloc(buf.length, 1) >>> 0;
+        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
+        WASM_VECTOR_LEN = buf.length;
+        return ptr;
+    }
+
+    let len = arg.length;
+    let ptr = malloc(len, 1) >>> 0;
+
+    const mem = getUint8ArrayMemory0();
+
+    let offset = 0;
+
+    for (; offset < len; offset++) {
+        const code = arg.charCodeAt(offset);
+        if (code > 0x7F) break;
+        mem[ptr + offset] = code;
+    }
+    if (offset !== len) {
+        if (offset !== 0) {
+            arg = arg.slice(offset);
+        }
+        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
+        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
+        const ret = cachedTextEncoder.encodeInto(arg, view);
+
+        offset += ret.written;
+        ptr = realloc(ptr, len, offset, 1) >>> 0;
+    }
+
+    WASM_VECTOR_LEN = offset;
+    return ptr;
+}
+
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+const MAX_SAFARI_DECODE_BYTES = 2146435072;
+let numBytesDecoded = 0;
+function decodeText(ptr, len) {
+    numBytesDecoded += len;
+    if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+        cachedTextDecoder.decode();
+        numBytesDecoded = len;
+    }
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+const cachedTextEncoder = new TextEncoder();
+
+if (!('encodeInto' in cachedTextEncoder)) {
+    cachedTextEncoder.encodeInto = function (arg, view) {
+        const buf = cachedTextEncoder.encode(arg);
+        view.set(buf);
+        return {
+            read: arg.length,
+            written: buf.length
+        };
+    };
+}
+
+let WASM_VECTOR_LEN = 0;
+
+let wasmModule, wasmInstance, wasm;
+function __wbg_finalize_init(instance, module) {
+    wasmInstance = instance;
+    wasm = instance.exports;
+    wasmModule = module;
+    cachedUint8ArrayMemory0 = null;
+    wasm.__wbindgen_start();
+    return wasm;
+}
+
+async function __wbg_load(module, imports) {
+    if (typeof Response === 'function' && module instanceof Response) {
+        if (!module.ok) {
+            throw new Error(`failed to fetch Wasm: ${module.status} ${module.statusText} fetching '${module.url}'`);
+        }
+
+        if (typeof WebAssembly.instantiateStreaming === 'function') {
+            try {
+                return await WebAssembly.instantiateStreaming(module, imports);
+            } catch (e) {
+                const validResponse = expectedResponseType(module.type);
+
+                if (validResponse && module.headers.get('Content-Type') !== 'application/wasm') {
+                    console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);
+
+                } else { throw e; }
+            }
+        }
+
+        const bytes = await module.arrayBuffer();
+        return await WebAssembly.instantiate(bytes, imports);
+    } else {
+        const instance = await WebAssembly.instantiate(module, imports);
+
+        if (instance instanceof WebAssembly.Instance) {
+            return { instance, module };
+        } else {
+            return instance;
+        }
+    }
+
+    function expectedResponseType(type) {
+        switch (type) {
+            case 'basic': case 'cors': case 'default': return true;
+        }
+        return false;
+    }
+}
+
+function initSync(module) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (module !== undefined) {
+        if (Object.getPrototypeOf(module) === Object.prototype) {
+            ({module} = module)
+        } else {
+            console.warn('using deprecated parameters for `initSync()`; pass a single object instead')
+        }
+    }
+
+    const imports = __wbg_get_imports();
+    if (!(module instanceof WebAssembly.Module)) {
+        module = new WebAssembly.Module(module);
+    }
+    const instance = new WebAssembly.Instance(module, imports);
+    return __wbg_finalize_init(instance, module);
+}
+
+async function __wbg_init(module_or_path) {
+    if (wasm !== undefined) return wasm;
+
+
+    if (module_or_path !== undefined) {
+        if (Object.getPrototypeOf(module_or_path) === Object.prototype) {
+            ({module_or_path} = module_or_path)
+        } else {
+            console.warn('using deprecated parameters for the initialization function; pass a single object instead')
+        }
+    }
+
+    if (module_or_path === undefined) {
+        module_or_path = new URL('bowery_wasm_bg.wasm', import.meta.url);
+    }
+    const imports = __wbg_get_imports();
+
+    if (typeof module_or_path === 'string' || (typeof Request === 'function' && module_or_path instanceof Request) || (typeof URL === 'function' && module_or_path instanceof URL)) {
+        module_or_path = fetch(module_or_path);
+    }
+
+    const { instance, module } = await __wbg_load(await module_or_path, imports);
+
+    return __wbg_finalize_init(instance, module);
+}
+
+export { initSync, __wbg_init as default };

package/package.json

@@ -1,8 +1,30 @@
 {
   "name": "@imperialbower/bowery",
-  "version": "0.0.0",
-  "description": "One poker table control, configured not compiled: <bowery-table>. Placeholder; the element ships in 0.1.0.",
+  "version": "0.1.0",
+  "description": "One poker table control, configured not compiled: <bowery-table>.",
   "license": "MIT OR Apache-2.0",
-  "repository": { "type": "git", "url": "git+https://github.com/ImperialBower/bowery.git" },
-  "files": ["README.md", "LICENSE-MIT", "LICENSE-APACHE"]
+  "type": "module",
+  "main": "bowery.js",
+  "exports": {
+    ".": "./bowery.js",
+    "./bowery.css": "./bowery.css"
+  },
+  "files": [
+    "bowery.js",
+    "bowery.css",
+    "bowery_wasm.js",
+    "bowery_wasm_bg.wasm",
+    "LICENSE-MIT",
+    "LICENSE-APACHE",
+    "MANIFEST.sha256",
+    "README.md"
+  ],
+  "sideEffects": true,
+  "keywords": ["poker", "web-component", "custom-element", "wasm", "svg", "hand-history"],
+  "homepage": "https://github.com/ImperialBower/bowery",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ImperialBower/bowery.git"
+  },
+  "bugs": "https://github.com/ImperialBower/bowery/issues"
 }