@diffenderfer-games/hub 0.0.0-stage → 2.0.0-next.1

package/dist/input.js

@@ -0,0 +1,3 @@
+import { a as isPageInputControl, c as layoutControls, i as parseInputOverrides, l as boxesTouch, n as getInput, o as InputSystem, r as isInputSystem, s as Overlay, t as INPUT_SINGLETON_API, u as controlSize } from "./shared/input.js";
+import { n as isUiStack, r as UI_STACK_VERSION, t as getUiStack } from "./shared/page-stack.js";
+export { INPUT_SINGLETON_API, InputSystem, Overlay, UI_STACK_VERSION, boxesTouch, controlSize, getInput, getUiStack, isInputSystem, isPageInputControl, isUiStack, layoutControls, parseInputOverrides };

package/dist/mp.d.ts

@@ -0,0 +1,4 @@
+import { t as InviteCreated } from "./shared/wire-types.js";
+import { a as JoinInfoEvent, i as InviteResult, n as HubMpApi, r as InviteOptions, t as BusyOptions } from "./shared/multiplayer-types.js";
+import { a as Party, i as LaunchTicket, n as JoinInfo, o as multiplayerForwarder, r as Launch, t as Invite } from "./shared/mp.js";
+export { type BusyOptions, type HubMpApi, type Invite, type InviteCreated, type InviteOptions, type InviteResult, type JoinInfo, type JoinInfoEvent, type Launch, type LaunchTicket, type Party, multiplayerForwarder as mp };

package/dist/mp.js

@@ -0,0 +1 @@
+export { t as mp } from "./shared/mp.js";

package/dist/race.d.ts

@@ -0,0 +1,4 @@
+import { a as RaceResultPlayer, i as RaceRecordPlayer, o as RaceStatusEvent, r as RaceHistory } from "./shared/wire-types.js";
+import { a as RaceHistoryQuery, c as RaceRuntimeApi, i as RaceEvents, l as RaceStart, n as RaceCreateOptions, o as RaceHistoryViewOptions, r as RaceDefinition, s as RaceHudPlace, t as HubRaceApi } from "./shared/race-types.js";
+import { a as RaceStatValue, c as Racer, d as RoomInfo, f as raceForwarder, i as RaceResult, l as RacerResult, n as RaceParams, o as RaceState, r as RaceRecord, s as RaceStats, t as RaceOutcome, u as RacerState } from "./shared/race.js";
+export { type HubRaceApi, type RaceCreateOptions, type RaceDefinition, type RaceEvents, type RaceHistory, type RaceHistoryQuery, type RaceHistoryViewOptions, type RaceHudPlace, type RaceOutcome, type RaceParams, type RaceRecord, type RaceRecordPlayer, type RaceResult, type RaceResultPlayer, type RaceRuntimeApi, type RaceStart, type RaceStatValue, type RaceState, type RaceStats, type RaceStatusEvent, type Racer, type RacerResult, type RacerState, type RoomInfo, raceForwarder as race };

package/dist/race.js

@@ -0,0 +1 @@
+export { t as race } from "./shared/race.js";

package/dist/rooms.d.ts

@@ -0,0 +1,4 @@
+import { c as RoomChatLine, d as RoomStateChange, l as RoomMessage, u as RoomSeat } from "./shared/wire-types.js";
+import { a as RoomEvents, c as RoomSendOptions, i as RoomCreateOptions, l as RoomState, n as HubRoomsApi, o as RoomListOptions, r as JoinOptions, s as RoomSelf, t as HubRoom, u as RoomStateOptions } from "./shared/room-types.js";
+import { n as roomsForwarder, t as RoomInfo } from "./shared/rooms.js";
+export { type HubRoom, type HubRoomsApi, type JoinOptions, type RoomChatLine, type RoomCreateOptions, type RoomEvents, type RoomInfo, type RoomListOptions, type RoomMessage, type RoomSeat, type RoomSelf, type RoomSendOptions, type RoomState, type RoomStateChange, type RoomStateOptions, roomsForwarder as rooms };

package/dist/rooms.js

@@ -0,0 +1 @@
+export { t as rooms } from "./shared/rooms.js";

package/dist/shared/bridge.js

@@ -0,0 +1,209 @@
+import { a as isObject, i as hasMethods, o as readField, r as _defineProperty, t as LEGACY_GLOBAL_NAMES } from "./globals.js";
+//#region src/realtime/hub-link.ts
+/**
+* What the forwarders need from the core client: its error classes (so a
+* runtime rejection is an `instanceof HubError` in the game) and the direct
+* own-server ticket request. The core client links itself at load with
+* {@link linkRealtimeToHub}; until then plain errors with the same fields are
+* used, so a forwarder imported on its own still works.
+*/
+/** Copy the error-body fields of another bundle's error onto a plain `Error`. */
+function copyAsPlainError(error) {
+	if (error instanceof Error) return error;
+	const message = readField(error, "message");
+	const copy = new Error(typeof message === "string" ? message : String(error));
+	for (const key of ["status", "retryAfterMs"]) {
+		const field = readField(error, key);
+		if (typeof field === "number") copy[key] = field;
+	}
+	for (const key of [
+		"code",
+		"reason",
+		"hint"
+	]) {
+		const field = readField(error, key);
+		if (typeof field === "string") copy[key] = field;
+	}
+	return copy;
+}
+let currentLink = {
+	toHubError: copyAsPlainError,
+	createOfflineError(message) {
+		const offline = new Error(message);
+		offline.code = "offline";
+		return offline;
+	},
+	getGameServerTicket: () => Promise.reject(/* @__PURE__ */ new Error("Hub: import @diffenderfer-games/hub to request game-server tickets."))
+};
+/** Called once by the core client so forwarder errors use its classes and tickets use its REST client. */
+function linkRealtimeToHub(link) {
+	currentLink = link;
+}
+/** The link in effect. */
+function hubLink() {
+	return currentLink;
+}
+//#endregion
+//#region src/realtime/runtime-api.ts
+/**
+* The realtime feature version the runtime reports in {@link RealtimeApi.version}.
+* 2 added races; a client feature-detects newer additions with it.
+*/
+const REALTIME_FEATURE_VERSION = 2;
+/**
+* The cross-bundle shape number of the `rt` page singleton (plan §4.4). The
+* runtime registers with it through `claimSingleton`; bump it only when the
+* shape of {@link RealtimeApi} changes incompatibly.
+*/
+const REALTIME_SINGLETON_API = 1;
+/** The window event the runtime fires once it has installed itself. */
+const REALTIME_READY_EVENT = "hub:rt-ready";
+/** The window event the menu fires when the runtime failed to load (its reason is on `window.__HUB_RT_ERROR__`). */
+const REALTIME_FAILED_EVENT = "hub:rt-failed";
+//#endregion
+//#region src/realtime/page-runtime.ts
+/**
+* Finding the social runtime's realtime API on the page. The runtime owns the
+* `rt` singleton (plan §4.4): it registers on `window.__DG__.rt`, and older
+* runtimes only set the v1 name `window.__HUB_RT__`.
+*/
+/** Whether `candidate` looks like a {@link RealtimeApi} (any bundle's). */
+function isRealtimeApi(candidate) {
+	return typeof readField(candidate, "version") === "number" && hasMethods(readField(candidate, "presence"), ["set", "clear"]) && hasMethods(readField(candidate, "social"), [
+		"openPlayer",
+		"friends",
+		"counts",
+		"chatMode",
+		"on"
+	]) && hasMethods(readField(candidate, "mp"), [
+		"onLaunch",
+		"onJoinInfo",
+		"invite",
+		"setBusy",
+		"party"
+	]) && hasMethods(readField(candidate, "rooms"), [
+		"create",
+		"join",
+		"list"
+	]) && hasMethods(readField(candidate, "notify"), ["setQuiet"]);
+}
+let hasWarnedAboutApi = false;
+/** Warn once when the runtime registered a different shape number than this client knows. */
+function warnOnApiMismatch(registeredApi) {
+	if (registeredApi === 1 || hasWarnedAboutApi) return;
+	hasWarnedAboutApi = true;
+	console.warn(`[hub] this page's social runtime speaks realtime api ${String(registeredApi)}, this client api ${String(1)}. Fix: npm update @diffenderfer-games/hub`);
+}
+/** The page's realtime API if the runtime has loaded, else `null`. */
+function findRealtimeApi() {
+	if (typeof window === "undefined") return null;
+	const registered = window.__DG__?.rt;
+	if (registered !== void 0 && isRealtimeApi(registered.instance)) {
+		warnOnApiMismatch(registered.api);
+		return registered.instance;
+	}
+	const legacy = window[LEGACY_GLOBAL_NAMES.rt];
+	return isRealtimeApi(legacy) ? legacy : null;
+}
+/** Whether the hub injected this page (`window.__HUB__`); without it the runtime can never arrive. */
+function isHubInjectedPage() {
+	return typeof window !== "undefined" && isObject(readField(window, "__HUB__"));
+}
+/** Why the social runtime failed to load on this page (set by the menu), or `''`. */
+function readRuntimeFailure() {
+	if (typeof window === "undefined") return "";
+	const failure = readField(window, "__HUB_RT_ERROR__");
+	return typeof failure === "string" ? failure.slice(0, 120) : "";
+}
+//#endregion
+//#region src/realtime/bridge.ts
+/**
+* The bridge from the forwarders to the social runtime, which the menu loads
+* after the page (and which may never load). The forwarders stay thin so a
+* game's bundled copy never goes stale:
+*
+* - listeners are kept here and attached whenever the runtime appears;
+* - "latest state" calls are remembered and replayed when it appears;
+* - calls that return data wait up to {@link RUNTIME_WAIT_MS}, then reject
+*   with `OfflineError`;
+* - with no `window.__HUB__` (a page the hub didn't inject) waits end at once.
+*/
+/** How long data and UI calls wait for the social runtime before giving up. */
+const RUNTIME_WAIT_MS = 15e3;
+/** Resolves the runtime's realtime API, waiting for it to load when necessary. */
+var RealtimeBridge = class {
+	constructor() {
+		_defineProperty(this, "pendingCallbacks", []);
+		if (typeof window !== "undefined") window.addEventListener(REALTIME_READY_EVENT, () => {
+			this.runPendingCallbacks();
+		});
+	}
+	/** The runtime's API if it has loaded. */
+	current() {
+		return findRealtimeApi();
+	}
+	/** Run `callback` as soon as the runtime exists (now, or whenever it loads). */
+	onReady(callback) {
+		const realtime = this.current();
+		if (realtime === null) this.pendingCallbacks.push(callback);
+		else callback(realtime);
+	}
+	/** The runtime, waiting up to {@link RUNTIME_WAIT_MS}; rejects with `OfflineError`. */
+	whenReady() {
+		const realtime = this.current();
+		if (realtime !== null) return Promise.resolve(realtime);
+		if (!isHubInjectedPage()) return Promise.reject(hubLink().createOfflineError("Online features are not available on this page."));
+		return new Promise((resolve, reject) => {
+			const resolveWhenReady = (loaded) => {
+				clearTimeout(timer);
+				resolve(loaded);
+			};
+			const timer = setTimeout(() => {
+				this.pendingCallbacks = this.pendingCallbacks.filter((callback) => callback !== resolveWhenReady);
+				reject(hubLink().createOfflineError("Online features did not load."));
+			}, RUNTIME_WAIT_MS);
+			this.pendingCallbacks.push(resolveWhenReady);
+		});
+	}
+	/** Attach a listener now or on load; the returned function detaches it. */
+	subscribe(attach) {
+		let detach = null;
+		let isCancelled = false;
+		this.onReady((realtime) => {
+			if (!isCancelled) detach = attach(realtime);
+		});
+		return () => {
+			isCancelled = true;
+			detach?.();
+		};
+	}
+	/** Call the runtime (waiting for it) and re-create its errors as the core client's classes. */
+	async call(request) {
+		return rethrowAsHubError(request(await this.whenReady()));
+	}
+	runPendingCallbacks() {
+		const realtime = this.current();
+		if (realtime === null) return;
+		const callbacks = this.pendingCallbacks;
+		this.pendingCallbacks = [];
+		for (const callback of callbacks) try {
+			callback(realtime);
+		} catch (error) {
+			console.error("[hub] social runtime callback failed", error);
+		}
+	}
+};
+/** The same promise, with rejections re-created as the core client's error classes. */
+async function rethrowAsHubError(pending) {
+	try {
+		return await pending;
+	} catch (error) {
+		throw hubLink().toHubError(error);
+	}
+}
+/** The page's one bridge (per client bundle). */
+const pageBridge = new RealtimeBridge();
+//#endregion
+export { readRuntimeFailure as a, REALTIME_READY_EVENT as c, linkRealtimeToHub as d, isRealtimeApi as i, REALTIME_SINGLETON_API as l, rethrowAsHubError as n, REALTIME_FAILED_EVENT as o, findRealtimeApi as r, REALTIME_FEATURE_VERSION as s, pageBridge as t, hubLink as u };
+
+//# sourceMappingURL=bridge.js.map

package/dist/shared/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","names":[],"sources":["../../src/realtime/hub-link.ts","../../src/realtime/runtime-api.ts","../../src/realtime/page-runtime.ts","../../src/realtime/bridge.ts"],"mappings":"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"}

package/dist/shared/client-version.gen.js

@@ -0,0 +1,7 @@
+//#region src/core/version/client-version.gen.ts
+/** This client's package version, sent as `x-hub-client` on REST calls and `client` in `hello`. */
+const HUB_CLIENT_VERSION = "2.0.0-next.1";
+//#endregion
+export { HUB_CLIENT_VERSION as t };
+
+//# sourceMappingURL=client-version.gen.js.map

package/dist/shared/client-version.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-version.gen.js","names":[],"sources":["../../src/core/version/client-version.gen.ts"],"mappings":";;AAEA,MAAa,qBAAqB"}

package/dist/shared/daily.d.ts

@@ -0,0 +1,123 @@
+import { f as SchemaOutput } from "./wire-types.js";
+import { DailyCompletion, DailyCompletions, Json, dailyEndpoints } from "@diffenderfer-games/hub-contract";
+//#region src/daily/types.d.ts
+/** The response type of a daily endpoint. */
+type DailyResponse<Name extends keyof typeof dailyEndpoints> = SchemaOutput<(typeof dailyEndpoints)[Name]['cfg']['response']>;
+/** This game's daily window and the player's completions (`GET /games/:slug/daily`). */
+type DailyStatus = DailyResponse<'getGameDailyChallenges'>;
+/** Every daily game and the global standings (`GET /daily`). */
+type DailyAll = DailyResponse<'listDailyChallengesForAllGames'>;
+/** One game's row in {@link DailyAll}. */
+type DailyGameStatus = DailyAll['games'][number];
+/** The answer to starting a day: its seed and the signed token to present on completion. */
+type DailyStartResponse = DailyResponse<'startDailyChallenge'>;
+/** The answer to completing a day: the player's new completion count and rank. */
+type DailyCompleteResponse = DailyResponse<'completeDailyChallenge'>;
+/** The challenge a game's `play` receives: set up and start exactly this day (derive the level from `seed`). */
+interface DailyChallenge {
+  /** The day, `YYYY-MM-DD`. */
+  day: string;
+  /** Deterministic per game and day. */
+  seed: number;
+  /** The signed token `complete` presents. */
+  token: string;
+  /** The player already completed this day (a replay). */
+  alreadyCompleted?: boolean;
+}
+/** What `hub.daily.define` takes. */
+interface DailyDefinition {
+  /** Start this challenge now. */
+  play: (challenge: DailyChallenge) => void;
+}
+/** Metadata a game records with a completion (`{ score, difficulty, timeMs, … }`). */
+type DailyCompletionMeta = Record<string, Json>;
+/** What the daily system needs from the hub client: the REST calls and its window events. */
+interface DailyHost {
+  /** This page's game slug. */
+  readonly slug: string | null;
+  /** `GET /games/:slug/daily`. */
+  status(): Promise<DailyStatus>;
+  /** `GET /daily`. */
+  all(): Promise<DailyAll>;
+  /** `POST /games/:slug/daily/:day/start`. */
+  start(day: string): Promise<DailyStartResponse>;
+  /** `POST /games/:slug/daily/:day/complete`. */
+  complete(day: string, token: string, meta: DailyCompletionMeta): Promise<DailyCompleteResponse>;
+  /** Fire a `hub:*` window event (the menu listens). */
+  emit(name: string, detail: DailyEventDetail): void;
+}
+/** The detail of the `hub:daily-*` window events. */
+type DailyEventDetail = {
+  day: string;
+  seed: number;
+  alreadyCompleted: boolean;
+} | {
+  day: string;
+  count: number;
+  rank: number | null;
+  meta: DailyCompletionMeta;
+} | {
+  day: string;
+  error: string;
+};
+//#endregion
+//#region src/daily/daily-system.d.ts
+/** The window event the injected menu fires to start a day on the game's instance. */
+declare const DAILY_START_EVENT = "hub:daily-start";
+/** Daily challenges (`hub.daily`). */
+declare class DailySystem {
+  /**
+   * The challenge in progress (set when a day starts, cleared on complete).
+   * A game's win handler checks it: `if (hub.daily.active) hub.daily.complete(…)`.
+   */
+  active: DailyChallenge | null;
+  private readonly host;
+  private play;
+  private pendingDay;
+  private isRelaying;
+  constructor(host: DailyHost);
+  /** Whether a game registered a daily-challenge handler on this page. */
+  get isDefined(): boolean;
+  /**
+   * Register the game's challenge runner. Call once at load. If the page was
+   * deep-linked with `?daily=DATE` (or a start was requested before this),
+   * that day starts now.
+   */
+  define(definition: DailyDefinition): void;
+  /**
+   * Fetch the signed token for `day`, make it active and call the game's
+   * `play`. Before `define`, the day is kept and played then, so the menu's
+   * own instance never fetches a token; it is also relayed to any other
+   * daily system on the page (a client copy that couldn't share this one).
+   */
+  startAndPlay(day: string): Promise<void>;
+  /**
+   * Record completion of the active challenge with optional metadata.
+   * Resolves with the new completion count and rank, or `null` when no
+   * challenge is active or the hub refused.
+   */
+  complete(meta?: DailyCompletionMeta): Promise<DailyCompleteResponse | null>;
+  /** Ask the page's other daily systems to start `day` (this one ignores its own event). */
+  private relayStart;
+  /** Abandon the active challenge without recording it (e.g. the player quit). */
+  cancel(): void;
+  /** This game's window and the player's completions. */
+  status(): Promise<DailyStatus>;
+  /** Every daily-enabled game and the global standings (for the home hub). */
+  all(): Promise<DailyAll>;
+}
+//#endregion
+//#region src/daily/page-daily.d.ts
+/** The cross-bundle shape number of the `daily` singleton. Bump only on an incompatible change. */
+declare const DAILY_SINGLETON_API = 1;
+/** Whether `candidate` is some bundle's daily system (v1 copies included). */
+declare function isDailySystem(candidate: unknown): candidate is DailySystem;
+/**
+ * The page-wide daily system, created with `host` if no bundle has made one
+ * yet. On a shape mismatch the registered one is kept and this bundle gets a
+ * private instance. The answer is kept for this bundle.
+ */
+declare function getDaily(host: DailyHost): DailySystem;
+//#endregion
+export { DailyStatus as _, isDailySystem as a, DailyAll as c, DailyCompletionMeta as d, DailyDefinition as f, DailyStartResponse as g, DailyHost as h, getDaily as i, DailyChallenge as l, DailyGameStatus as m, DailyCompletions as n, DAILY_START_EVENT as o, DailyEventDetail as p, DAILY_SINGLETON_API as r, DailySystem as s, DailyCompletion as t, DailyCompleteResponse as u };
+//# sourceMappingURL=daily.d.ts.map

package/dist/shared/daily.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily.d.ts","names":[],"sources":["../../src/daily/types.ts","../../src/daily/daily-system.ts","../../src/daily/page-daily.ts"],"mappings":";;;;KAQK,cAAc,0BAA0B,kBAAkB,qBAAqB,gBAAgB;;KAGxF,cAAc;;KAGd,WAAW;;KAGX,kBAAkB;;KAGlB,qBAAqB;;KAGrB,wBAAwB;;UAGnB;;EAEf;;EAEA;;EAEA;;EAEA;;;UAIe;;EAEf,OAAO,WAAW;;;KAIR,sBAAsB,eAAe;;UAGhC;;WAEN;;EAET,UAAU,QAAQ;;EAElB,OAAO,QAAQ;;EAEf,MAAM,cAAc,QAAQ;;EAE5B,SAAS,aAAa,eAAe,MAAM,sBAAsB,QAAQ;;EAEzE,KAAK,cAAc,QAAQ;;;KAIjB;EACN;EAAa;EAAc;;EAC3B;EAAa;EAAe;EAAqB,MAAM;;EACvD;EAAa;;;;;cClDN;;cA0BA;;;;;EAKX,QAAQ;mBACS;UACT;UACA;UACA;EAEI,YAAA,MAAM;;MAiBd;;;;;;EASJ,OAAO,YAAY;;;;;;;EAeb,aAAa,cAAc;;;;;;EAuB3B,SAAS,OAAM,sBAA2B,QAAQ;;UAiBhD;;EAaR;;EAKA,UAAU,QAAQ;;EAKlB,OAAO,QAAQ;;;;;cClJJ;;iBAIG,cAAc,qBAAqB,aAAa;;;;;;iBAWhD,SAAS,MAAM,YAAY"}

package/dist/shared/daily.js

@@ -0,0 +1,191 @@
+import { i as hasMethods, n as claimSingleton, o as readField, r as _defineProperty } from "./globals.js";
+import "./client-version.gen.js";
+//#region src/daily/daily-system.ts
+/**
+* Daily challenges, client side. A daily-enabled game calls
+* `hub.daily.define({ play })` once at load; `play` receives a
+* {@link DailyChallenge} and starts exactly that challenge. When the player
+* finishes, the game calls `hub.daily.complete({ score, … })`.
+*
+* The system is a page-wide singleton shared by the game's client and the
+* injected menu, so the menu can start a day on the instance the game
+* registered `play` on. Deep links (`/<slug>/?daily=YYYY-MM-DD`) auto-start.
+*/
+const DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+/** The window event the injected menu fires to start a day on the game's instance. */
+const DAILY_START_EVENT = "hub:daily-start";
+/** A day key, or `null` when `candidate` isn't one. */
+function asDayKey(candidate) {
+	return typeof candidate === "string" && DAY_PATTERN.test(candidate) ? candidate : null;
+}
+/** The day the page was deep-linked to, if any. */
+function readDeepLinkDay() {
+	const captured = typeof window === "undefined" ? null : asDayKey(readField(window, "__hubDailyDeep"));
+	if (captured !== null || typeof location === "undefined") return captured;
+	return asDayKey(new URL(location.href).searchParams.get("daily"));
+}
+/** The message of a thrown value. */
+function messageOf(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+/** Daily challenges (`hub.daily`). */
+var DailySystem = class {
+	constructor(host) {
+		_defineProperty(
+			this,
+			/**
+			* The challenge in progress (set when a day starts, cleared on complete).
+			* A game's win handler checks it: `if (hub.daily.active) hub.daily.complete(…)`.
+			*/
+			"active",
+			null
+		);
+		_defineProperty(this, "host", void 0);
+		_defineProperty(this, "play", null);
+		_defineProperty(this, "pendingDay", null);
+		_defineProperty(this, "isRelaying", false);
+		this.host = host;
+		if (typeof window !== "undefined") window.addEventListener(DAILY_START_EVENT, (event) => {
+			if (this.isRelaying) return;
+			const day = event instanceof CustomEvent ? readField(event.detail, "day") : void 0;
+			if (typeof day === "string") this.startAndPlay(day);
+		});
+	}
+	/** Whether a game registered a daily-challenge handler on this page. */
+	get isDefined() {
+		return this.play !== null;
+	}
+	/**
+	* Register the game's challenge runner. Call once at load. If the page was
+	* deep-linked with `?daily=DATE` (or a start was requested before this),
+	* that day starts now.
+	*/
+	define(definition) {
+		this.play = definition.play;
+		const day = readDeepLinkDay() ?? this.pendingDay;
+		this.pendingDay = null;
+		if (day !== null) this.startAndPlay(day);
+	}
+	/**
+	* Fetch the signed token for `day`, make it active and call the game's
+	* `play`. Before `define`, the day is kept and played then, so the menu's
+	* own instance never fetches a token; it is also relayed to any other
+	* daily system on the page (a client copy that couldn't share this one).
+	*/
+	async startAndPlay(day) {
+		const play = this.play;
+		if (play === null) {
+			this.pendingDay = day;
+			this.relayStart(day);
+			return;
+		}
+		try {
+			const started = await this.host.start(day);
+			const challenge = {
+				day: started.day,
+				seed: started.seed,
+				token: started.token,
+				alreadyCompleted: started.alreadyCompleted
+			};
+			this.active = challenge;
+			this.host.emit("hub:daily-started", {
+				day: started.day,
+				seed: started.seed,
+				alreadyCompleted: started.alreadyCompleted
+			});
+			play({ ...challenge });
+		} catch (error) {
+			this.host.emit("hub:daily-error", {
+				day,
+				error: messageOf(error)
+			});
+		}
+	}
+	/**
+	* Record completion of the active challenge with optional metadata.
+	* Resolves with the new completion count and rank, or `null` when no
+	* challenge is active or the hub refused.
+	*/
+	async complete(meta = {}) {
+		const challenge = this.active;
+		if (challenge === null) return null;
+		try {
+			const completed = await this.host.complete(challenge.day, challenge.token, meta);
+			this.active = null;
+			this.host.emit("hub:daily-complete", {
+				day: challenge.day,
+				count: completed.count,
+				rank: completed.rank,
+				meta
+			});
+			return completed;
+		} catch (error) {
+			this.host.emit("hub:daily-error", {
+				day: challenge.day,
+				error: messageOf(error)
+			});
+			return null;
+		}
+	}
+	/** Ask the page's other daily systems to start `day` (this one ignores its own event). */
+	relayStart(day) {
+		if (typeof window === "undefined") return;
+		this.isRelaying = true;
+		try {
+			window.dispatchEvent(new CustomEvent(DAILY_START_EVENT, { detail: { day } }));
+		} finally {
+			this.isRelaying = false;
+		}
+	}
+	/** Abandon the active challenge without recording it (e.g. the player quit). */
+	cancel() {
+		this.active = null;
+	}
+	/** This game's window and the player's completions. */
+	status() {
+		return this.host.status();
+	}
+	/** Every daily-enabled game and the global standings (for the home hub). */
+	all() {
+		return this.host.all();
+	}
+};
+//#endregion
+//#region src/daily/page-daily.ts
+/**
+* The page's one daily-challenge system (plan §4.4): the first bundle to
+* create it wins, so the menu starts days on the instance the game defined.
+*/
+/** The cross-bundle shape number of the `daily` singleton. Bump only on an incompatible change. */
+const DAILY_SINGLETON_API = 1;
+/** Whether `candidate` is some bundle's daily system (v1 copies included). */
+function isDailySystem(candidate) {
+	return hasMethods(candidate, [
+		"define",
+		"startAndPlay",
+		"complete",
+		"cancel",
+		"status",
+		"all"
+	]);
+}
+let claimedDaily = null;
+/**
+* The page-wide daily system, created with `host` if no bundle has made one
+* yet. On a shape mismatch the registered one is kept and this bundle gets a
+* private instance. The answer is kept for this bundle.
+*/
+function getDaily(host) {
+	claimedDaily ?? (claimedDaily = claimSingleton({
+		name: "daily",
+		version: "2.0.0-next.1",
+		api: 1,
+		create: () => new DailySystem(host),
+		isInstance: isDailySystem
+	}));
+	return claimedDaily;
+}
+//#endregion
+export { DailySystem as a, DAILY_START_EVENT as i, getDaily as n, isDailySystem as r, DAILY_SINGLETON_API as t };
+
+//# sourceMappingURL=daily.js.map

package/dist/shared/daily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily.js","names":[],"sources":["../../src/daily/daily-system.ts","../../src/daily/page-daily.ts"],"mappings":"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"}

package/dist/shared/dom.js

@@ -0,0 +1,48 @@
+//#region src/overlay/dom.ts
+/**
+* Typed DOM helpers for the overlay: element lookups that check the element
+* class instead of asserting it, and small escapes.
+*/
+/** The first element under `root` matching `selector` that is an instance of `elementClass`; throws if missing. */
+function requireElement(root, selector, elementClass) {
+	const found = root.querySelector(selector);
+	if (!(found instanceof elementClass)) throw new Error(`[hub] overlay element ${selector} is missing`);
+	return found;
+}
+/** Every element under `root` matching `selector` that is an instance of `elementClass`. */
+function findElements(root, selector, elementClass) {
+	return [...root.querySelectorAll(selector)].filter((found) => found instanceof elementClass);
+}
+/** `document.body`, which is `null` while the page is still parsing its head (whatever lib.dom says). */
+function pageBody() {
+	return document.body;
+}
+const HTML_ESCAPES = {
+	"&": "&",
+	"<": "&lt;",
+	">": "&gt;",
+	"\"": "&quot;",
+	"'": "&#39;"
+};
+/** Escape text for HTML. */
+function escapeHtml(text) {
+	return text.replace(/[&<>"']/g, (character) => HTML_ESCAPES[character] ?? character);
+}
+/** Clear an element's position styles. */
+function clearPosition(element) {
+	element.style.left = "";
+	element.style.right = "";
+	element.style.top = "";
+	element.style.bottom = "";
+	element.style.transform = "";
+}
+/** Position an element's top-left corner in viewport px. */
+function placeAt(element, left, top) {
+	clearPosition(element);
+	element.style.left = `${String(left)}px`;
+	element.style.top = `${String(top)}px`;
+}
+//#endregion
+export { requireElement as a, placeAt as i, findElements as n, pageBody as r, escapeHtml as t };
+
+//# sourceMappingURL=dom.js.map

package/dist/shared/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","names":[],"sources":["../../src/overlay/dom.ts"],"mappings":";;;;;;AAMA,SAAgB,eAA4C,MAAkB,UAAkB,cAAkD;CAChJ,MAAM,QAAQ,KAAK,cAAc,QAAQ;CACzC,IAAI,EAAE,iBAAiB,eACrB,MAAM,IAAI,MAAM,yBAAyB,SAAS,YAAY;CAEhE,OAAO;AACT;;AAGA,SAAgB,aAA0C,MAAkB,UAAkB,cAAoD;CAChJ,OAAO,CAAC,GAAG,KAAK,iBAAiB,QAAQ,CAAC,CAAC,CAAC,QAAQ,UAAgC,iBAAiB,YAAY;AACnH;;AAGA,SAAgB,WAA+B;CAC7C,OAAO,SAAS;AAClB;AAEA,MAAM,eAAuC;CAAE,KAAK;CAAS,KAAK;CAAQ,KAAK;CAAQ,MAAK;CAAU,KAAK;AAAQ;;AAGnH,SAAgB,WAAW,MAAsB;CAC/C,OAAO,KAAK,QAAQ,aAAa,cAAc,aAAa,cAAc,SAAS;AACrF;;AAGA,SAAgB,cAAc,SAA4B;CACxD,QAAQ,MAAM,OAAO;CACrB,QAAQ,MAAM,QAAQ;CACtB,QAAQ,MAAM,MAAM;CACpB,QAAQ,MAAM,SAAS;CACvB,QAAQ,MAAM,YAAY;AAC5B;;AAGA,SAAgB,QAAQ,SAAsB,MAAc,KAAmB;CAC7E,cAAc,OAAO;CACrB,QAAQ,MAAM,OAAO,GAAG,OAAO,IAAI,EAAE;CACrC,QAAQ,MAAM,MAAM,GAAG,OAAO,GAAG,EAAE;AACrC"}