@joystyk/arcade 0.0.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 0.2.0
+
+### Minor Changes
+
+- bb095c7: Add shared real-time input, pause, pace records and ghost races, plus a WebGL 2 renderer
+  lifecycle with context recovery and adaptive quality. Launch daily fixed-step simulations
+  from published configs and retain their puzzle identity through saved games.
+
+### Patch Changes
+
+- Updated dependencies [bb095c7]
+- Updated dependencies [bb095c7]
+  - @joystyk/contracts@0.2.0
+  - @joystyk/session@0.2.0
+  - @joystyk/kit@0.2.0
+
+## 0.1.0
+
+Initial shared arcade kit (host policy).

package/README.md

@@ -1,5 +1,24 @@
 # @joystyk/arcade
 
-The first Joystyk library release is not yet available. This placeholder reserves the package name.
+Shared browser helpers for real-time games. It has no Three.js dependency. The platform's
+fixed-step runner remains the authority; these helpers send intentions and draw its snapshots.
 
-Source: https://github.com/joystyk-games/game-libraries
+- `bindInput` maps keys, swipe/tap/drag and standard gamepads to named actions. Printable-key
+  shortcuts follow the player's preference; held actions release on blur and disconnect.
+- `bindHold` gives native buttons pointer, keyboard and switch activation. `bindHoldPad`
+  delegates those events for pads rendered by Gyral; `bindDrag` projects absolute pointer
+  movement for paddles. Both share the owning game’s abort signal.
+- `bindPause` pauses on hide, blur and page hide; explicit resume waits one second. Its
+  injected `after` port makes countdown tests deterministic.
+- `createRecords` stores pace and best score/replay through the game's `GameStorage`.
+  Another rules version discards the replay and retains the score.
+- `createGhost` owns an independent state and RNG. Call `advance(liveTick)` for the ghost view;
+  it never dispatches to the live runner. Inputs use the runner's zero-based tick convention.
+- `mountArcade` combines the Gyral HUD with these helpers. A game supplies its status, input
+  mapping, score and a lazy renderer factory. Daily locks pace and omits ghost races.
+- `createControlDrivers`, `resumeAfter`, `bindPagePause`, `swipeDirection` and the direction
+  maps let existing games adopt the helpers without changing their public controls or rules.
+
+Dispose every returned binding when its game leaves the page. Games import this package from
+`ui/` or `render/`. The design and performance budgets are in
+host policy (Joystyk host reference).

package/dist/game.d.ts

@@ -0,0 +1,33 @@
+import type { AnyFixedStepSimulation, AnyGameSession, Json, PlatformApi } from '@joystyk/contracts';
+import { type InputAction } from './input.js';
+import { type Pace } from './records.js';
+export type ArcadeView = {
+    phase: string;
+    pace: Pace;
+    daily: boolean;
+    course: number;
+};
+export type ArcadeDrawing<View> = {
+    draw(view: View, alpha: number, ghost?: View | null): void;
+    graphics(value: 'auto' | 'low' | 'medium' | 'high'): void;
+    dispose(): void;
+    available?: boolean;
+};
+export type ArcadeGameOptions<View extends ArcadeView> = {
+    gameId: string;
+    title: string;
+    help: string;
+    simulation: AnyFixedStepSimulation;
+    score(view: View): number;
+    status(view: View): string;
+    action(action: InputAction, on: boolean, view: View): readonly Json[];
+    drag?(x: number, y: number): Json;
+    gesture: 'swipe' | 'tap' | 'drag';
+    ghost?: boolean;
+    alignment?: boolean;
+    eventLine?(event: Json, view: View): string | null;
+    render(host: HTMLElement, pause: () => void, announce: (text: string) => void): Promise<ArcadeDrawing<View>>;
+};
+export declare function mountArcade<View extends ArcadeView>(slot: HTMLElement, anySession: AnyGameSession, platform: PlatformApi, o: ArcadeGameOptions<View>): {
+    dispose(): void;
+};

package/dist/game.js

@@ -0,0 +1,334 @@
+import { bindHold, bindInput } from "./input.js";
+import { bindPause } from "./pause.js";
+import { createGhost, createRecords } from "./records.js";
+import { ArcadePanel, panelDrivers } from "./panel.js";
+//#region src/game.ts
+var CSS = `:host{display:block;font:1rem/1.5 system-ui;color:var(--game-ink,CanvasText);container-type:inline-size}*{box-sizing:border-box}[hidden]{display:none!important}.layout{display:grid;gap:1rem;padding:clamp(.75rem,2cqi,1.5rem);max-inline-size:72rem;margin-inline:auto}.viewport{position:relative;block-size:clamp(18rem,65svh,42rem);background:#10232b;border-radius:1rem;overflow:hidden;touch-action:none;outline-offset:4px}.viewport>canvas{display:block;inline-size:100%;block-size:100%}.viewport>p,.viewport>button{position:absolute;inset-inline:1rem;inset-block-start:35%;background:Canvas;color:CanvasText;padding:1rem}.viewport>button{inset-block-start:60%}.viewport>output{position:absolute;inset:0 auto auto 0;background:#000c;color:white;font:12px monospace;padding:.25rem;pointer-events:none}.actions,.pad{display:flex;gap:.5rem;flex-wrap:wrap}.pad{margin-block-start:1rem}.pad[hidden]{display:none}button,select,summary{font:inherit;min-block-size:44px;padding:.55rem .8rem}button,select{border:1px solid currentColor;border-radius:.45rem;color:inherit;background:var(--game-surface,Canvas)}button{cursor:pointer}button:disabled{opacity:.55;cursor:default}button:focus-visible,select:focus-visible,summary:focus-visible,.viewport:focus-visible{outline:3px solid var(--game-accent,currentColor);outline-offset:3px}h2{margin:0;font-size:clamp(1.4rem,4cqi,2rem)}.status{font-variant-numeric:tabular-nums}fieldset{border:0;padding:0;margin-block:1rem}label{display:flex;align-items:center;gap:.5rem;min-block-size:44px}input{inline-size:1.25rem;block-size:1.25rem}summary{cursor:pointer}.pad button{flex:1;touch-action:none;user-select:none}.help{max-inline-size:65ch}@container(width>=52rem){.layout{grid-template-columns:minmax(14rem,.7fr) minmax(0,1.5fr);align-items:start}}`;
+function mountArcade(slot, anySession, platform, o) {
+	const session = anySession;
+	const host = document.createElement("div"), root = host.attachShadow({ mode: "open" }), sheet = new CSSStyleSheet();
+	sheet.replaceSync(CSS);
+	root.adoptedStyleSheets = [sheet];
+	root.innerHTML = "<div class=\"layout\"><div class=\"controls\"></div><section><div class=\"viewport\" tabindex=\"0\" role=\"group\" aria-roledescription=\"game board\"></div><div class=\"pad\"></div><p class=\"help\"></p></section></div>";
+	slot.append(host);
+	const viewport = root.querySelector(".viewport"), pad = root.querySelector(".pad");
+	viewport.setAttribute("aria-label", o.title);
+	root.querySelector(".help").textContent = o.help;
+	const controls = new ArcadePanel();
+	const records = createRecords(platform.storage, o.gameId, o.simulation), listeners = /* @__PURE__ */ new Set();
+	let best = {
+		score: 0,
+		replay: null
+	}, drawing = null, ghost = null, disposed = false, loaded = false, resuming = false, lastTick = -1, lastPhase = "ready", lastPace = session.get().view.pace, lastHud = "", padShown = o.gameId === "tower-stacker" || matchMedia("(pointer:coarse)").matches, tone = false, autoFire = o.gesture === "drag" && matchMedia("(pointer:coarse)").matches, graphics = "auto";
+	const send = (input) => session.dispatch({
+		kind: "input",
+		input
+	});
+	const announce = (text) => platform.announce(text, "polite");
+	const pause = bindPause({
+		pause: () => {
+			for (const action of [
+				"left",
+				"right",
+				"up",
+				"main"
+			]) for (const input of o.action(action, false, session.get().view)) send(input);
+			if (o.drag !== void 0) send(o.drag(0, 0));
+			session.dispatch({ kind: "pause" });
+		},
+		resume: () => {
+			session.dispatch({ kind: "resume" });
+			if (o.gesture === "drag") send({
+				type: "fire",
+				on: autoFire
+			});
+		},
+		announce,
+		changed: (value) => {
+			resuming = value;
+			publish();
+		}
+	});
+	const publish = () => {
+		if (disposed) return;
+		const snapshot = session.get(), v = snapshot.view;
+		const hud = {
+			title: o.title,
+			status: resuming ? "Resuming in one second." : snapshot.paused ? "Paused" : o.status(v),
+			phase: v.phase,
+			paused: snapshot.paused,
+			resuming,
+			pace: v.pace,
+			daily: v.daily,
+			best: Math.max(best.score, o.score(v)),
+			race: o.ghost === true && best.replay !== null,
+			pad: padShown,
+			tone,
+			autoFire,
+			graphics,
+			loaded,
+			alignment: o.alignment === true,
+			shooter: o.gesture === "drag"
+		};
+		const key = JSON.stringify(hud);
+		if (key !== lastHud) {
+			lastHud = key;
+			for (const listener of listeners) listener(hud);
+		}
+		pad.hidden = !padShown && !(o.gesture === "drag" && !autoFire);
+		if (drawing !== null) {
+			const g = ghost?.advance(snapshot.tick);
+			drawing.draw(v, session.alpha(), g ?? null);
+		}
+	};
+	const chooseBest = async (pace) => {
+		const found = await records.best(pace);
+		if (!disposed && session.get().view.pace === pace) {
+			best = found;
+			publish();
+		}
+	};
+	const emit = (action, on) => {
+		if (disposed || !loaded || drawing === null || drawing.available === false) return;
+		const snap = session.get();
+		if (action === "auxiliary") {
+			if (on && o.gesture === "drag") {
+				autoFire = !autoFire;
+				send({
+					type: "fire",
+					on: autoFire
+				});
+				announce(`Automatic fire ${autoFire ? "on" : "off"}.`);
+				publish();
+			}
+			return;
+		}
+		if (action === "pause") {
+			if (on) {
+				if (snap.paused) pause.resume();
+				else pause.pause();
+			}
+			return;
+		}
+		if (snap.paused) {
+			if (snap.view.phase === "ready") session.dispatch({ kind: "resume" });
+			else return;
+		}
+		if (o.gesture === "drag" && action === "main" && snap.view.phase !== "ready" && autoFire) {
+			send({
+				type: "fire",
+				on: true
+			});
+			return;
+		}
+		for (const input of o.action(action, on, snap.view)) send(input);
+	};
+	const stops = [];
+	const perform = (a) => {
+		const snap = session.get(), v = snap.view;
+		switch (a.type) {
+			case "primary":
+				if (v.phase === "ready") {
+					emit("main", true);
+					emit("main", false);
+				} else if (snap.paused) pause.resume();
+				else pause.pause();
+				break;
+			case "pace":
+				if (v.phase === "ready" && !v.daily) {
+					send({
+						type: "pace",
+						pace: a.pace
+					});
+					best = {
+						score: 0,
+						replay: null
+					};
+					ghost = null;
+					records.remember(a.pace).catch(() => {});
+					chooseBest(a.pace);
+				}
+				break;
+			case "race":
+				if (v.phase === "ready" && !v.daily && best.replay !== null) {
+					ghost = createGhost(o.simulation, best.replay);
+					const initial = ghost?.advance(0);
+					if (initial !== void 0) {
+						send({
+							type: "course",
+							course: initial.course
+						});
+						emit("main", true);
+					}
+				}
+				break;
+			case "graphics":
+				graphics = a.value;
+				drawing?.graphics(graphics);
+				platform.storage.set("arcade.graphics", graphics).catch(() => {});
+				break;
+			case "pad":
+				padShown = !padShown;
+				platform.storage.set("arcade.pad", padShown).catch(() => {});
+				break;
+			case "tone":
+				tone = !tone;
+				break;
+			case "fire":
+				autoFire = !autoFire;
+				send({
+					type: "fire",
+					on: autoFire
+				});
+		}
+		publish();
+	};
+	controls.drivers = panelDrivers((emit) => {
+		listeners.add(emit);
+		lastHud = "";
+		publish();
+		return () => listeners.delete(emit);
+	}, perform);
+	root.querySelector(".controls").append(controls);
+	for (const [action, label] of [
+		["left", "Left"],
+		["up", "Forward / Thrust"],
+		["right", "Right"],
+		["down", "Back"],
+		["main", o.gameId === "tower-stacker" ? "Drop" : o.gesture === "drag" ? "Fire" : "Hop"]
+	]) {
+		const button = document.createElement("button");
+		button.type = "button";
+		button.textContent = label;
+		pad.append(button);
+		stops.push(bindHold(button, (on) => emit(action, on)));
+		button.addEventListener("click", (e) => {
+			if (e.detail === 0) {
+				emit(action, true);
+				emit(action, false);
+			}
+		});
+	}
+	stops.push(bindInput({
+		surface: viewport,
+		keys: {
+			arrowup: "up",
+			arrowdown: "down",
+			arrowleft: "left",
+			arrowright: "right",
+			w: "up",
+			s: "down",
+			a: "left",
+			d: "right",
+			" ": "main",
+			enter: "main",
+			f: "auxiliary",
+			p: "pause",
+			escape: "pause"
+		},
+		shortcuts: () => platform.preferences.get().singleKeyShortcuts,
+		emit,
+		announce,
+		gesture: o.gesture,
+		drag: (x, y) => {
+			if (loaded && !session.get().paused && o.drag !== void 0) send(o.drag(x, y));
+		}
+	}));
+	stops.push(session.subscribe((snap) => {
+		const v = snap.view;
+		if (v.pace !== lastPace) {
+			lastPace = v.pace;
+			chooseBest(v.pace);
+		}
+		if (lastPhase === "ready" && v.phase !== "ready") {
+			viewport.focus({ preventScroll: true });
+			if (autoFire) send({
+				type: "fire",
+				on: true
+			});
+		}
+		if (v.phase === "over" && lastPhase !== "over" && !v.daily) {
+			records.record(v.pace, o.score(v), o.ghost === true ? session.replay() : null).then(() => chooseBest(v.pace)).catch(() => {});
+			announce(o.status(v));
+		}
+		lastPhase = v.phase;
+		if (lastTick !== snap.tick) {
+			lastTick = snap.tick;
+			for (const e of snap.events) {
+				const cue = {
+					began: "start",
+					hopped: "move",
+					signal: "warning",
+					milestone: "level",
+					placed: "hit",
+					regrew: "power",
+					missed: "lose",
+					wave: "level",
+					lifeLost: "life",
+					extraLife: "life",
+					droneIn: "warning",
+					ended: "lose"
+				}[e.type];
+				if (cue !== void 0) platform.audio?.play(cue);
+				if (o.alignment && tone && e.type === "aligned") platform.audio?.play("tick");
+				const line = o.eventLine?.(e, v);
+				if (line !== void 0 && line !== null) announce(line);
+				else if ([
+					"wave",
+					"lifeLost",
+					"extraLife",
+					"droneIn",
+					"regrew",
+					"milestone",
+					"signal"
+				].includes(e.type)) announce(o.status(v));
+			}
+		}
+		publish();
+	}));
+	Promise.all([
+		records.pace(),
+		platform.storage.get("arcade.pad").catch(() => null),
+		platform.storage.get("arcade.graphics").catch(() => null)
+	]).then(async ([pace, padValue, quality]) => {
+		if (disposed) return;
+		if (typeof padValue === "boolean") padShown = padValue;
+		if ([
+			"auto",
+			"low",
+			"medium",
+			"high"
+		].includes(String(quality))) graphics = quality;
+		const v = session.get().view;
+		if (!v.daily && v.phase === "ready") send({
+			type: "pace",
+			pace
+		});
+		await chooseBest(v.daily ? "standard" : pace);
+		if (disposed) return;
+		drawing = await o.render(viewport, pause.pause, announce);
+		if (disposed) {
+			drawing.dispose();
+			return;
+		}
+		drawing.graphics(graphics);
+		loaded = true;
+		publish();
+	}).catch(() => {
+		if (!disposed) announce("Game settings could not be loaded.");
+	});
+	if (session.get().view.phase !== "ready" && session.get().view.phase !== "over") pause.pause();
+	publish();
+	return { dispose() {
+		if (disposed) return;
+		disposed = true;
+		for (const stop of stops) stop();
+		pause.dispose();
+		drawing?.dispose();
+		host.remove();
+	} };
+}
+//#endregion
+export { mountArcade };
+
+//# sourceMappingURL=game.js.map

package/dist/game.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.js","names":[],"sources":["../src/game.ts"],"sourcesContent":["import type { AnyFixedStepSimulation, AnyGameSession, Json, PlatformApi, SoundCue } from '@joystyk/contracts';\nimport type { FixedStepRunner } from '@joystyk/session';\nimport { bindHold, bindInput, type InputAction } from './input.ts';\nimport { bindPause } from './pause.ts';\nimport { createGhost, createRecords, type BestRun, type Pace } from './records.ts';\nimport { ArcadePanel, panelDrivers, type Hud, type PanelAction } from './panel.ts';\nexport type ArcadeView = {\n  phase: string;\n  pace: Pace;\n  daily: boolean;\n  course: number;\n};\nexport type ArcadeDrawing<View> = {\n  draw(view: View, alpha: number, ghost?: View | null): void;\n  graphics(value: 'auto' | 'low' | 'medium' | 'high'): void;\n  dispose(): void;\n  available?: boolean;\n};\nexport type ArcadeGameOptions<View extends ArcadeView> = {\n  gameId: string;\n  title: string;\n  help: string;\n  simulation: AnyFixedStepSimulation;\n  score(view: View): number;\n  status(view: View): string;\n  action(action: InputAction, on: boolean, view: View): readonly Json[];\n  drag?(x: number, y: number): Json;\n  gesture: 'swipe' | 'tap' | 'drag';\n  ghost?: boolean;\n  alignment?: boolean;\n  eventLine?(event: Json, view: View): string | null;\n  render(host: HTMLElement, pause: () => void, announce: (text: string) => void): Promise<ArcadeDrawing<View>>;\n};\nconst CSS = `:host{display:block;font:1rem/1.5 system-ui;color:var(--game-ink,CanvasText);container-type:inline-size}*{box-sizing:border-box}[hidden]{display:none!important}.layout{display:grid;gap:1rem;padding:clamp(.75rem,2cqi,1.5rem);max-inline-size:72rem;margin-inline:auto}.viewport{position:relative;block-size:clamp(18rem,65svh,42rem);background:#10232b;border-radius:1rem;overflow:hidden;touch-action:none;outline-offset:4px}.viewport>canvas{display:block;inline-size:100%;block-size:100%}.viewport>p,.viewport>button{position:absolute;inset-inline:1rem;inset-block-start:35%;background:Canvas;color:CanvasText;padding:1rem}.viewport>button{inset-block-start:60%}.viewport>output{position:absolute;inset:0 auto auto 0;background:#000c;color:white;font:12px monospace;padding:.25rem;pointer-events:none}.actions,.pad{display:flex;gap:.5rem;flex-wrap:wrap}.pad{margin-block-start:1rem}.pad[hidden]{display:none}button,select,summary{font:inherit;min-block-size:44px;padding:.55rem .8rem}button,select{border:1px solid currentColor;border-radius:.45rem;color:inherit;background:var(--game-surface,Canvas)}button{cursor:pointer}button:disabled{opacity:.55;cursor:default}button:focus-visible,select:focus-visible,summary:focus-visible,.viewport:focus-visible{outline:3px solid var(--game-accent,currentColor);outline-offset:3px}h2{margin:0;font-size:clamp(1.4rem,4cqi,2rem)}.status{font-variant-numeric:tabular-nums}fieldset{border:0;padding:0;margin-block:1rem}label{display:flex;align-items:center;gap:.5rem;min-block-size:44px}input{inline-size:1.25rem;block-size:1.25rem}summary{cursor:pointer}.pad button{flex:1;touch-action:none;user-select:none}.help{max-inline-size:65ch}@container(width>=52rem){.layout{grid-template-columns:minmax(14rem,.7fr) minmax(0,1.5fr);align-items:start}}`;\nexport function mountArcade<View extends ArcadeView>(\n  slot: HTMLElement,\n  anySession: AnyGameSession,\n  platform: PlatformApi,\n  o: ArcadeGameOptions<View>,\n) {\n  const session = anySession as unknown as FixedStepRunner<\n    Json,\n    View,\n    {\n      type: string;\n    }\n  >;\n  const host = document.createElement('div'),\n    root = host.attachShadow({ mode: 'open' }),\n    sheet = new CSSStyleSheet();\n  sheet.replaceSync(CSS);\n  root.adoptedStyleSheets = [sheet];\n  root.innerHTML =\n    '<div class=\"layout\"><div class=\"controls\"></div><section><div class=\"viewport\" tabindex=\"0\" role=\"group\" aria-roledescription=\"game board\"></div><div class=\"pad\"></div><p class=\"help\"></p></section></div>';\n  slot.append(host);\n  const viewport = root.querySelector<HTMLElement>('.viewport')!,\n    pad = root.querySelector<HTMLElement>('.pad')!;\n  viewport.setAttribute('aria-label', o.title);\n  root.querySelector('.help')!.textContent = o.help;\n  const controls = new ArcadePanel();\n  const records = createRecords(platform.storage, o.gameId, o.simulation),\n    listeners = new Set<(hud: Hud) => void>();\n  let best: BestRun = { score: 0, replay: null },\n    drawing: ArcadeDrawing<View> | null = null,\n    ghost: ReturnType<typeof createGhost> = null,\n    disposed = false,\n    loaded = false,\n    resuming = false,\n    lastTick = -1,\n    lastPhase = 'ready',\n    lastPace: Pace = session.get().view.pace,\n    lastHud = '',\n    padShown = o.gameId === 'tower-stacker' || matchMedia('(pointer:coarse)').matches,\n    tone = false,\n    autoFire = o.gesture === 'drag' && matchMedia('(pointer:coarse)').matches,\n    graphics: 'auto' | 'low' | 'medium' | 'high' = 'auto';\n  const send = (input: Json): void => session.dispatch({ kind: 'input', input });\n  const announce = (text: string): void => platform.announce(text, 'polite');\n  const pause = bindPause({\n    pause: () => {\n      for (const action of ['left', 'right', 'up', 'main'] as const)\n        for (const input of o.action(action, false, session.get().view)) send(input);\n      if (o.drag !== undefined) send(o.drag(0, 0));\n      session.dispatch({ kind: 'pause' });\n    },\n    resume: () => {\n      session.dispatch({ kind: 'resume' });\n      if (o.gesture === 'drag') send({ type: 'fire', on: autoFire });\n    },\n    announce,\n    changed: (value) => {\n      resuming = value;\n      publish();\n    },\n  });\n  const publish = (): void => {\n    if (disposed) return;\n    const snapshot = session.get(),\n      v = snapshot.view;\n    const hud: Hud = {\n      title: o.title,\n      status: resuming ? 'Resuming in one second.' : snapshot.paused ? 'Paused' : o.status(v),\n      phase: v.phase,\n      paused: snapshot.paused,\n      resuming,\n      pace: v.pace,\n      daily: v.daily,\n      best: Math.max(best.score, o.score(v)),\n      race: o.ghost === true && best.replay !== null,\n      pad: padShown,\n      tone,\n      autoFire,\n      graphics,\n      loaded,\n      alignment: o.alignment === true,\n      shooter: o.gesture === 'drag',\n    };\n    const key = JSON.stringify(hud);\n    if (key !== lastHud) {\n      lastHud = key;\n      for (const listener of listeners) listener(hud);\n    }\n    pad.hidden = !padShown && !(o.gesture === 'drag' && !autoFire);\n    if (drawing !== null) {\n      const g = ghost?.advance(snapshot.tick) as View | undefined;\n      drawing.draw(v, session.alpha(), g ?? null);\n    }\n  };\n  const chooseBest = async (pace: Pace): Promise<void> => {\n    const found = await records.best(pace);\n    if (!disposed && session.get().view.pace === pace) {\n      best = found;\n      publish();\n    }\n  };\n  const emit = (action: InputAction, on: boolean): void => {\n    if (disposed || !loaded || drawing === null || drawing.available === false) return;\n    const snap = session.get();\n    if (action === 'auxiliary') {\n      if (on && o.gesture === 'drag') {\n        autoFire = !autoFire;\n        send({ type: 'fire', on: autoFire });\n        announce(`Automatic fire ${autoFire ? 'on' : 'off'}.`);\n        publish();\n      }\n      return;\n    }\n    if (action === 'pause') {\n      if (on) {\n        if (snap.paused) pause.resume();\n        else pause.pause();\n      }\n      return;\n    }\n    if (snap.paused) {\n      if (snap.view.phase === 'ready') session.dispatch({ kind: 'resume' });\n      else return;\n    }\n    if (o.gesture === 'drag' && action === 'main' && snap.view.phase !== 'ready' && autoFire) {\n      send({ type: 'fire', on: true });\n      return;\n    }\n    for (const input of o.action(action, on, snap.view)) send(input);\n  };\n  const stops: (() => void)[] = [];\n  const perform = (a: PanelAction): void => {\n    const snap = session.get(),\n      v = snap.view;\n    switch (a.type) {\n      case 'primary':\n        if (v.phase === 'ready') {\n          emit('main', true);\n          emit('main', false);\n        } else if (snap.paused) pause.resume();\n        else pause.pause();\n        break;\n      case 'pace':\n        if (v.phase === 'ready' && !v.daily) {\n          send({ type: 'pace', pace: a.pace });\n          best = { score: 0, replay: null };\n          ghost = null;\n          void records.remember(a.pace).catch(() => {});\n          void chooseBest(a.pace);\n        }\n        break;\n      case 'race':\n        if (v.phase === 'ready' && !v.daily && best.replay !== null) {\n          ghost = createGhost(o.simulation, best.replay);\n          const initial = ghost?.advance(0) as View | undefined;\n          if (initial !== undefined) {\n            send({ type: 'course', course: initial.course });\n            emit('main', true);\n          }\n        }\n        break;\n      case 'graphics':\n        graphics = a.value;\n        drawing?.graphics(graphics);\n        void platform.storage.set('arcade.graphics', graphics).catch(() => {});\n        break;\n      case 'pad':\n        padShown = !padShown;\n        void platform.storage.set('arcade.pad', padShown).catch(() => {});\n        break;\n      case 'tone':\n        tone = !tone;\n        break;\n      case 'fire':\n        autoFire = !autoFire;\n        send({ type: 'fire', on: autoFire });\n        break;\n    }\n    publish();\n  };\n  controls.drivers = panelDrivers((emit) => {\n    listeners.add(emit);\n    lastHud = '';\n    publish();\n    return () => listeners.delete(emit);\n  }, perform);\n  root.querySelector('.controls')!.append(controls);\n  for (const [action, label] of [\n    ['left', 'Left'],\n    ['up', 'Forward / Thrust'],\n    ['right', 'Right'],\n    ['down', 'Back'],\n    ['main', o.gameId === 'tower-stacker' ? 'Drop' : o.gesture === 'drag' ? 'Fire' : 'Hop'],\n  ] as const) {\n    const button = document.createElement('button');\n    button.type = 'button';\n    button.textContent = label;\n    pad.append(button);\n    stops.push(bindHold(button, (on) => emit(action, on)));\n    button.addEventListener('click', (e) => {\n      if (e.detail === 0) {\n        emit(action, true);\n        emit(action, false);\n      }\n    });\n  }\n  stops.push(\n    bindInput({\n      surface: viewport,\n      keys: {\n        arrowup: 'up',\n        arrowdown: 'down',\n        arrowleft: 'left',\n        arrowright: 'right',\n        w: 'up',\n        s: 'down',\n        a: 'left',\n        d: 'right',\n        ' ': 'main',\n        enter: 'main',\n        f: 'auxiliary',\n        p: 'pause',\n        escape: 'pause',\n      },\n      shortcuts: () => platform.preferences.get().singleKeyShortcuts,\n      emit,\n      announce,\n      gesture: o.gesture,\n      drag: (x, y) => {\n        if (loaded && !session.get().paused && o.drag !== undefined) send(o.drag(x, y));\n      },\n    }),\n  );\n  stops.push(\n    session.subscribe((snap) => {\n      const v = snap.view;\n      if (v.pace !== lastPace) {\n        lastPace = v.pace;\n        void chooseBest(v.pace);\n      }\n      if (lastPhase === 'ready' && v.phase !== 'ready') {\n        viewport.focus({ preventScroll: true });\n        if (autoFire) send({ type: 'fire', on: true });\n      }\n      if (v.phase === 'over' && lastPhase !== 'over' && !v.daily) {\n        void records\n          .record(v.pace, o.score(v), o.ghost === true ? session.replay() : null)\n          .then(() => chooseBest(v.pace))\n          .catch(() => {});\n        announce(o.status(v));\n      }\n      lastPhase = v.phase;\n      if (lastTick !== snap.tick) {\n        lastTick = snap.tick;\n        for (const e of snap.events) {\n          const cue: SoundCue | undefined = (\n            {\n              began: 'start',\n              hopped: 'move',\n              signal: 'warning',\n              milestone: 'level',\n              placed: 'hit',\n              regrew: 'power',\n              missed: 'lose',\n              wave: 'level',\n              lifeLost: 'life',\n              extraLife: 'life',\n              droneIn: 'warning',\n              ended: 'lose',\n            } as Record<string, SoundCue>\n          )[e.type];\n          if (cue !== undefined) platform.audio?.play(cue);\n          if (o.alignment && tone && e.type === 'aligned') platform.audio?.play('tick');\n          const line = o.eventLine?.(e as Json, v);\n          if (line !== undefined && line !== null) announce(line);\n          else if (['wave', 'lifeLost', 'extraLife', 'droneIn', 'regrew', 'milestone', 'signal'].includes(e.type))\n            announce(o.status(v));\n        }\n      }\n      publish();\n    }),\n  );\n  void Promise.all([\n    records.pace(),\n    platform.storage.get('arcade.pad').catch(() => null),\n    platform.storage.get('arcade.graphics').catch(() => null),\n  ])\n    .then(async ([pace, padValue, quality]) => {\n      if (disposed) return;\n      if (typeof padValue === 'boolean') padShown = padValue;\n      if (['auto', 'low', 'medium', 'high'].includes(String(quality))) graphics = quality as typeof graphics;\n      const v = session.get().view;\n      if (!v.daily && v.phase === 'ready') send({ type: 'pace', pace });\n      await chooseBest(v.daily ? 'standard' : pace);\n      if (disposed) return;\n      drawing = await o.render(viewport, pause.pause, announce);\n      if (disposed) {\n        drawing.dispose();\n        return;\n      }\n      drawing.graphics(graphics);\n      loaded = true;\n      publish();\n    })\n    .catch(() => {\n      if (!disposed) announce('Game settings could not be loaded.');\n    });\n  if (session.get().view.phase !== 'ready' && session.get().view.phase !== 'over') pause.pause();\n  publish();\n  return {\n    dispose(): void {\n      if (disposed) return;\n      disposed = true;\n      for (const stop of stops) stop();\n      pause.dispose();\n      drawing?.dispose();\n      host.remove();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { bindInput, bindHold, bindHoldPad, bindDrag, type InputAction, type InputOptions } from './input.js';
+export { bindPause, type PauseOptions } from './pause.js';
+export { PACES, createRecords, createGhost, type Pace, type BestRun } from './records.js';
+export { mountArcade, type ArcadeView, type ArcadeDrawing, type ArcadeGameOptions } from './game.js';
+export { createControlDrivers, resumeAfter, bindPagePause, swipeDirection, SWIPE_THRESHOLD, ARROW_DIRECTIONS, LETTER_DIRECTIONS, } from './legacy.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+import { ARROW_DIRECTIONS, LETTER_DIRECTIONS, SWIPE_THRESHOLD, bindPagePause, createControlDrivers, resumeAfter, swipeDirection } from "./legacy.js";
+import { bindDrag, bindHold, bindHoldPad, bindInput } from "./input.js";
+import { bindPause } from "./pause.js";
+import { PACES, createGhost, createRecords } from "./records.js";
+import { mountArcade } from "./game.js";
+export { ARROW_DIRECTIONS, LETTER_DIRECTIONS, PACES, SWIPE_THRESHOLD, bindDrag, bindHold, bindHoldPad, bindInput, bindPagePause, bindPause, createControlDrivers, createGhost, createRecords, mountArcade, resumeAfter, swipeDirection };

package/dist/input.d.ts

@@ -0,0 +1,28 @@
+/** All sources share the same actions. A held action is released on blur or disconnect. */
+export type InputAction = 'up' | 'down' | 'left' | 'right' | 'main' | 'pause' | 'auxiliary';
+export type InputOptions = {
+    readonly surface: HTMLElement;
+    readonly keys: Readonly<Record<string, InputAction>>;
+    readonly shortcuts: () => boolean;
+    readonly emit: (action: InputAction, held: boolean) => void;
+    readonly announce: (text: string) => void;
+    readonly gesture?: 'swipe' | 'tap' | 'drag';
+    readonly drag?: (x: number, y: number) => void;
+    readonly deadZone?: number;
+    readonly gamepads?: () => readonly (Gamepad | null)[];
+    readonly frame?: (callback: FrameRequestCallback) => number;
+    readonly cancelFrame?: (id: number) => void;
+};
+export declare function bindInput(o: InputOptions): () => void;
+/** Native hold buttons also support keyboard and switch activation. */
+export declare function bindHold(button: HTMLButtonElement, emit: (held: boolean) => void): () => void;
+/** Delegated holds survive Gyral updates that add or replace native pad buttons. */
+export declare function bindHoldPad(root: HTMLElement | ShadowRoot, selector: string, emit: (button: HTMLButtonElement, on: boolean, source: string) => void, signal?: AbortSignal): () => void;
+/** Absolute dragging for paddles; games own projection into their court's units. */
+export declare function bindDrag(surface: HTMLElement, o: {
+    start(event: PointerEvent): boolean | void;
+    move(event: PointerEvent): void;
+    hoverMouse?: boolean;
+    capture?: boolean;
+    primaryOnly?: boolean;
+}, signal?: AbortSignal): () => void;