@joystyk/launcher 0.0.0 → 0.2.0

package/dist/model.js

@@ -0,0 +1,566 @@
+import { ASSIST_KINDS, isGameId, isGameOptions, isJson, optionsForMode } from "@joystyk/contracts";
+import { dailyWordStatsSchema } from "@joystyk/daily";
+import { checkDisplayName } from "@joystyk/identity";
+//#region src/model.ts
+var MODES = [
+	"solo",
+	"ai",
+	"pass-and-play",
+	"p2p",
+	"server",
+	"daily"
+];
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isStringArray = (value) => Array.isArray(value) && value.every((v) => typeof v === "string");
+var isMode = (value) => typeof value === "string" && MODES.includes(value);
+var isLauncherGame = (value) => {
+	if (!isRecord(value) || !isGameId(value["id"]) || typeof value["name"] !== "string") return false;
+	const players = value["players"];
+	return Array.isArray(value["modes"]) && value["modes"].every(isMode) && isRecord(players) && Number.isInteger(players["min"]) && Number.isInteger(players["max"]) && (players["default"] === void 0 || Number.isInteger(players["default"])) && isStringArray(value["aiLevels"]) && (value["status"] === "available" || value["status"] === "coming-soon") && (value["aiContent"] === void 0 || typeof value["aiContent"] === "boolean") && (value["options"] === void 0 || isGameOptions(value["options"]));
+};
+/** The launcher's view of a manifest, for pages that have the manifest itself. */
+var launcherGame = (manifest, status = "available") => ({
+	id: manifest.id,
+	name: manifest.name,
+	modes: [...manifest.modes],
+	players: manifest.players.default === void 0 ? {
+		min: manifest.players.min,
+		max: manifest.players.max
+	} : {
+		min: manifest.players.min,
+		max: manifest.players.max,
+		default: manifest.players.default
+	},
+	aiLevels: manifest.ai === null ? [] : [...manifest.ai.levels],
+	status,
+	aiContent: manifest.aiContent === true,
+	...manifest.options === void 0 ? {} : { options: manifest.options }
+});
+/** The AI-content notice (D-44; wording approved as D-52). */
+var AI_NOTICE = {
+	title: "This game uses AI-made content",
+	body: "Some puzzles and clues here are written by an AI model. Each one passes automatic safety checks before it appears, but no person reads every one first, so now and then something may be odd or wrong. If you spot a problem, use Report a problem.",
+	scope: "Accepting unlocks all AI-content games on this device. You can change this anytime in Preferences."
+};
+/** True when an AI-content game must show the notice before it can start. */
+var needsAiNotice = (game, preferences) => game.aiContent === true && preferences.aiContentAccepted !== true;
+/**
+* The access gate (monetization.md): where premium games and modes will ask for an
+* entitlement in v2. Every game is free in v1, so it is always open.
+*/
+var accessGate = (access) => {
+	switch (access) {
+		case "free": return "open";
+	}
+};
+var MODE_LABELS = {
+	solo: "Solo",
+	ai: "Against the computer",
+	"pass-and-play": "Pass and play",
+	p2p: "Online, peer to peer",
+	server: "Online with friends",
+	daily: "Daily puzzle"
+};
+/** The modes the launcher runs on a local session. The daily puzzle is a local session on today's published config. */
+var toLocalMode = (mode) => mode === "solo" || mode === "ai" || mode === "pass-and-play" || mode === "daily" ? mode : null;
+var toStageMode = (mode) => mode === "server" ? "server" : toLocalMode(mode);
+var ONLINE_CHECKING = { _tag: "Checking" };
+var ONLINE_UNREACHABLE = { _tag: "Unreachable" };
+/** The room server's answer, checked at the boundary; anything else (an error page, a proxy's 502 body) is undefined. */
+var parseHostedGames = (value) => {
+	if (!isRecord(value)) return void 0;
+	const { games, protocol } = value;
+	if (!Array.isArray(games) || !games.every(isGameId) || !Number.isInteger(protocol) || protocol < 1) return void 0;
+	return {
+		_tag: "Hosted",
+		games: [...games],
+		protocol
+	};
+};
+/** True when the room server opens rooms for this game. */
+var hostedOnline = (game, online) => online._tag === "Hosted" && online.games.includes(game.id);
+/** Why Online with friends can't be picked yet: unknown while asking, coming soon (D-53) when not hosted. */
+var onlineNote = (game, online) => {
+	switch (online._tag) {
+		case "Checking": return null;
+		case "Unreachable": return "Unavailable right now";
+		case "Hosted": return online.games.includes(game.id) ? null : "Coming soon";
+	}
+};
+/**
+* One option per mode in the manifest, in manifest order. Online with friends is playable only
+* once the room server says it hosts the game; until it answers, and when it can't be reached,
+* the local modes are unaffected.
+*/
+var modeOptions = (game, online = ONLINE_CHECKING) => game.modes.map((mode) => {
+	const run = toStageMode(mode);
+	const fits = run === "solo" || run === "daily" ? game.players.min <= 1 : run === "ai" ? game.aiLevels.length > 0 : run === "pass-and-play" || run === "server" ? game.players.max >= 2 : false;
+	const reachable = run !== "server" || hostedOnline(game, online);
+	const playable = game.status === "available" && run !== null && fits && reachable;
+	const note = run === null ? "Coming soon" : run === "server" && game.status === "available" && fits ? onlineNote(game, online) : null;
+	return {
+		mode,
+		label: MODE_LABELS[mode],
+		playable,
+		note
+	};
+});
+/**
+* The player counts a mode allows: solo is one; local multiplayer takes two or more; a room
+* sizes itself. In pass-and-play the count is people: a game with AI and more seats than
+* people (Hearts, Spades) lets two or more share the device while the computer fills the rest.
+*/
+var playerCounts = (game, mode) => {
+	if (mode !== "ai" && mode !== "pass-and-play" || game.players.max === 1) return [1];
+	const counts = [];
+	const fewest = mode === "pass-and-play" && game.aiLevels.length > 0 ? 2 : Math.max(2, game.players.min);
+	for (let n = fewest; n <= game.players.max; n += 1) counts.push(n);
+	return counts;
+};
+/**
+* The count the picker starts at for a mode: against the computer, the game's declared
+* default when the mode offers it (Shift 23 seats five, D-58); otherwise the fewest. Other
+* modes count people, and a room sizes itself, so the default never applies to them.
+*/
+var startingCount = (game, mode) => {
+	const counts = playerCounts(game, mode);
+	const preset = game.players.default;
+	return mode === "ai" && preset !== void 0 && counts.includes(preset) ? preset : counts[0] ?? 1;
+};
+/** Pass-and-play with fewer people than the game's seats: the computer plays the rest. */
+var computerSeatsFor = (game, setup) => setup.mode === "pass-and-play" ? Math.max(0, game.players.min - setup.players) : 0;
+var initialSetup = (game, online = ONLINE_CHECKING) => {
+	const mode = modeOptions(game, online).find((option) => option.playable)?.mode ?? null;
+	return {
+		mode,
+		aiLevel: game.aiLevels[0] ?? null,
+		players: startingCount(game, mode),
+		names: [],
+		errors: [],
+		code: "",
+		watch: false,
+		codeError: null,
+		options: Object.fromEntries(optionsForMode(game.options ?? [], mode ?? "solo").map((o) => [o.key, o.default]))
+	};
+};
+/** Invite codes: six characters without look-alikes (no 0/O or 1/I), as the room server issues them. */
+var ROOM_CODE = /^[A-HJ-NP-Z2-9]{6}$/;
+var isRoomCode = (value) => typeof value === "string" && ROOM_CODE.test(value);
+/**
+* The room code in what a player typed or pasted: a code in any case, with spaces or dashes
+* ("k7m-2qx"), or a whole invite link (`…?room=K7M2QX`). Null when there is none.
+*/
+var parseRoomCode = (input) => {
+	const trimmed = input.trim();
+	const code = (/[?&]room=([A-Za-z0-9-]+)/.exec(trimmed)?.[1] ?? trimmed).toUpperCase().replace(/[\s-]/g, "");
+	return isRoomCode(code) ? code : null;
+};
+/** "K7M 2QX": a code grouped for reading aloud and copying by eye. */
+var spacedCode = (code) => `${code.slice(0, 3)} ${code.slice(3)}`;
+var clockValue = (setting) => setting.kind === "off" ? "off" : setting.kind === "move" ? `move:${String(setting.ms)}` : `bank:${String(setting.initialMs)}:${String(setting.incrementMs)}`;
+var parseClockValue = (value) => {
+	if (value === "off") return { kind: "off" };
+	const move = /^move:(\d{1,9})$/.exec(value ?? "");
+	if (move?.[1] !== void 0) return {
+		kind: "move",
+		ms: Number(move[1])
+	};
+	const bank = /^bank:(\d{1,9}):(\d{1,9})$/.exec(value ?? "");
+	if (bank?.[1] !== void 0 && bank[2] !== void 0) return {
+		kind: "bank",
+		initialMs: Number(bank[1]),
+		incrementMs: Number(bank[2])
+	};
+};
+var duration = (ms) => {
+	const s = Math.round(ms / 1e3);
+	if (s >= 60 && s % 60 === 0) return s === 60 ? "1 minute" : `${String(s / 60)} minutes`;
+	return s === 1 ? "1 second" : `${String(s)} seconds`;
+};
+/** "30 seconds a move", "5 minutes, plus 2 seconds a move", "Off". */
+var clockLabel = (setting) => {
+	switch (setting.kind) {
+		case "off": return "Off";
+		case "move": return `${duration(setting.ms)} a move`;
+		case "bank": return setting.incrementMs > 0 ? `${duration(setting.initialMs)}, plus ${duration(setting.incrementMs)} a move` : `${duration(setting.initialMs)} each`;
+	}
+};
+/**
+* The lobby's clock choices for a manifest clock: its presets with the default marked, then
+* Off, which private rooms always offer and never default to (D-42). None for a game without
+* a clock.
+*/
+var clockOptions = (clock) => {
+	if (clock === null) return [];
+	const presets = clock.mode === "bank" ? clock.presets.map((p) => ({
+		kind: "bank",
+		initialMs: p.initialMs,
+		incrementMs: p.incrementMs
+	})) : clock.presets.map((s) => ({
+		kind: "move",
+		ms: s * 1e3
+	}));
+	const usual = clock.mode === "bank" ? {
+		kind: "bank",
+		initialMs: clock.default.initialMs,
+		incrementMs: clock.default.incrementMs
+	} : {
+		kind: "move",
+		ms: clock.default * 1e3
+	};
+	return [...(presets.some((p) => clockValue(p) === clockValue(usual)) ? presets : [usual, ...presets]).map((p) => ({
+		value: clockValue(p),
+		label: clockValue(p) === clockValue(usual) ? `${clockLabel(p)} (usual)` : clockLabel(p)
+	})), {
+		value: "off",
+		label: "Off: no clock"
+	}];
+};
+/** "Ana", "Ana and Ben", "Ana, Ben and Cy". */
+var nameList = (names) => names.length <= 1 ? names[0] ?? "" : `${names.slice(0, -1).join(", ")} and ${names.at(-1) ?? ""}`;
+/**
+* What an offer's state means to the viewer (`me`, null for a spectator), in words. An open
+* end offer says how long is left unless `countdown` is false (live-region announcements).
+*/
+var offerText = (offer, me, countdown = true) => {
+	const mine = offer.by === me;
+	const waiting = offer.waiting.length === 0 ? "" : ` Waiting for ${nameList(offer.waiting)}.`;
+	if (offer.kind === "rematch") switch (offer.status) {
+		case "open":
+			if (mine) return `You offered a rematch.${waiting}`;
+			if (me !== null && offer.accepted.includes(me)) return `You accepted ${offer.byName}'s rematch.${waiting}`;
+			return `${offer.byName} offers a rematch.`;
+		case "declined": return `${offer.declinedBy === me ? "You" : offer.declinedName ?? "Someone"} declined the rematch.`;
+		case "withdrawn": return mine ? "You withdrew your rematch offer." : `${offer.byName} withdrew the rematch offer.`;
+	}
+	switch (offer.status) {
+		case "open": {
+			const left = countdown && offer.seconds !== null ? ` It ends in ${formatElapsed(offer.seconds * 1e3)} unless someone declines.` : "";
+			if (mine) return `You asked to end the match.${left}`;
+			if (me !== null && offer.accepted.includes(me)) return `You agreed to end the match.${left}`;
+			return `${offer.byName} asks to end the match with no result.${left}`;
+		}
+		case "declined": return `${offer.declinedBy === me ? "You" : offer.declinedName ?? "Someone"} declined to end the match.`;
+		case "withdrawn": return mine ? "You withdrew your offer to end the match." : `${offer.byName} withdrew the offer to end the match.`;
+	}
+};
+/**
+* What to announce (politely) when the room's offer changed: a new offer, an answer, or
+* nothing. `seats` names the players who accepted.
+*/
+var offerAnnouncement = (before, after, me, seats) => {
+	if (after === null) return null;
+	if (before === null || before.id !== after.id || before.status !== after.status) return offerText(after, me, false);
+	const names = after.accepted.filter((seat) => !before.accepted.includes(seat) && seat !== me).flatMap((seat) => seats.filter((s) => s.id === seat && s.controller === "human").map((s) => s.name));
+	return names.length === 0 ? null : `${nameList(names)} accepted.`;
+};
+/** Seats a player or the computer fills. */
+var filledSeats = (room) => room.seats.filter((s) => s.claimed || s.controller === "ai");
+/** Why the host can't start yet, or null when the match can start (the room checks again). */
+var startProblem = (room) => {
+	const filled = filledSeats(room);
+	if (filled.length < room.minSeats) return `Waiting for ${room.minSeats - filled.length === 1 ? "another player" : `${String(room.minSeats - filled.length)} more players`}. Share the link, or add the computer.`;
+	const waiting = filled.filter((s) => s.controller === "human" && (!s.ready || !s.connected));
+	if (waiting.length > 0) return `Waiting for ${waiting.map((s) => s.name).join(" and ")} to be ready.`;
+	return null;
+};
+/**
+* A new mode keeps the AI level, and fits the player count to the mode: a count the player
+* chose carries over when the new mode allows it. In a game that declares a default, a count
+* still at the old mode's starting count was never chosen, so the new mode starts at its own.
+*/
+var pickMode = (game, setup, mode) => {
+	const counts = playerCounts(game, mode);
+	const untouched = game.players.default !== void 0 && setup.players === startingCount(game, setup.mode);
+	const players = counts.includes(setup.players) && !untouched ? setup.players : startingCount(game, mode);
+	return {
+		...setup,
+		mode,
+		players,
+		errors: []
+	};
+};
+/** The name a seat gets when its field is left empty. */
+var defaultName = (seat) => `Player ${String(seat + 1)}`;
+/** An empty name on a human seat means "the guest's own display name"; the stage fills it in. */
+var GUEST_NAME = "";
+/**
+* The seats for a setup, numbered from 0, or a problem per pass-and-play name. Solo and
+* vs-AI play seat the guest first; AI seats are named for the computer.
+*/
+var seatsFor = (game, setup) => {
+	switch (setup.mode) {
+		case "solo":
+		case "daily": return {
+			ok: true,
+			seats: [{
+				id: 0,
+				name: "",
+				controller: "human"
+			}]
+		};
+		case "ai": {
+			const level = setup.aiLevel ?? game.aiLevels[0] ?? "default";
+			const opponents = setup.players - 1;
+			const seats = [{
+				id: 0,
+				name: "",
+				controller: "human"
+			}];
+			for (let n = 1; n <= opponents; n += 1) seats.push({
+				id: n,
+				name: opponents === 1 ? "Computer" : `Computer ${String(n)}`,
+				controller: "ai",
+				aiLevel: level
+			});
+			return {
+				ok: true,
+				seats
+			};
+		}
+		case "pass-and-play": {
+			const names = [];
+			const errors = [];
+			for (let seat = 0; seat < setup.players; seat += 1) {
+				const typed = setup.names[seat]?.trim() ?? "";
+				if (typed === "") {
+					names.push(defaultName(seat));
+					errors.push(null);
+					continue;
+				}
+				const checked = checkDisplayName(typed);
+				names.push(checked.ok ? checked.value : typed);
+				errors.push(checked.ok ? null : checked.error.message);
+			}
+			names.forEach((name, seat) => {
+				if (errors[seat] === null && names.findIndex((other) => other.toLowerCase() === name.toLowerCase()) !== seat) errors[seat] = "Each player needs a different name.";
+			});
+			if (errors.some((e) => e !== null)) return {
+				ok: false,
+				errors
+			};
+			const people = names.map((name, id) => ({
+				id,
+				name,
+				controller: "human"
+			}));
+			const level = setup.aiLevel ?? game.aiLevels[0] ?? "default";
+			const computers = computerSeatsFor(game, setup);
+			for (let n = 1; n <= computers; n += 1) people.push({
+				id: people.length,
+				name: computers === 1 ? "Computer" : `Computer ${String(n)}`,
+				controller: "ai",
+				aiLevel: level
+			});
+			return {
+				ok: true,
+				seats: people
+			};
+		}
+		default: return {
+			ok: false,
+			errors: []
+		};
+	}
+};
+var isNumber = (value) => typeof value === "number" && Number.isFinite(value);
+var isStoredPreferences = (value) => isRecord(value) && [
+	"system",
+	"reduce",
+	"no-preference"
+].includes(value["reducedMotion"]) && typeof value["sound"] === "boolean" && isNumber(value["volume"]) && typeof value["singleKeyShortcuts"] === "boolean" && [
+	"system",
+	"light",
+	"dark"
+].includes(value["theme"]) && (value["locale"] === null || typeof value["locale"] === "string") && (value["aiContentAccepted"] === void 0 || typeof value["aiContentAccepted"] === "boolean");
+var isSeat = (value) => isRecord(value) && Number.isInteger(value["id"]) && typeof value["name"] === "string" && (value["controller"] === "human" || value["controller"] === "ai");
+var isOutcome = (value) => isRecord(value) && [
+	"won",
+	"lost",
+	"draw",
+	"completed",
+	"abandoned"
+].includes(value["result"]) && Array.isArray(value["placements"]) && typeof value["summary"] === "string";
+var isFrame = (value) => isRecord(value) && Array.isArray(value["seats"]) && value["seats"].every(isSeat) && (value["handoff"] === null || isRecord(value["handoff"]) && Number.isInteger(value["handoff"]["seat"]) && typeof value["handoff"]["name"] === "string") && (value["outcome"] === null || isOutcome(value["outcome"])) && typeof value["safePoint"] === "boolean" && (value["notice"] === null || typeof value["notice"] === "string");
+var isClockSetting = (value) => isRecord(value) && [
+	"move",
+	"bank",
+	"off"
+].includes(value["kind"]) && parseClockValue(clockValue(value)) !== void 0;
+var isRoomSeat = (value) => isRecord(value) && Number.isInteger(value["id"]) && typeof value["name"] === "string" && (value["controller"] === "human" || value["controller"] === "ai") && (value["aiLevel"] === null || typeof value["aiLevel"] === "string") && typeof value["claimed"] === "boolean" && typeof value["ready"] === "boolean" && typeof value["connected"] === "boolean";
+var isSeatOrNull = (value) => value === null || Number.isInteger(value);
+var isOfferFrame = (value) => isRecord(value) && Number.isInteger(value["id"]) && (value["kind"] === "rematch" || value["kind"] === "end") && Number.isInteger(value["by"]) && typeof value["byName"] === "string" && [
+	"open",
+	"declined",
+	"withdrawn"
+].includes(value["status"]) && Array.isArray(value["accepted"]) && value["accepted"].every((seat) => Number.isInteger(seat)) && isSeatOrNull(value["declinedBy"]) && (value["declinedName"] === null || typeof value["declinedName"] === "string") && isStringArray(value["waiting"]) && (value["seconds"] === null || isNumber(value["seconds"]));
+var isRoomFrame = (value) => {
+	if (!isRecord(value)) return false;
+	const timer = value["timer"];
+	const options = value["clockOptions"];
+	return isRoomCode(value["code"]) && typeof value["link"] === "string" && [
+		"connecting",
+		"lobby",
+		"playing",
+		"finished",
+		"closed"
+	].includes(value["phase"]) && [
+		"connecting",
+		"online",
+		"reconnecting",
+		"closed"
+	].includes(value["connection"]) && isSeatOrNull(value["seat"]) && isSeatOrNull(value["host"]) && Array.isArray(value["seats"]) && value["seats"].every(isRoomSeat) && Number.isInteger(value["minSeats"]) && isClockSetting(value["clock"]) && Array.isArray(options) && options.every((o) => isRecord(o) && typeof o["value"] === "string" && typeof o["label"] === "string") && (value["aiLevel"] === null || typeof value["aiLevel"] === "string") && isStringArray(value["aiLevels"]) && Number.isInteger(value["spectators"]) && (timer === null || isRecord(timer) && Number.isInteger(timer["seat"]) && typeof timer["name"] === "string" && isNumber(timer["seconds"]) && typeof timer["paused"] === "boolean") && (value["notice"] === null || typeof value["notice"] === "string") && (value["noticeCode"] === null || typeof value["noticeCode"] === "string") && Number.isInteger(value["match"]) && (value["offer"] === null || isOfferFrame(value["offer"]));
+};
+var isCount = (value) => Number.isInteger(value) && value >= 0;
+var isDailyFrame = (value) => {
+	if (!isRecord(value)) return false;
+	const earlier = value["earlier"];
+	return typeof value["date"] === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value["date"]) && typeof value["share"] === "string" && typeof value["shareWords"] === "string" && isCount(value["streak"]) && isCount(value["bestStreak"]) && (value["winStreak"] === null || isCount(value["winStreak"])) && (value["bestWinStreak"] === null || isCount(value["bestWinStreak"])) && typeof value["next"] === "string" && (value["statistics"] === void 0 || dailyWordStatsSchema.safeParse(value["statistics"]).success) && (earlier === null || isRecord(earlier) && [
+		"won",
+		"lost",
+		"draw",
+		"completed",
+		"abandoned"
+	].includes(earlier["result"]) && typeof earlier["summary"] === "string");
+};
+var savePart = (value) => typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/.test(value);
+var validSaveSummary = (value) => {
+	if (!isRecord(value) || !isNumber(value["savedAt"]) || !isNumber(value["elapsedMs"]) || !isStringArray(value["players"])) return false;
+	if (value["slot"] !== void 0 && !savePart(value["slot"])) return false;
+	const choices = value["choices"];
+	return choices === void 0 || Array.isArray(choices) && choices.length > 0 && choices.every((c) => isRecord(c) && savePart(c["slot"]) && typeof c["label"] === "string" && c["label"].length > 0 && c["label"].length <= 100 && isNumber(c["savedAt"]) && isNumber(c["elapsedMs"]) && isStringArray(c["players"])) && new Set(choices.map((c) => c.slot)).size === choices.length && choices.some((c) => c.slot === value["slot"]);
+};
+var saveSummarySchema = { "~standard": {
+	version: 1,
+	vendor: "joystyk",
+	validate: (raw) => validSaveSummary(raw) ? { value: raw } : { issues: [{ message: "Expected a validated saved-game offer." }] }
+} };
+var isSaveSummary = (raw) => {
+	const p = saveSummarySchema["~standard"].validate(raw);
+	return !(p instanceof Promise) && p.issues === void 0;
+};
+/** Checks a stage report at the boundary; anything unexpected is dropped. */
+var parseStageOutput = (value) => {
+	if (!isRecord(value)) return void 0;
+	switch (value["_tag"]) {
+		case "Prepared": return (value["save"] === null || isSaveSummary(value["save"])) && isStoredPreferences(value["preferences"]) ? {
+			_tag: "Prepared",
+			save: value["save"],
+			preferences: value["preferences"]
+		} : void 0;
+		case "Preferences": return isStoredPreferences(value["preferences"]) ? {
+			_tag: "Preferences",
+			preferences: value["preferences"]
+		} : void 0;
+		case "Frame": return isFrame(value["frame"]) ? {
+			_tag: "Frame",
+			frame: value["frame"]
+		} : void 0;
+		case "ExitRequested": return { _tag: "ExitRequested" };
+		case "Rematch": return isJson(value["config"]) ? {
+			_tag: "Rematch",
+			config: value["config"]
+		} : void 0;
+		case "Room": return isRoomFrame(value["room"]) ? {
+			_tag: "Room",
+			room: value["room"]
+		} : void 0;
+		case "Daily": return isDailyFrame(value["daily"]) ? {
+			_tag: "Daily",
+			daily: value["daily"]
+		} : void 0;
+		case "Puzzle": return typeof value["puzzleId"] === "string" && /^[a-z0-9-]+(:[a-z0-9-]+)+$/.test(value["puzzleId"]) && value["puzzleId"].length <= 120 ? {
+			_tag: "Puzzle",
+			puzzleId: value["puzzleId"]
+		} : void 0;
+		case "Announce": return typeof value["message"] === "string" && (value["politeness"] === "polite" || value["politeness"] === "assertive") ? {
+			_tag: "Announce",
+			message: value["message"],
+			politeness: value["politeness"]
+		} : void 0;
+		case "Notice":
+		case "Failed": return typeof value["message"] === "string" ? {
+			_tag: value["_tag"],
+			message: value["message"]
+		} : void 0;
+		default: return;
+	}
+};
+/** "0:42", "12:05", "1:02:03". */
+var formatElapsed = (ms) => {
+	const total = Math.max(0, Math.round(ms / 1e3));
+	const hours = Math.floor(total / 3600);
+	const minutes = Math.floor(total % 3600 / 60);
+	const seconds = String(total % 60).padStart(2, "0");
+	return hours > 0 ? `${String(hours)}:${String(minutes).padStart(2, "0")}:${seconds}` : `${String(minutes)}:${seconds}`;
+};
+/** An ISO 8601 duration for `<time datetime>`: "PT1M5S". */
+var isoDuration = (ms) => {
+	const total = Math.max(0, Math.round(ms / 1e3));
+	const hours = Math.floor(total / 3600);
+	const minutes = Math.floor(total % 3600 / 60);
+	const seconds = total % 60;
+	return `PT${hours > 0 ? `${String(hours)}H` : ""}${minutes > 0 ? `${String(minutes)}M` : ""}${String(seconds)}S`;
+};
+var ASSIST_WORDS = {
+	hint: "hints",
+	check: "checks",
+	reveal: "reveals",
+	shuffle: "shuffles"
+};
+/** The assistance line for an outcome, from what the runner recorded, or null when there was none. */
+var assistLine = (outcome) => {
+	const undos = outcome.undosUsed ?? 0;
+	const kinds = new Set(outcome.assists ?? []);
+	if (undos > 0) kinds.add("undo");
+	const parts = ASSIST_KINDS.filter((kind) => kinds.has(kind)).map((kind) => kind === "undo" ? undos > 1 ? `${String(undos)} undos` : undos === 1 ? "1 undo" : "undo" : ASSIST_WORDS[kind]);
+	return parts.length === 0 ? null : `Assisted: ${parts.join(", ")}`;
+};
+var nameOf = (seats, seat) => seats.find((s) => s.id === seat)?.name ?? "Someone";
+/**
+* The results screen's words for an outcome. In a room the headline depends on who is
+* looking: `viewer` is the player's seat, or null for a spectator, who hears who won.
+*/
+var resultView = (outcome, seats, mode, viewer = null) => {
+	const winner = outcome.placements.find((p) => p.place === 1)?.seat;
+	const headline = (() => {
+		switch (outcome.result) {
+			case "won":
+				if (mode === "server") {
+					if (viewer === null) return `${nameOf(seats, winner)} wins!`;
+					return outcome.placements.find((p) => p.seat === viewer)?.place === 1 ? "You won!" : `${nameOf(seats, winner)} wins`;
+				}
+				return mode === "pass-and-play" ? `${nameOf(seats, winner)} wins!` : "You won!";
+			case "lost": return "You lost";
+			case "draw": return "It's a draw";
+			case "completed": return "Complete!";
+			case "abandoned": return "Game over";
+		}
+	})();
+	return {
+		result: outcome.result,
+		headline,
+		summary: outcome.summary,
+		elapsedMs: outcome.elapsedMs ?? null,
+		assisted: assistLine(outcome)
+	};
+};
+/** One preference control's change, parsed from its name and value, or undefined if invalid. */
+var parsePreferenceChange = (name, value, checked) => {
+	switch (name) {
+		case "reducedMotion": return value === "system" || value === "reduce" || value === "no-preference" ? { reducedMotion: value } : void 0;
+		case "theme": return value === "system" || value === "light" || value === "dark" ? { theme: value } : void 0;
+		case "sound": return checked === void 0 ? void 0 : { sound: checked };
+		case "singleKeyShortcuts": return checked === void 0 ? void 0 : { singleKeyShortcuts: checked };
+		case "aiContentAccepted": return checked === void 0 ? void 0 : { aiContentAccepted: checked };
+		case "volume": {
+			const percent = Number(value);
+			return value !== void 0 && value !== "" && Number.isInteger(percent) && percent >= 0 && percent <= 100 ? { volume: percent / 100 } : void 0;
+		}
+		default: return;
+	}
+};
+//#endregion
+export { AI_NOTICE, GUEST_NAME, MODES, MODE_LABELS, ONLINE_CHECKING, ONLINE_UNREACHABLE, accessGate, assistLine, clockLabel, clockOptions, clockValue, computerSeatsFor, defaultName, filledSeats, formatElapsed, hostedOnline, initialSetup, isLauncherGame, isRoomCode, isStoredPreferences, isoDuration, launcherGame, modeOptions, needsAiNotice, offerAnnouncement, offerText, parseClockValue, parseHostedGames, parsePreferenceChange, parseRoomCode, parseStageOutput, pickMode, playerCounts, resultView, seatsFor, spacedCode, startProblem, startingCount, toLocalMode, toStageMode };
+
+//# sourceMappingURL=model.js.map