@joystyk/launcher 0.0.0 → 0.2.0

package/dist/fixture/module.js

@@ -0,0 +1,135 @@
+import { tallyEngine } from "./engine.js";
+import { tallyProbe } from "./probe.js";
+//#region src/fixture/module.ts
+var STYLES = `
+  :host { display: block; }
+  section {
+    display: grid;
+    gap: 0.75rem;
+    padding: 1rem;
+    border-radius: 0.75rem;
+    background: var(--game-surface, Canvas);
+    color: var(--game-ink, CanvasText);
+    font: inherit;
+  }
+  h3 { margin: 0; color: var(--game-accent, currentColor); }
+  p, ul { margin: 0; }
+  .moves { display: flex; flex-wrap: wrap; gap: 0.5rem; }
+  button {
+    min-block-size: 2.75rem;
+    padding-inline: 1rem;
+    border: 2px solid var(--game-accent, currentColor);
+    border-radius: 0.5rem;
+    background: transparent;
+    color: inherit;
+    font: inherit;
+    cursor: pointer;
+  }
+  .scores li { transition: color 300ms ease-out; }
+  :host([data-reduced-motion]) .scores li { transition: none; }
+`;
+var describeTurn = (view, snapshot) => {
+	if (view.winner !== null) return `${view.names[view.winner] ?? "Someone"} reached ${String(view.target)}.`;
+	if (snapshot.meta.outcome !== null) return "Game over.";
+	return `${view.names[view.turn] ?? "Someone"} to play.`;
+};
+var tallyModule = {
+	engine: tallyEngine,
+	migrations: [],
+	mount(slot, anySession, platform) {
+		const session = anySession;
+		tallyProbe.mounts += 1;
+		const host = document.createElement("div");
+		host.className = "tally-board";
+		host.dataset["fixtureRelease"] = typeof __JOYSTYK_RELEASE__ === "string" ? __JOYSTYK_RELEASE__ : "unversioned";
+		const root = host.attachShadow({ mode: "open" });
+		const sheet = new CSSStyleSheet();
+		sheet.replaceSync(STYLES);
+		root.adoptedStyleSheets = [sheet];
+		root.innerHTML = `<section aria-labelledby="tally-title">
+      <h3 id="tally-title"></h3>
+      <ul class="scores"></ul>
+      <p class="secret"></p>
+      <p class="turn"></p>
+      <div class="moves">
+        <button type="button" data-amount="1">Add 1</button>
+        <button type="button" data-amount="2">Add 2</button>
+        <button type="button" data-hint>Hint</button>
+        <button type="button" data-quit>Quit</button>
+      </div>
+    </section>`;
+		slot.append(host);
+		const q = (selector) => root.querySelector(selector);
+		let preferences = platform.preferences.get();
+		let mySeat = null;
+		let canMove = false;
+		const add = (amount) => {
+			if (canMove) session.dispatch({
+				kind: "command",
+				command: {
+					type: "add",
+					amount
+				}
+			});
+		};
+		const render = (snapshot) => {
+			const view = snapshot.view;
+			mySeat = snapshot.meta.seat;
+			canMove = mySeat !== null && snapshot.pending.includes(mySeat) && snapshot.meta.outcome === null && !snapshot.paused;
+			q("h3").textContent = `First to ${String(view.target)}`;
+			q(".scores").replaceChildren(...view.scores.map((score, seat) => {
+				const li = document.createElement("li");
+				li.textContent = `${view.names[seat] ?? `Seat ${String(seat + 1)}`}: ${String(score)}`;
+				return li;
+			}));
+			q(".secret").textContent = view.secret === null ? "" : `Your secret number is ${String(view.secret)}.`;
+			q(".turn").textContent = describeTurn(view, snapshot);
+			for (const button of root.querySelectorAll("[data-amount], [data-hint]")) button.disabled = !canMove;
+			for (const beat of snapshot.beats) if (beat.event.type === "added") platform.announce(`${view.names[beat.event.seat] ?? "Someone"} adds ${String(beat.event.amount)}.`, "polite");
+		};
+		const applyPreferences = (next) => {
+			preferences = next;
+			tallyProbe.preferences.push(next);
+			host.toggleAttribute("data-reduced-motion", next.reducedMotion);
+		};
+		applyPreferences(preferences);
+		const onClick = (event) => {
+			const button = event.target.closest("button");
+			if (button === null) return;
+			if (button.dataset["amount"] !== void 0) add(button.dataset["amount"] === "2" ? 2 : 1);
+			else if (button.hasAttribute("data-hint")) session.dispatch({
+				kind: "command",
+				command: { type: "hint" }
+			});
+			else if (button.hasAttribute("data-quit")) platform.requestExit();
+		};
+		const onKey = (event) => {
+			if (!preferences.singleKeyShortcuts || event.ctrlKey || event.metaKey || event.altKey) return;
+			if (event.key === "1" || event.key === "2") add(event.key === "2" ? 2 : 1);
+		};
+		root.addEventListener("click", onClick);
+		host.addEventListener("keydown", onKey);
+		const stopSession = session.subscribe(render);
+		const stopPreferences = platform.preferences.subscribe(applyPreferences);
+		platform.storage.get("plays").then(async (stored) => {
+			const plays = (typeof stored === "number" ? stored : 0) + 1;
+			tallyProbe.plays.push(plays);
+			await platform.storage.set("plays", plays);
+		});
+		let disposed = false;
+		return { dispose: () => {
+			if (disposed) return;
+			disposed = true;
+			tallyProbe.disposals += 1;
+			stopSession();
+			stopPreferences();
+			root.removeEventListener("click", onClick);
+			host.removeEventListener("keydown", onKey);
+			host.remove();
+		} };
+	}
+};
+//#endregion
+export { tallyModule };
+
+//# sourceMappingURL=module.js.map

package/dist/fixture/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","names":[],"sources":["../../src/fixture/module.ts"],"sourcesContent":["// Tally's canvas: what a game's module looks like to the launcher. It draws into the slot it\n// is given and nothing else, reads the theme tokens the frame hands the canvas, talks to the\n// platform only through PlatformApi, and records what it saw in `tallyProbe` for tests.\nimport type { GameModule, GameSession, Json, Preferences, SeatId } from '@joystyk/contracts';\nimport type { LocalInput, LocalSnapshot } from '@joystyk/session';\nimport { tallyEngine, type TallyCommand, type TallyEvent, type TallyView } from './engine.ts';\nimport { tallyProbe } from './probe.ts';\n\ntype TallySession = GameSession<LocalSnapshot<TallyView, TallyEvent>, LocalInput<TallyCommand>>;\n\nconst STYLES = `\n  :host { display: block; }\n  section {\n    display: grid;\n    gap: 0.75rem;\n    padding: 1rem;\n    border-radius: 0.75rem;\n    background: var(--game-surface, Canvas);\n    color: var(--game-ink, CanvasText);\n    font: inherit;\n  }\n  h3 { margin: 0; color: var(--game-accent, currentColor); }\n  p, ul { margin: 0; }\n  .moves { display: flex; flex-wrap: wrap; gap: 0.5rem; }\n  button {\n    min-block-size: 2.75rem;\n    padding-inline: 1rem;\n    border: 2px solid var(--game-accent, currentColor);\n    border-radius: 0.5rem;\n    background: transparent;\n    color: inherit;\n    font: inherit;\n    cursor: pointer;\n  }\n  .scores li { transition: color 300ms ease-out; }\n  :host([data-reduced-motion]) .scores li { transition: none; }\n`;\n\n// The site's two-release test needs genuinely different lazy game bytes, rather\n// than relying on incidental changes in the shell's shared dependency hashes.\ndeclare const __JOYSTYK_RELEASE__: string;\n\nconst describeTurn = (view: TallyView, snapshot: LocalSnapshot<TallyView, TallyEvent>): string => {\n  if (view.winner !== null) return `${view.names[view.winner] ?? 'Someone'} reached ${String(view.target)}.`;\n  if (snapshot.meta.outcome !== null) return 'Game over.';\n  return `${view.names[view.turn] ?? 'Someone'} to play.`;\n};\n\nexport const tallyModule: GameModule<HTMLElement> = {\n  engine: tallyEngine,\n  migrations: [],\n  mount(slot, anySession, platform) {\n    // The launcher built this session from Tally's own engine, so its types are Tally's.\n    const session = anySession as unknown as TallySession;\n    tallyProbe.mounts += 1;\n\n    const host = document.createElement('div');\n    host.className = 'tally-board';\n    host.dataset['fixtureRelease'] = typeof __JOYSTYK_RELEASE__ === 'string' ? __JOYSTYK_RELEASE__ : 'unversioned';\n    const root = host.attachShadow({ mode: 'open' });\n    const sheet = new CSSStyleSheet();\n    sheet.replaceSync(STYLES);\n    root.adoptedStyleSheets = [sheet];\n    root.innerHTML = `<section aria-labelledby=\"tally-title\">\n      <h3 id=\"tally-title\"></h3>\n      <ul class=\"scores\"></ul>\n      <p class=\"secret\"></p>\n      <p class=\"turn\"></p>\n      <div class=\"moves\">\n        <button type=\"button\" data-amount=\"1\">Add 1</button>\n        <button type=\"button\" data-amount=\"2\">Add 2</button>\n        <button type=\"button\" data-hint>Hint</button>\n        <button type=\"button\" data-quit>Quit</button>\n      </div>\n    </section>`;\n    slot.append(host);\n\n    const q = <E extends Element>(selector: string): E => root.querySelector(selector) as E;\n    let preferences = platform.preferences.get();\n    let mySeat: SeatId | null = null;\n    let canMove = false;\n\n    const add = (amount: 1 | 2): void => {\n      if (canMove) session.dispatch({ kind: 'command', command: { type: 'add', amount } });\n    };\n\n    const render = (snapshot: LocalSnapshot<TallyView, TallyEvent>): void => {\n      const view = snapshot.view;\n      mySeat = snapshot.meta.seat;\n      canMove =\n        mySeat !== null && snapshot.pending.includes(mySeat) && snapshot.meta.outcome === null && !snapshot.paused;\n      q('h3').textContent = `First to ${String(view.target)}`;\n      const scores = q('.scores');\n      scores.replaceChildren(\n        ...view.scores.map((score, seat) => {\n          const li = document.createElement('li');\n          li.textContent = `${view.names[seat] ?? `Seat ${String(seat + 1)}`}: ${String(score)}`;\n          return li;\n        }),\n      );\n      q('.secret').textContent = view.secret === null ? '' : `Your secret number is ${String(view.secret)}.`;\n      q('.turn').textContent = describeTurn(view, snapshot);\n      for (const button of root.querySelectorAll<HTMLButtonElement>('[data-amount], [data-hint]'))\n        button.disabled = !canMove;\n      for (const beat of snapshot.beats) {\n        if (beat.event.type === 'added') {\n          platform.announce(`${view.names[beat.event.seat] ?? 'Someone'} adds ${String(beat.event.amount)}.`, 'polite');\n        }\n      }\n    };\n\n    const applyPreferences = (next: Preferences): void => {\n      preferences = next;\n      tallyProbe.preferences.push(next);\n      host.toggleAttribute('data-reduced-motion', next.reducedMotion);\n    };\n    applyPreferences(preferences);\n\n    const onClick = (event: Event): void => {\n      const button = (event.target as Element).closest('button');\n      if (button === null) return;\n      if (button.dataset['amount'] !== undefined) add(button.dataset['amount'] === '2' ? 2 : 1);\n      else if (button.hasAttribute('data-hint')) session.dispatch({ kind: 'command', command: { type: 'hint' } });\n      else if (button.hasAttribute('data-quit')) platform.requestExit();\n    };\n    const onKey = (event: KeyboardEvent): void => {\n      // Single-key shortcuts honor the player's preference (WCAG 2.1.4).\n      if (!preferences.singleKeyShortcuts || event.ctrlKey || event.metaKey || event.altKey) return;\n      if (event.key === '1' || event.key === '2') add(event.key === '2' ? 2 : 1);\n    };\n    root.addEventListener('click', onClick);\n    host.addEventListener('keydown', onKey);\n    const stopSession = session.subscribe(render);\n    const stopPreferences = platform.preferences.subscribe(applyPreferences);\n\n    void platform.storage.get('plays').then(async (stored: Json | null) => {\n      const plays = (typeof stored === 'number' ? stored : 0) + 1;\n      tallyProbe.plays.push(plays);\n      await platform.storage.set('plays', plays);\n    });\n\n    let disposed = false;\n    return {\n      dispose: () => {\n        if (disposed) return;\n        disposed = true;\n        tallyProbe.disposals += 1;\n        stopSession();\n        stopPreferences();\n        root.removeEventListener('click', onClick);\n        host.removeEventListener('keydown', onKey);\n        host.remove();\n      },\n    };\n  },\n};\n"],"mappings":"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"}

package/dist/fixture/probe.d.ts

@@ -0,0 +1,10 @@
+import type { Preferences } from '@joystyk/contracts';
+export declare const tallyProbe: {
+    mounts: number;
+    disposals: number;
+    /** Every preferences value the game received, first the current one. */
+    preferences: Preferences[];
+    /** The `plays` counter read from the game's scoped storage at each mount. */
+    plays: number[];
+    reset(): void;
+};

package/dist/fixture/probe.js

@@ -0,0 +1,19 @@
+//#region src/fixture/probe.ts
+var tallyProbe = {
+	mounts: 0,
+	disposals: 0,
+	/** Every preferences value the game received, first the current one. */
+	preferences: [],
+	/** The `plays` counter read from the game's scoped storage at each mount. */
+	plays: [],
+	reset() {
+		this.mounts = 0;
+		this.disposals = 0;
+		this.preferences = [];
+		this.plays = [];
+	}
+};
+//#endregion
+export { tallyProbe };
+
+//# sourceMappingURL=probe.js.map

package/dist/fixture/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","names":[],"sources":["../../src/fixture/probe.ts"],"sourcesContent":["// What the mounted Tally fixture observed. Kept apart from module.ts so the module stays a\n// lazily loaded chunk while tests import the probe directly.\nimport type { Preferences } from '@joystyk/contracts';\n\nexport const tallyProbe = {\n  mounts: 0,\n  disposals: 0,\n  /** Every preferences value the game received, first the current one. */\n  preferences: [] as Preferences[],\n  /** The `plays` counter read from the game's scoped storage at each mount. */\n  plays: [] as number[],\n  reset(): void {\n    this.mounts = 0;\n    this.disposals = 0;\n    this.preferences = [];\n    this.plays = [];\n  },\n};\n"],"mappings":";AAIA,IAAa,aAAa;CACxB,QAAQ;CACR,WAAW;;CAEX,aAAa,CAAC;;CAEd,OAAO,CAAC;CACR,QAAc;EACZ,KAAK,SAAS;EACd,KAAK,YAAY;EACjB,KAAK,cAAc,CAAC;EACpB,KAAK,QAAQ,CAAC;CAChB;AACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { freshState, isSafePoint, Launcher, stageLoader, type LauncherMsg, type LauncherProps, type LauncherState, type Phase, } from './launcher.js';
+export { accessGate, assistLine, defaultName, formatElapsed, GUEST_NAME, initialSetup, isLauncherGame, isoDuration, isStoredPreferences, launcherGame, MODE_LABELS, modeOptions, parsePreferenceChange, parseStageOutput, pickMode, playerCounts, resultView, computerSeatsFor, seatsFor, toLocalMode, type Begin, type FrameState, type GameStatus, type LauncherGame, type ModeOption, type ResultView, type SaveSummary, type Setup, type StageControl, type StageOutput, } from './model.js';
+export { reportSafePoint, requestSave, SAFE_POINT_EVENT, safePointDriver, SAVE_REQUEST_EVENT, watchSafePoints, type SafePointDetail, type SaveRequestDetail, } from './safe-point.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+import { SAFE_POINT_EVENT, SAVE_REQUEST_EVENT, reportSafePoint, requestSave, safePointDriver, watchSafePoints } from "./safe-point.js";
+import { GUEST_NAME, MODE_LABELS, accessGate, assistLine, computerSeatsFor, defaultName, formatElapsed, initialSetup, isLauncherGame, isStoredPreferences, isoDuration, launcherGame, modeOptions, parsePreferenceChange, parseStageOutput, pickMode, playerCounts, resultView, seatsFor, toLocalMode } from "./model.js";
+import { Launcher, freshState, isSafePoint, stageLoader } from "./launcher.js";
+export { GUEST_NAME, Launcher, MODE_LABELS, SAFE_POINT_EVENT, SAVE_REQUEST_EVENT, accessGate, assistLine, computerSeatsFor, defaultName, formatElapsed, freshState, initialSetup, isLauncherGame, isSafePoint, isStoredPreferences, isoDuration, launcherGame, modeOptions, parsePreferenceChange, parseStageOutput, pickMode, playerCounts, reportSafePoint, requestSave, resultView, safePointDriver, seatsFor, stageLoader, toLocalMode, watchSafePoints };

package/dist/launcher.d.ts

@@ -0,0 +1,190 @@
+import { type Json, type Mode, type SeatInfo } from '@joystyk/contracts';
+import type { StoredPreferences } from '@joystyk/storage';
+import '@joystyk/ui/ad-slot';
+import { type Begin, type DailyFrame, type FrameState, type LauncherGame, type OnlineRooms, type ResultView, type RoomFrame, type RoomPlan, type RoomRequest, type SaveSummary, type Setup, type StageOutput } from './model.js';
+import './report-problem.ts';
+export type Phase = {
+    readonly _tag: 'Setup';
+} | {
+    readonly _tag: 'Loading';
+}
+/** D-44: an AI-content game waits for the player to accept the notice. */
+ | {
+    readonly _tag: 'AiNotice';
+    readonly save: SaveSummary | null;
+} | {
+    readonly _tag: 'Resume';
+    readonly save: SaveSummary;
+}
+/** Online with friends: the room is open and its match hasn't started. */
+ | {
+    readonly _tag: 'Lobby';
+} | {
+    readonly _tag: 'Playing';
+    readonly frame: FrameState | null;
+    readonly menu: boolean;
+}
+/**
+ * The game is over. Its canvas stays mounted with the final board; `shown` says whether the
+ * results dialog is open over it (the canvas is inert then) or closed for a look at the board.
+ */
+ | {
+    readonly _tag: 'Results';
+    readonly result: ResultView;
+    readonly shown: boolean;
+} | {
+    readonly _tag: 'Failed';
+    readonly message: string;
+};
+export type LauncherState = {
+    /** True once hydrated; exposed as `:state(live)`. */
+    readonly live: boolean;
+    readonly setup: Setup;
+    readonly phase: Phase;
+    /** Counts games started here; each gets a fresh stage element. */
+    readonly round: number;
+    /** The stage element's code has loaded. */
+    readonly stageReady: boolean;
+    readonly seats: readonly SeatInfo[];
+    readonly begin: Begin;
+    readonly resumeSlot: string | null;
+    readonly reveals: number;
+    readonly preferences: StoredPreferences | null;
+    /** The frame's live regions. */
+    readonly polite: string;
+    readonly assertive: string;
+    /** A message about the last game or save, shown on the setup and play screens. */
+    readonly notice: string | null;
+    /** The safe point last reported to the page. */
+    readonly safe: boolean;
+    /** The config this round starts with: null for the game's own setup, or a rematch's. */
+    readonly config: Json | null;
+    /** The config "Play again" starts with, when the finished game's engine named one. */
+    readonly rematch: Json | null;
+    /** Online with friends: how this round opens its room, or null for local play. */
+    readonly plan: RoomPlan | null;
+    /** The room as the stage last reported it. */
+    readonly room: RoomFrame | null;
+    /** The daily puzzle's results: streaks and share text, once the stage has recorded them. */
+    readonly daily: DailyFrame | null;
+    /** The puzzle this round plays, when the stage names it (a daily puzzle), for "Report a problem". */
+    readonly puzzle: string | null;
+    /** Which games the room server hosts, as it last answered (the same for every game page). */
+    readonly online: OnlineRooms;
+};
+export type LauncherMsg = {
+    readonly _tag: 'PickMode';
+    readonly mode: Mode;
+} | {
+    readonly _tag: 'PickLevel';
+    readonly level: string;
+} | {
+    readonly _tag: 'PickPlayers';
+    readonly players: number;
+} | {
+    readonly _tag: 'Rename';
+    readonly seat: number;
+    readonly name: string;
+} | {
+    readonly _tag: 'PickGameOption';
+    readonly key: string;
+    readonly value: string;
+    readonly checked: boolean | undefined;
+} | {
+    readonly _tag: 'Start';
+} | {
+    readonly _tag: 'StageLoaded';
+} | {
+    readonly _tag: 'StageOut';
+    readonly out: StageOutput;
+} | {
+    readonly _tag: 'AcceptAiNotice';
+} | {
+    readonly _tag: 'Resume';
+} | {
+    readonly _tag: 'ChooseSave';
+    readonly slot: string;
+} | {
+    readonly _tag: 'NewGame';
+} | {
+    readonly _tag: 'Reveal';
+} | {
+    readonly _tag: 'OpenMenu';
+} | {
+    readonly _tag: 'CloseMenu';
+} | {
+    readonly _tag: 'MenuClosed';
+} | {
+    readonly _tag: 'SetPreference';
+    readonly changes: Partial<StoredPreferences>;
+} | {
+    readonly _tag: 'Exit';
+} | {
+    readonly _tag: 'PlayAgain';
+} | {
+    readonly _tag: 'ChangeMode';
+}
+/** Close the results to look at the final board (Escape, or "Review the board"). */
+ | {
+    readonly _tag: 'HideResults';
+} | {
+    readonly _tag: 'ShowResults';
+}
+/** Online with friends: the join form, the invite in the address bar, and lobby requests. */
+ | {
+    readonly _tag: 'TypeCode';
+    readonly code: string;
+} | {
+    readonly _tag: 'ToggleWatch';
+    readonly watch: boolean;
+} | {
+    readonly _tag: 'JoinRoom';
+} | {
+    readonly _tag: 'InviteFound';
+    readonly code: string;
+}
+/** The room server's answer: which games it hosts, or that it can't be reached. */
+ | {
+    readonly _tag: 'OnlineChecked';
+    readonly online: OnlineRooms;
+}
+/** D-61: ask to end the match early, or answer the room's open offer. */
+ | {
+    readonly _tag: 'OfferEnd';
+} | {
+    readonly _tag: 'RoomRequest';
+    readonly request: RoomRequest;
+} | {
+    readonly _tag: 'AnswerOffer';
+    readonly answer: 'accept' | 'decline' | 'withdraw';
+} | {
+    readonly _tag: 'Copy';
+    readonly what: 'link' | 'code';
+} | {
+    readonly _tag: 'Copied';
+    readonly what: 'link' | 'code';
+    readonly ok: boolean;
+}
+/** The daily results: share (or copy) the emoji form, or copy the words form. */
+ | {
+    readonly _tag: 'Share';
+    readonly form: 'symbols' | 'words';
+} | {
+    readonly _tag: 'Shared';
+    readonly form: 'symbols' | 'words';
+    readonly how: 'shared' | 'copied' | 'cancelled' | 'failed';
+};
+export type LauncherProps = {
+    readonly game: LauncherGame;
+};
+/** Loads and registers `<jy-game-stage>` on first Start, so pages pay for it only when played. */
+export declare const stageLoader: import("@gyral/core").Driver<undefined, void, string>;
+export declare const freshState: (game: LauncherGame, live?: boolean, online?: OnlineRooms) => LauncherState;
+/** Whether an update could be offered now (offline-and-updates.md, Rule 2). */
+export declare const isSafePoint: (phase: Phase) => boolean;
+export declare const Launcher: import("@gyral/core").GyralElementClass<LauncherState, LauncherMsg, LauncherProps, never, "Resume" | "PickMode" | "PickLevel" | "PickPlayers" | "Rename" | "PickGameOption" | "Start" | "StageOut" | "AcceptAiNotice" | "ChooseSave" | "NewGame" | "Reveal" | "OpenMenu" | "CloseMenu" | "MenuClosed" | "SetPreference" | "Exit" | "PlayAgain" | "ChangeMode" | "HideResults" | "ShowResults" | "TypeCode" | "ToggleWatch" | "JoinRoom" | "OfferEnd" | "AnswerOffer" | "Copy" | "Share" | "ToggleReady" | "StartMatch" | "PickClock" | "PickRoomLevel" | "FillSeat" | "RemoveSeat" | "RoomAction">;
+declare global {
+    interface HTMLElementTagNameMap {
+        'jy-launcher': InstanceType<typeof Launcher>;
+    }
+}