卫戍协议：盟约 web remake — initial import

Online co-op browser remake of Arknights' Stronghold Protocol: Alliance
(client-simulated combat, official waves/bonds/items/strategies, 3D board,
facing wheel, operator loadout, official emotes, deployment scripts).

public/js/ui/gameActions.js

@@ -0,0 +1,74 @@
+// In-match intents (`g.*`, DESIGN §8.2) with uniform error handling: every request goes through
+// `act()`, which plays a UI sound on success, shows the ERR_TEXT toast on failure and never throws.
+// The UI never mutates state optimistically — it waits for the next m.private / m.public push.
+// `net.request` is looked up at call time so the dev mock harness can stub it.
+
+import { net } from '../net.js';
+import { toastError } from './toasts.js';
+import { audio } from '../audio.js';
+
+const SUCCESS_SFX = {
+  'g.buy': 'buy', 'g.sell': 'sell', 'g.refresh': 'refresh', 'g.freeze': 'freeze', 'g.levelUp': 'levelup',
+  'g.move': 'drop', 'g.equip': 'equip', 'g.art': 'artPlace', 'g.reward': 'pick', 'g.choice': 'pick',
+  'g.band': 'confirm', 'g.bandSkip': 'back', 'g.infoReady': 'ready', 'g.emote': 'emote', 'g.destroy': 'back',
+};
+
+let inflight = 0;
+const busyListeners = new Set();
+const emitBusy = () => { for (const fn of [...busyListeners]) { try { fn(inflight); } catch { /* ignore */ } } };
+
+/** Subscribe to the number of in-flight intents (for subtle busy indicators). */
+export function onBusy(fn) { busyListeners.add(fn); return () => busyListeners.delete(fn); }
+
+/**
+ * Send an intent. Resolves true on `ok`, false on error (already toasted).
+ * @param {string} t
+ * @param {object} [fields]
+ * @param {{ sfx?: string|false, quiet?: boolean }} [opts]
+ * @returns {Promise<boolean>}
+ */
+export async function act(t, fields = {}, opts = {}) {
+  inflight += 1;
+  emitBusy();
+  try {
+    await net.request(t, fields);
+    const s = opts.sfx === undefined ? SUCCESS_SFX[t] : opts.sfx;
+    if (s) audio.sfx(s);
+    return true;
+  } catch (err) {
+    if (!opts.quiet) {
+      toastError(err);
+      audio.sfx('error', { volume: 0.6 });
+    }
+    return false;
+  } finally {
+    inflight = Math.max(0, inflight - 1);
+    emitBusy();
+  }
+}
+
+export const actions = {
+  infoReady: () => act('g.infoReady'),
+  band: (bandId) => act('g.band', { bandId }),
+  bandSkip: () => act('g.bandSkip'),
+  buy: (slot) => act('g.buy', { slot }),
+  refresh: () => act('g.refresh'),
+  freeze: () => act('g.freeze'),
+  levelUp: () => act('g.levelUp'),
+  sell: (uid) => act('g.sell', { uid }),
+  // `dir` (UP|RIGHT|DOWN|LEFT): the direction chosen with the deploy wheel (research 09 §6.1 — g.move / g.art carry it;
+  // the server defaults to RIGHT when absent)
+  move: (uid, to, dir) => act('g.move', dir ? { uid, to, dir } : { uid, to }),
+  // `replaceUid`: the equipped item the replace dialog picked (ui/equipReplace.js) — it is destroyed; absent ⇒ none needed
+  equip: (itemUid, targetUid, replaceUid) => act('g.equip', Number.isInteger(replaceUid) ? { itemUid, targetUid, replaceUid } : { itemUid, targetUid }),
+  art: (itemUid, row, col, dir) => act('g.art', dir ? { itemUid, row, col, dir } : { itemUid, row, col }),
+  destroy: (uid) => act('g.destroy', { uid }),
+  reward: (idx) => act('g.reward', { idx }),
+  choice: (idx) => act('g.choice', { idx }),
+  ready: (ready) => act('g.ready', { ready }, { sfx: ready ? 'ready' : 'back' }),
+  emote: (id) => act('g.emote', { id }, { quiet: true }),
+  watch: (fieldId) => act('g.watch', { fieldId }, { sfx: 'tab' }),
+  autoplay: (on) => act('g.autoplay', { on }),
+  // solo battles only (ui/matchStatus.js pauseAvailable): m.public.paused follows
+  pause: (on) => act('g.pause', { on: !!on }, { sfx: on ? 'click' : 'confirm' }),
+};