@diffenderfer-games/hub 2.0.0-next.1 → 2.0.0-next.11

package/dist/shared/daily.d.ts

@@ -1,37 +1,99 @@
-import { f as SchemaOutput } from "./wire-types.js";
-import { DailyCompletion, DailyCompletions, Json, dailyEndpoints } from "@diffenderfer-games/hub-contract";
+import { m as SchemaOutput } from "./wire-types.js";
+import { DailyCompletion, DailyCompletions, Json, SavedCounts as SavedCounts$1, SavedDaily, SavedGame, SavedKind, SavedKind as SavedKind$1, SavedProgress, SavedStatus, TurnSummary as TurnSummary$1, dailyEndpoints } from "@diffenderfer-games/hub-contract";
+//#region src/core/saved/saved-open.d.ts
+/** The instance id parameter (the contract's `SAVED_OPEN_PARAM`). */
+declare const SAVED_OPEN_PARAM = "hub_open";
+/** The instance kind parameter (the contract's `SAVED_KIND_PARAM`). */
+declare const SAVED_KIND_PARAM = "hub_kind";
+/** The window event the hub menu fires to open an instance of this page's game (cancelable). */
+declare const SAVED_OPEN_EVENT = "hub:saved-open";
+/** The window event the social runtime fires for each `ev:saved` (detail: the `SavedGame`). */
+declare const SAVED_CHANGE_EVENT = "hub:saved";
+/** The instance a page was opened for. */
+interface SavedOpened {
+  readonly id: string;
+  readonly kind: SavedKind;
+}
+/** The address that opens `game` in its page. */
+declare function savedGameUrl(game: Pick<SavedGame, 'id' | 'kind' | 'path' | 'daily'>): string;
+//#endregion
+//#region src/core/saved/saved-types.d.ts
+/**
+ * One game in progress: a daily challenge, a single-player run or an online
+ * game. Its `id` is the hub's, or `local:…` for one saved only on this
+ * device so far.
+ */
+interface SavedEntry extends Omit<SavedGame, 'id'> {
+  readonly id: string;
+  /** Saved on this device and not yet sent to the hub (offline, or the tab closed first). */
+  readonly isLocalOnly?: boolean;
+}
+/** Which kinds to list. */
+interface SavedListOptions {
+  readonly kinds?: readonly SavedKind$1[];
+}
+//#endregion
+//#region src/core/game-data.d.ts
+/** Anything a game may store as JSON: an object (interfaces included), an array, text, a number, a boolean or `null`. */
+type GamePayload = object | string | number | boolean | null;
+//#endregion
 //#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`). */
+/** This game's daily window, the player's completions and days in progress (`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. */
+/** The answer to starting (or resuming) a day: its seed, the signed token to present on completion, and its saved game. */
 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`. */
+  /** The day, `YYYY-MM-DD` (a UTC day key). */
   day: string;
   /** Deterministic per game and day. */
   seed: number;
-  /** The signed token `complete` presents. */
+  /** The signed token `complete` presents (empty for a day started offline: it is fetched when the hub is back). */
   token: string;
-  /** The player already completed this day (a replay). */
+  /** The player already completed this day (a replay for fun: nothing is saved or recorded). */
   alreadyCompleted?: boolean;
+  /** The day's saved game; `null` for a replay of a completed day. */
+  instanceId: string | null;
+  /**
+   * The state last saved for this day (`hub.daily.save`, or `hub.resume.save`
+   * during the daily), or `null` when the day starts fresh. A game that
+   * saves restores from it: `if (challenge.saved) startFrom(challenge.saved)`.
+   */
+  saved: GamePayload | null;
+  /** The game's state version of `saved` (0 when none). */
+  savedVersion: number;
+  /** The day was already in progress and was picked up again. */
+  resumed?: boolean;
 }
 /** What `hub.daily.define` takes. */
 interface DailyDefinition {
-  /** Start this challenge now. */
+  /** Start this challenge now (restore `challenge.saved` when it has one). */
   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. */
+/** A daily state save (the same shape as `hub.resume.save`). */
+interface DailySaveInput {
+  /** Everything needed to rebuild the day's run (up to 512 KB as JSON). */
+  readonly state: GamePayload;
+  /** A short line ("34 cards left") and an optional 0 to 1 fraction. */
+  readonly progress: {
+    readonly label: string;
+    readonly fraction?: number | null;
+  };
+  readonly title?: string | null;
+  /** The game's state version (default 0). */
+  readonly version?: number;
+}
+/** What the daily system needs from the hub client: the REST calls, the device copy and its window events. */
 interface DailyHost {
   /** This page's game slug. */
   readonly slug: string | null;
@@ -39,10 +101,20 @@ interface DailyHost {
   status(): Promise<DailyStatus>;
   /** `GET /daily`. */
   all(): Promise<DailyAll>;
-  /** `POST /games/:slug/daily/:day/start`. */
+  /** Start (or pick up) a day: `POST /games/:slug/daily/:day/start`, or a device-only start while offline. */
   start(day: string): Promise<DailyStartResponse>;
-  /** `POST /games/:slug/daily/:day/complete`. */
-  complete(day: string, token: string, meta: DailyCompletionMeta): Promise<DailyCompleteResponse>;
+  /** Pick a day in progress up again by its saved game's id. */
+  resume(instanceId: string): Promise<DailyStartResponse>;
+  /** `POST /games/:slug/daily/:day/complete`; `null` when it was queued offline, to replay when the hub is back. */
+  complete(day: string, token: string, meta: DailyCompletionMeta): Promise<DailyCompleteResponse | null>;
+  /** Keep the day's state on the device at once and send it soon (works offline); `false` when it can't be stored. */
+  save(challenge: DailyChallenge, input: DailySaveInput): boolean;
+  /** Send a waiting save now. */
+  flush(): Promise<void>;
+  /** Give the day up: discard its saved game (works offline). */
+  discard(challenge: DailyChallenge): Promise<void>;
+  /** This game's days in progress (the saved games of kind daily). */
+  inProgress(): Promise<SavedEntry[]>;
   /** Fire a `hub:*` window event (the menu listens). */
   emit(name: string, detail: DailyEventDetail): void;
 }
@@ -51,11 +123,22 @@ type DailyEventDetail = {
   day: string;
   seed: number;
   alreadyCompleted: boolean;
+  resumed?: boolean;
 } | {
   day: string;
   count: number;
   rank: number | null;
   meta: DailyCompletionMeta;
+} | {
+  day: string;
+  queued: true;
+  meta: DailyCompletionMeta;
+} | {
+  day: string;
+  paused: true;
+} | {
+  day: string;
+  discarded: true;
 } | {
   day: string;
   error: string;
@@ -67,13 +150,21 @@ 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(…)`.
+   * The challenge in progress: set when a day starts; cleared the moment the
+   * game calls `complete` (whatever the hub answers, and before it answers)
+   * or `cancel` (or `discard`). A game's win handler checks it:
+   * `if (hub.daily.active) hub.daily.complete(…)`. While it is set the page
+   * is in a daily run, so `hub.resume.save` saves to the day instead of the
+   * game's run: a game whose player leaves a daily unfinished must call
+   * `cancel()`.
    */
   active: DailyChallenge | null;
   private readonly host;
   private play;
   private pendingDay;
+  private pendingInstance;
+  /** A start on its way to the hub, so a resume of the same day waits for it instead of starting it twice. */
+  private inFlight;
   private isRelaying;
   constructor(host: DailyHost);
   /** Whether a game registered a daily-challenge handler on this page. */
@@ -91,15 +182,50 @@ declare class DailySystem {
    * daily system on the page (a client copy that couldn't share this one).
    */
   startAndPlay(day: string): Promise<void>;
+  /**
+   * Pick up a day in progress by its saved game's id (from `hub.saved`):
+   * a fresh token, then the game's `play` with `challenge.saved`. Finishing
+   * it any time later gives that day's credit. A no-op while that day is
+   * already being played.
+   */
+  resume(instanceId: string): Promise<void>;
+  /** Make `challenge` the active day and hand it to the game. */
+  private begin;
+  /**
+   * Save the active day's state, so it can be picked up later (a reload,
+   * another device, next week) and still give that day's credit. Kept on
+   * the device at once and sent after a short quiet spell (works offline).
+   * `hub.resume.save` during a daily lands here too. Returns `false` with
+   * no daily active, or for a replay of a completed day (nothing to save).
+   */
+  save(input: DailySaveInput): boolean;
+  /** This game's days in progress (the calendar marks them, the game can list them). */
+  inProgress(): Promise<SavedEntry[]>;
+  /**
+   * Give up the active day: its progress is discarded and nothing is
+   * recorded. The day can be started again fresh while it is in the 30-day
+   * window. (The hub's lists ask the player first; a game asks for itself.)
+   */
+  discard(): 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.
+   * challenge is active, the hub refused, or the hub can't be reached: then
+   * the completion is queued (`hub:daily-queued`) and replays when it is
+   * back (`hub:daily-complete` follows). The daily run ends at the call,
+   * so `active` is `null` at once, even if the hub then refuses it.
    */
   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). */
+  /**
+   * Pause the active day: the player left it unfinished (quit, picked
+   * another level, started a normal game). Nothing is recorded, and the day
+   * stays in progress in "Your games" and the calendar, to finish later
+   * (its last save is sent now). Until then the page counts as in a daily,
+   * so `hub.resume.save` saves to the day: call `cancel()` on every path
+   * that leaves a daily without `complete`. To give a day up, `discard()`.
+   */
   cancel(): void;
   /** This game's window and the player's completions. */
   status(): Promise<DailyStatus>;
@@ -108,8 +234,8 @@ declare class DailySystem {
 }
 //#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;
+/** The cross-bundle shape number of the `daily` singleton (2 added save, resume, discard and inProgress). Bump only on an incompatible change. */
+declare const DAILY_SINGLETON_API = 2;
 /** Whether `candidate` is some bundle's daily system (v1 copies included). */
 declare function isDailySystem(candidate: unknown): candidate is DailySystem;
 /**
@@ -119,5 +245,5 @@ declare function isDailySystem(candidate: unknown): candidate is DailySystem;
  */
 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 };
+export { SAVED_OPEN_EVENT as A, SavedKind$1 as C, TurnSummary$1 as D, SavedStatus as E, SavedOpened as M, savedGameUrl as N, SAVED_CHANGE_EVENT as O, SavedEntry as S, SavedProgress as T, DailyStartResponse as _, isDailySystem as a, SavedCounts$1 as b, DailyAll as c, DailyCompletionMeta as d, DailyDefinition as f, DailySaveInput as g, DailyHost as h, getDaily as i, SAVED_OPEN_PARAM as j, SAVED_KIND_PARAM as k, 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, DailyStatus as v, SavedListOptions as w, SavedDaily as x, GamePayload as y };
 //# sourceMappingURL=daily.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"daily.d.ts","names":["SavedKind"],"sources":["../../src/core/saved/saved-open.ts","../../src/core/saved/saved-types.ts","../../src/core/game-data.ts","../../src/daily/types.ts","../../src/daily/daily-system.ts","../../src/daily/page-daily.ts"],"mappings":";;;;cAoBa;;cAGA;;cAGA;;cAGA;;UAMI;WACN;WACA,MAAM;;;iBAWD,aAAa,MAAM,KAAK;;;;;;;;UClCvB,mBAAmB,KAAK;WAC9B;;WAEA;;;UAIM;WACN,iBAAiBA;;;;;KCXhB;;;;KCDP,cAAc,0BAA0B,kBAAkB,qBAAqB,gBAAgB;;KAGxF,cAAc;;KAGd,WAAW;;KAGX,kBAAkB;;KAGlB,qBAAqB;;KAGrB,wBAAwB;;UAGnB;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;EAMA,OAAO;;EAEP;;EAEA;;;UAIe;;EAEf,OAAO,WAAW;;;KAIR,sBAAsB,eAAe;;UAGhC;;WAEN,OAAO;;WAEP;aAAqB;aAAwB;;WAC7C;;WAEA;;;UAIM;;WAEN;;EAET,UAAU,QAAQ;;EAElB,OAAO,QAAQ;;EAEf,MAAM,cAAc,QAAQ;;EAE5B,OAAO,qBAAqB,QAAQ;;EAEpC,SAAS,aAAa,eAAe,MAAM,sBAAsB,QAAQ;;EAEzE,KAAK,WAAW,gBAAgB,OAAO;;EAEvC,SAAS;;EAET,QAAQ,WAAW,iBAAiB;;EAEpC,cAAc,QAAQ;;EAEtB,KAAK,cAAc,QAAQ;;;KAIjB;EACN;EAAa;EAAc;EAA2B;;EACtD;EAAa;EAAe;EAAqB,MAAM;;EACvD;EAAa;EAAc,MAAM;;EACjC;EAAa;;EACb;EAAa;;EACb;EAAa;;;;;cCvFN;;cAkCA;;;;;;;;;;EAUX,QAAQ;mBACS;UACT;UACA;UACA;;UAEA;UACA;EAEI,YAAA,MAAM;;MAiBd;;;;;;EASJ,OAAO,YAAY;;;;;;;EAmBb,aAAa,cAAc;;;;;;;EA2B3B,OAAO,qBAAqB;;UAmB1B;;;;;;;;EAgBR,KAAK,OAAO;;EASZ,cAAc,QAAQ;;;;;;EAShB,WAAW;;;;;;;;;EAoBX,SAAS,OAAM,sBAA2B,QAAQ;;UAsBhD;;;;;;;;;EAoBR;;EAUA,UAAU,QAAQ;;EAKlB,OAAO,QAAQ;;;;;cCrQJ;;iBAIG,cAAc,qBAAqB,aAAa;;;;;;iBAWhD,SAAS,MAAM,YAAY"}

package/dist/shared/daily.js

@@ -1,4 +1,5 @@
-import { i as hasMethods, n as claimSingleton, o as readField, r as _defineProperty } from "./globals.js";
+import { a as readField, n as claimSingleton, r as hasMethods } from "./globals.js";
+import { t as _defineProperty } from "./defineProperty.js";
 import "./client-version.gen.js";
 //#region src/daily/daily-system.ts
 /**
@@ -28,14 +29,32 @@ function readDeepLinkDay() {
 function messageOf(error) {
 	return error instanceof Error ? error.message : String(error);
 }
+/** The challenge a start or resume answered. */
+function challengeOf(started) {
+	return {
+		day: started.day,
+		seed: started.seed,
+		token: started.token,
+		alreadyCompleted: started.alreadyCompleted,
+		instanceId: started.instanceId,
+		saved: started.saved,
+		savedVersion: started.savedVersion,
+		resumed: started.resumed
+	};
+}
 /** 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(…)`.
+			* The challenge in progress: set when a day starts; cleared the moment the
+			* game calls `complete` (whatever the hub answers, and before it answers)
+			* or `cancel` (or `discard`). A game's win handler checks it:
+			* `if (hub.daily.active) hub.daily.complete(…)`. While it is set the page
+			* is in a daily run, so `hub.resume.save` saves to the day instead of the
+			* game's run: a game whose player leaves a daily unfinished must call
+			* `cancel()`.
 			*/
 			"active",
 			null
@@ -43,6 +62,8 @@ var DailySystem = class {
 		_defineProperty(this, "host", void 0);
 		_defineProperty(this, "play", null);
 		_defineProperty(this, "pendingDay", null);
+		_defineProperty(this, "pendingInstance", null);
+		_defineProperty(this, "inFlight", null);
 		_defineProperty(this, "isRelaying", false);
 		this.host = host;
 		if (typeof window !== "undefined") window.addEventListener(DAILY_START_EVENT, (event) => {
@@ -63,8 +84,11 @@ var DailySystem = class {
 	define(definition) {
 		this.play = definition.play;
 		const day = readDeepLinkDay() ?? this.pendingDay;
+		const instanceId = this.pendingInstance;
 		this.pendingDay = null;
+		this.pendingInstance = null;
 		if (day !== null) this.startAndPlay(day);
+		else if (instanceId !== null) this.resume(instanceId);
 	}
 	/**
 	* Fetch the signed token for `day`, make it active and call the game's
@@ -79,39 +103,113 @@ var DailySystem = class {
 			this.relayStart(day);
 			return;
 		}
+		const starting = (async () => {
+			try {
+				this.begin(play, challengeOf(await this.host.start(day)));
+			} catch (error) {
+				this.host.emit("hub:daily-error", {
+					day,
+					error: messageOf(error)
+				});
+			}
+		})();
+		this.inFlight = starting;
+		await starting;
+		if (this.inFlight === starting) this.inFlight = null;
+	}
+	/**
+	* Pick up a day in progress by its saved game's id (from `hub.saved`):
+	* a fresh token, then the game's `play` with `challenge.saved`. Finishing
+	* it any time later gives that day's credit. A no-op while that day is
+	* already being played.
+	*/
+	async resume(instanceId) {
+		await this.inFlight;
+		if (this.active?.instanceId === instanceId) return;
+		const play = this.play;
+		if (play === null) {
+			this.pendingInstance = instanceId;
+			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 });
+			this.begin(play, challengeOf(await this.host.resume(instanceId)));
 		} catch (error) {
 			this.host.emit("hub:daily-error", {
-				day,
+				day: "",
 				error: messageOf(error)
 			});
 		}
 	}
+	/** Make `challenge` the active day and hand it to the game. */
+	begin(play, challenge) {
+		this.active = challenge;
+		this.host.emit("hub:daily-started", {
+			day: challenge.day,
+			seed: challenge.seed,
+			alreadyCompleted: challenge.alreadyCompleted === true,
+			resumed: challenge.resumed === true
+		});
+		if (challenge.resumed === true) this.host.emit("hub:daily-resumed", {
+			day: challenge.day,
+			seed: challenge.seed,
+			alreadyCompleted: false,
+			resumed: true
+		});
+		play({ ...challenge });
+	}
+	/**
+	* Save the active day's state, so it can be picked up later (a reload,
+	* another device, next week) and still give that day's credit. Kept on
+	* the device at once and sent after a short quiet spell (works offline).
+	* `hub.resume.save` during a daily lands here too. Returns `false` with
+	* no daily active, or for a replay of a completed day (nothing to save).
+	*/
+	save(input) {
+		const challenge = this.active;
+		if (challenge === null || challenge.instanceId === null) return false;
+		return this.host.save(challenge, input);
+	}
+	/** This game's days in progress (the calendar marks them, the game can list them). */
+	inProgress() {
+		return this.host.inProgress();
+	}
+	/**
+	* Give up the active day: its progress is discarded and nothing is
+	* recorded. The day can be started again fresh while it is in the 30-day
+	* window. (The hub's lists ask the player first; a game asks for itself.)
+	*/
+	async discard() {
+		const challenge = this.active;
+		if (challenge === null) return;
+		this.active = null;
+		if (challenge.instanceId !== null) await this.host.discard(challenge);
+		this.host.emit("hub:daily-discarded", {
+			day: challenge.day,
+			discarded: true
+		});
+	}
 	/**
 	* 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.
+	* challenge is active, the hub refused, or the hub can't be reached: then
+	* the completion is queued (`hub:daily-queued`) and replays when it is
+	* back (`hub:daily-complete` follows). The daily run ends at the call,
+	* so `active` is `null` at once, even if the hub then refuses it.
 	*/
 	async complete(meta = {}) {
 		const challenge = this.active;
 		if (challenge === null) return null;
+		this.active = null;
 		try {
 			const completed = await this.host.complete(challenge.day, challenge.token, meta);
-			this.active = null;
+			if (completed === null) {
+				this.host.emit("hub:daily-queued", {
+					day: challenge.day,
+					queued: true,
+					meta
+				});
+				return null;
+			}
 			this.host.emit("hub:daily-complete", {
 				day: challenge.day,
 				count: completed.count,
@@ -137,9 +235,24 @@ var DailySystem = class {
 			this.isRelaying = false;
 		}
 	}
-	/** Abandon the active challenge without recording it (e.g. the player quit). */
+	/**
+	* Pause the active day: the player left it unfinished (quit, picked
+	* another level, started a normal game). Nothing is recorded, and the day
+	* stays in progress in "Your games" and the calendar, to finish later
+	* (its last save is sent now). Until then the page counts as in a daily,
+	* so `hub.resume.save` saves to the day: call `cancel()` on every path
+	* that leaves a daily without `complete`. To give a day up, `discard()`.
+	*/
 	cancel() {
+		const challenge = this.active;
 		this.active = null;
+		if (challenge !== null) {
+			this.host.flush().catch(() => void 0);
+			this.host.emit("hub:daily-paused", {
+				day: challenge.day,
+				paused: true
+			});
+		}
 	}
 	/** This game's window and the player's completions. */
 	status() {
@@ -156,8 +269,8 @@ var DailySystem = class {
 * 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;
+/** The cross-bundle shape number of the `daily` singleton (2 added save, resume, discard and inProgress). Bump only on an incompatible change. */
+const DAILY_SINGLETON_API = 2;
 /** Whether `candidate` is some bundle's daily system (v1 copies included). */
 function isDailySystem(candidate) {
 	return hasMethods(candidate, [
@@ -178,8 +291,8 @@ let claimedDaily = null;
 function getDaily(host) {
 	claimedDaily ?? (claimedDaily = claimSingleton({
 		name: "daily",
-		version: "2.0.0-next.1",
-		api: 1,
+		version: "2.0.0-next.11",
+		api: 2,
 		create: () => new DailySystem(host),
 		isInstance: isDailySystem
 	}));

package/dist/shared/daily.js.map

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

@@ -0,0 +1,39 @@
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+//#endregion
+//#region \0@oxc-project+runtime@0.153.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+//#endregion
+export { _defineProperty as t };

package/dist/shared/describe.d.ts

@@ -0,0 +1,32 @@
+import { c as Point, s as LookLike, t as Anchor, u as RenderOptions } from "./types.js";
+import { t as SceneNode } from "./scene.js";
+import { AvatarLook } from "@diffenderfer-games/hub-contract/avatar";
+//#region src/avatar/render/compose.d.ts
+/** The head centre's height above the feet. */
+declare const HEAD_Y = -96;
+/** A composed avatar: scene nodes in rig space and its anchors. */
+interface Composed {
+  readonly nodes: readonly SceneNode[];
+  readonly anchors: Readonly<Record<Anchor, Point>>;
+}
+/** Composes a look (or `null` for the silhouette) with a pose. */
+declare function composeAvatar(look: AvatarLook | null, opts?: RenderOptions): Composed;
+//#endregion
+//#region src/avatar/outputs/svg.d.ts
+/** An avatar as SVG markup. */
+declare function renderSvg(like: LookLike, opts?: RenderOptions): string;
+//#endregion
+//#region src/avatar/art-store.d.ts
+/** Loads the art chunk (once). Resolves when rendering is synchronous. */
+declare function ready(): Promise<void>;
+/** Calls `fn` once the art has loaded (now, when it already has). */
+declare function onArtReady(fn: () => void): void;
+//#endregion
+//#region src/avatar/describe.d.ts
+/** Alt text for any {@link LookLike} (`''` for none). */
+declare function describe(like: LookLike): string;
+/** A person emoji with the nearest of the five skin tones and a hair hint where Unicode has one: `🧑🏽‍🦱`. */
+declare function avatarEmoji(like: LookLike): string;
+//#endregion
+export { renderSvg as a, composeAvatar as c, ready as i, describe as n, Composed as o, onArtReady as r, HEAD_Y as s, avatarEmoji as t };
+//# sourceMappingURL=describe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","names":[],"sources":["../../src/avatar/render/compose.ts","../../src/avatar/outputs/svg.ts","../../src/avatar/art-store.ts","../../src/avatar/describe.ts"],"mappings":";;;;;cA4Ba;;UASI;WACN,gBAAgB;WAChB,SAAS,SAAS,OAAO,QAAQ;;;iBA2P5B,cAAc,MAAM,mBAAmB,OAAM,gBAAqB;;;;iBC7PlE,UAAU,MAAM,UAAU,OAAM;;;;iBCpBhC,SAAS;;iBAYT,WAAW;;;;iBC+BX,SAAS,MAAM;;iBASf,YAAY,MAAM"}