@diffenderfer-games/hub 2.0.0-next.8 → 2.0.0-next.9

package/src/core/turns/your-turn-buzz.ts

@@ -1,69 +1,69 @@
-/**
- * "Your turn" buzz: a short vibration when this player becomes due in an
- * online game whose page they have open and visible (a phone held while
- * waiting). Every online game gets it from `TurnGame`, with no game code.
- *
- * It buzzes only when the player **becomes** due on a live update: not for
- * the next step of their own turn, not for a move they may make out of turn
- * (`mayAct`), not for a game they just opened or a catch-up after being
- * away, and not in a game they muted. It stays quiet when the player turned
- * it off (the menu's Settings, stored on this device), when the page asks
- * for less motion (the hub's `data-hub-motion="reduce"` or the system's
- * reduced motion), and where `navigator.vibrate` doesn't exist (iOS Safari).
- * A page can turn it off for itself (`hub.turns.setYourTurnBuzz(false)`) or
- * for one game (`TurnGame.setYourTurnBuzz(false)`).
- */
-import type { TurnSummary } from '@diffenderfer-games/hub-contract';
-
-/** The pattern: two short pulses, ms. */
-export const YOUR_TURN_BUZZ: readonly number[] = [60, 40, 60];
-
-/** Where this device keeps the player's choice (`off` turns it off). */
-export const YOUR_TURN_BUZZ_KEY = 'dg:your-turn-buzz';
-
-/** Whether going from `previous` to `next` makes this player newly due (the moment to buzz). */
-export function isNewlyDue(previous: Pick<TurnSummary, 'phase' | 'isMyTurn'>, next: Pick<TurnSummary, 'phase' | 'isMyTurn' | 'isMuted'>): boolean {
-  const wasDue = previous.phase === 'playing' && previous.isMyTurn;
-  return next.phase === 'playing' && next.isMyTurn && !wasDue && !next.isMuted;
-}
-
-/** The player's own switch on this device (on unless they turned it off). */
-export function readYourTurnBuzz(): boolean {
-  try {
-    return localStorage.getItem(YOUR_TURN_BUZZ_KEY) !== 'off';
-  } catch {
-    return true;
-  }
-}
-
-/** Save the player's switch on this device. */
-export function saveYourTurnBuzz(isOn: boolean): void {
-  try {
-    localStorage.setItem(YOUR_TURN_BUZZ_KEY, isOn ? 'on' : 'off');
-  } catch {
-    // No storage: it stays on.
-  }
-}
-
-/** Whether the page asks for less motion (the hub's setting, else the system's). */
-function prefersLessMotion(): boolean {
-  if (typeof document !== 'undefined' && document.documentElement.dataset.hubMotion === 'reduce') {
-    return true;
-  }
-  return typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;
-}
-
-/** Buzz now, when this page is visible and nothing says not to; fails silently. Answers whether it buzzed. */
-export function buzzYourTurn(): boolean {
-  if (typeof document === 'undefined' || document.visibilityState !== 'visible' || !readYourTurnBuzz() || prefersLessMotion()) {
-    return false;
-  }
-  if (typeof navigator === 'undefined' || typeof navigator.vibrate !== 'function') {
-    return false;
-  }
-  try {
-    return navigator.vibrate([...YOUR_TURN_BUZZ]);
-  } catch {
-    return false;
-  }
-}
+/**
+ * "Your turn" buzz: a short vibration when this player becomes due in an
+ * online game whose page they have open and visible (a phone held while
+ * waiting). Every online game gets it from `TurnGame`, with no game code.
+ *
+ * It buzzes only when the player **becomes** due on a live update: not for
+ * the next step of their own turn, not for a move they may make out of turn
+ * (`mayAct`), not for a game they just opened or a catch-up after being
+ * away, and not in a game they muted. It stays quiet when the player turned
+ * it off (the menu's Settings, stored on this device), when the page asks
+ * for less motion (the hub's `data-hub-motion="reduce"` or the system's
+ * reduced motion), and where `navigator.vibrate` doesn't exist (iOS Safari).
+ * A page can turn it off for itself (`hub.turns.setYourTurnBuzz(false)`) or
+ * for one game (`TurnGame.setYourTurnBuzz(false)`).
+ */
+import type { TurnSummary } from '@diffenderfer-games/hub-contract';
+
+/** The pattern: two short pulses, ms. */
+export const YOUR_TURN_BUZZ: readonly number[] = [60, 40, 60];
+
+/** Where this device keeps the player's choice (`off` turns it off). */
+export const YOUR_TURN_BUZZ_KEY = 'dg:your-turn-buzz';
+
+/** Whether going from `previous` to `next` makes this player newly due (the moment to buzz). */
+export function isNewlyDue(previous: Pick<TurnSummary, 'phase' | 'isMyTurn'>, next: Pick<TurnSummary, 'phase' | 'isMyTurn' | 'isMuted'>): boolean {
+  const wasDue = previous.phase === 'playing' && previous.isMyTurn;
+  return next.phase === 'playing' && next.isMyTurn && !wasDue && !next.isMuted;
+}
+
+/** The player's own switch on this device (on unless they turned it off). */
+export function readYourTurnBuzz(): boolean {
+  try {
+    return localStorage.getItem(YOUR_TURN_BUZZ_KEY) !== 'off';
+  } catch {
+    return true;
+  }
+}
+
+/** Save the player's switch on this device. */
+export function saveYourTurnBuzz(isOn: boolean): void {
+  try {
+    localStorage.setItem(YOUR_TURN_BUZZ_KEY, isOn ? 'on' : 'off');
+  } catch {
+    // No storage: it stays on.
+  }
+}
+
+/** Whether the page asks for less motion (the hub's setting, else the system's). */
+function prefersLessMotion(): boolean {
+  if (typeof document !== 'undefined' && document.documentElement.dataset.hubMotion === 'reduce') {
+    return true;
+  }
+  return typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;
+}
+
+/** Buzz now, when this page is visible and nothing says not to; fails silently. Answers whether it buzzed. */
+export function buzzYourTurn(): boolean {
+  if (typeof document === 'undefined' || document.visibilityState !== 'visible' || !readYourTurnBuzz() || prefersLessMotion()) {
+    return false;
+  }
+  if (typeof navigator === 'undefined' || typeof navigator.vibrate !== 'function') {
+    return false;
+  }
+  try {
+    return navigator.vibrate([...YOUR_TURN_BUZZ]);
+  } catch {
+    return false;
+  }
+}

package/src/core/version/client-version.gen.ts

@@ -1,3 +1,3 @@
 // Generated by tools/hub-client/generate.ts. Do not edit; run `npm run gen:hub-client`.
 /** This client's package version, sent as `x-hub-client` on REST calls and `client` in `hello`. */
-export const HUB_CLIENT_VERSION = '2.0.0-next.8';
+export const HUB_CLIENT_VERSION = '2.0.0-next.9';

package/src/doctor/checks.ts

@@ -15,8 +15,8 @@ export type FindingLevel = 'error' | 'warning' | 'info';
 export interface Finding {
   /** How serious it is. */
   readonly level: FindingLevel;
-  /** Which check found it: `version`, `vendored` or `manifest`. */
-  readonly check: 'version' | 'vendored' | 'manifest';
+  /** Which check found it: `version`, `vendored`, `manifest` or `world`. */
+  readonly check: 'version' | 'vendored' | 'manifest' | 'world';
   /** What to tell the developer, with the fix. */
   readonly message: string;
 }

package/src/doctor/cli.ts

@@ -11,7 +11,8 @@
  *   `/_api/version` (`--hub`, default `https://diffenderfer.games`): outside
  *   `supported` fails, `deprecated` warns (`--offline` skips this check);
  * - a stale vendored `src/hub/` copy or `scripts/sync-hub.mjs` warns;
- * - the `package.json` `game.*` block must match the contract's schema.
+ * - the `package.json` `game.*` block must match the contract's schema;
+ * - a `game.world.map` file must exist and be a valid `dg-world@1` map within the size limit.
  *
  * Exits 1 when any check fails.
  */
@@ -21,6 +22,7 @@ import { parseArgs } from 'node:util';
 import { HUB_CLIENT_VERSION } from '../core/version/client-version.gen';
 import { checkClientVersion, checkManifest, checkVendoredCopies, type Finding } from './checks';
 import { DEFAULT_HUB_TIMEOUT_MS, fetchHubVersion } from './hub-version-fetch';
+import { checkWorld } from './world-check';
 
 const DEFAULT_HUB_URL = 'https://diffenderfer.games';
 
@@ -79,7 +81,8 @@ async function runDoctor(options: DoctorOptions): Promise<Finding[]> {
   }
   findings.push(...checkVendoredCopies(options.gameDir));
   try {
-    findings.push(...checkManifest(readJsonFile(join(options.gameDir, 'package.json'))));
+    const packageJson = readJsonFile(join(options.gameDir, 'package.json'));
+    findings.push(...checkManifest(packageJson), ...checkWorld(options.gameDir, packageJson));
   } catch (failure) {
     findings.push({ level: 'error', check: 'manifest', message: `could not read package.json: ${failure instanceof Error ? failure.message : String(failure)}` });
   }

package/src/doctor/world-check.ts

@@ -0,0 +1,61 @@
+/**
+ * `hub-doctor`'s world check (docs/plans/world.md §14.6): a `game.world.map`
+ * file must exist inside the game, be within the size limit and be a valid
+ * `dg-world@1` map (the same `parseWorldMapText` the hub runs at load); a
+ * `game.world.generate.type` the hub doesn't know is a warning.
+ */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { GamePackageJson } from '@diffenderfer-games/hub-contract';
+import { BUILT_IN_WORLD_TYPES, WORLD_LIMITS, parseWorldMapText } from '@diffenderfer-games/world';
+import type { Finding } from './checks';
+
+/** The most map problems listed (the rest are counted). */
+const MAX_LISTED_PROBLEMS = 20;
+
+/** Checks the map file and world type `game.world` names. A manifest that doesn't parse is left to `checkManifest`. */
+// eslint-disable-next-line no-restricted-syntax -- trust boundary: the game's package.json, parsed by GamePackageJson next
+export function checkWorld(gameDir: string, packageJson: unknown): Finding[] {
+  const parsed = GamePackageJson.safeParse(packageJson);
+  const world = parsed.success ? parsed.data.game.world : undefined;
+  if (world === undefined) {
+    return [];
+  }
+  const findings: Finding[] = [];
+  const type = world.generate?.type;
+  if (type !== undefined && !BUILT_IN_WORLD_TYPES.some((known) => known.id === type)) {
+    findings.push({ level: 'warning', check: 'world', message: `game.world.generate.type: the hub has no world type "${type}"; use one of ${BUILT_IN_WORLD_TYPES.map((known) => known.id).join(', ')}` });
+  }
+  return world.map === undefined ? findings : [...findings, ...checkMapFile(gameDir, world.map)];
+}
+
+/** One map file's findings. */
+export function checkMapFile(gameDir: string, mapFile: string): Finding[] {
+  const path = join(gameDir, mapFile);
+  const error = (message: string): Finding => ({ level: 'error', check: 'world', message: `game.world.map (${mapFile}): ${message}` });
+  if (!existsSync(path) || !statSync(path).isFile()) {
+    return [error('the file does not exist (build or commit it)')];
+  }
+  const bytes = statSync(path).size;
+  if (bytes > WORLD_LIMITS.bytes) {
+    return [error(`${String(bytes)} bytes is over the ${String(WORLD_LIMITS.bytes)}-byte limit (save layers as "rle")`)];
+  }
+  const result = parseWorldMapText(readFileSync(path, 'utf8'));
+  const listed = result.problems.slice(0, MAX_LISTED_PROBLEMS).map((problem): Finding => ({
+    level: problem.severity === 'error' ? 'error' : 'warning',
+    check: 'world',
+    message: `game.world.map (${mapFile}): ${problem.message}`,
+  }));
+  const more = result.problems.length - listed.length;
+  if (more > 0) {
+    listed.push(error(`and ${String(more)} more problems`));
+  }
+  if (!result.ok) {
+    return listed;
+  }
+  const { map } = result;
+  return [...listed, {
+    level: 'info', check: 'world',
+    message: `game.world.map (${mapFile}) is a valid dg-world@1 map: ${map.title}, ${String(map.width)} × ${String(map.height)}, ${String(map.objects.length)} objects, ${String(bytes)} bytes`,
+  }];
+}

package/src/index.ts

@@ -1,68 +1,68 @@
-/**
- * `@diffenderfer-games/hub`: the hub client for games on diffenderfer.games.
- *
- * ```ts
- * import { hub } from '@diffenderfer-games/hub';
- *
- * const { user } = await hub.me();
- * await hub.putSave('auto', { level: 7, gold: 120 });
- * await hub.submitScore('highscore', 9001, { title: 'High Score' });
- * ```
- *
- * In a hosted game the slug and API base are detected from the page; use
- * {@link createHub} for others. Every call rejects with a {@link HubError}
- * when it fails, except the fire-and-forget analytics (`recordPlay`,
- * `heartbeat`, `event`). When the hub can't be reached, reads come from an
- * offline cache and writes are queued in an outbox until it is back; games
- * queue their own operations with `hub.offline` (docs: "Offline and replay").
- *
- * The page-wide namespaces hang off `hub` as lazy getters (`hub.input`,
- * `hub.daily`, `hub.resume`, `hub.saved`, `hub.social`, `hub.mp`, `hub.rooms`, `hub.race`), and each has
- * its own entry (`@diffenderfer-games/hub/input`, ...) for games that want
- * only that part.
- *
- * @packageDocumentation
- */
-export { createHub, Hub, hub } from './core/hub';
-export {
-  ContentRejectedError,
-  HubError,
-  OfflineError,
-  SAVE_UNKNOWN_CODE,
-  UNSUPPORTED_BY_HUB,
-  type HubErrorCode,
-  type HubErrorDetails,
-} from './core/errors';
-export type { SyncConflict, SyncResult } from './core/connection';
-export type { AuthResponse, ProfileUpdate, StatResult } from './core/hub-progress';
-export type { GrantBundle, TradeBundle, TradeId, TradeListOptions, TradeNoteOptions } from './core/hub-economy';
-export type { HubMenuControl } from './core/menu-control';
-export { HubResume, RESUME_DEBOUNCE_MS, RESUME_MAX_STATE_BYTES } from './core/resume/hub-resume';
-export { HubAvatar, type AvatarHost, type AvatarModule } from './core/avatar/hub-avatar';
-export type { AvatarChange, AvatarRef, DesignerResult, OpenDesignerOptions, RuntimeAvatarApi } from './core/avatar/avatar-types';
-export type { CarriesLook } from './core/avatar/avatar-ref';
-export type { ResumeBlocker, ResumeEntry, ResumeLoadOptions, ResumeProgress, ResumeRun, ResumeSaveInput } from './core/resume/resume-types';
-export { HubSaved, SAVED_CHANGE_QUIET_MS, type SavedChangeListener, type SavedOpenDetail, type SavedOpenHandler } from './core/saved/hub-saved';
-export { SAVED_CHANGE_EVENT, SAVED_KIND_PARAM, SAVED_OPEN_EVENT, SAVED_OPEN_PARAM, savedGameUrl } from './core/saved/saved-open';
-export type * from './core/saved/saved-types';
-export { HubTurns, TURN_LINK_PARAM, type TurnCreateOptions } from './core/turns/hub-turns';
-export { isNewlyDue, readYourTurnBuzz, saveYourTurnBuzz, YOUR_TURN_BUZZ, YOUR_TURN_BUZZ_KEY } from './core/turns/your-turn-buzz';
-export { TURN_CHAT_EVENT, TURN_EVENT, TURN_POLL_MS, TURN_QUIET_MS, TURN_RESYNC_EVENT, TurnGame, type TurnGameEvents, type TurnGameOptions, type TurnMoveEvent, type TurnOutcome } from './core/turns/turn-game';
-export type { OpenTurnGame, TurnChatLine, TurnDeadline, TurnGameView } from '@diffenderfer-games/hub-contract';
-export type { QueueOp, QueueOpInput, QueuedScoreOptions, ProfilePatch } from './core/offline/queue';
-export { OfflineApi } from './core/offline/offline-api';
-export { OUTBOX_FULL_CODE, type OfflineEventDetails, type OfflineEventName, type OfflineListener, type OfflineOp } from './core/offline/outbox';
-export type { OfflineHandler, OfflineKindDefinition, ReplayContext } from './core/offline/outbox-kinds';
-export { OUTBOX_MAX_CHARS, OUTBOX_MAX_ENTRIES } from './core/offline/outbox-store';
-export type { BufferedEvent } from './core/offline/events';
-export type { EndpointFields, EndpointName, EndpointReply } from './core/rest/endpoint-types';
-export { CLIENT_VERSION_HEADER } from './core/rest/rest-client';
-export type { ClientSupport } from './core/version/hub-version';
-export { HUB_CLIENT_VERSION } from './core/version/client-version.gen';
-export type * from './core/types';
-export * from './daily';
-export * from './input';
-export type * from './social';
-export type * from './mp';
-export type * from './race';
-export type * from './rooms';
+/**
+ * `@diffenderfer-games/hub`: the hub client for games on diffenderfer.games.
+ *
+ * ```ts
+ * import { hub } from '@diffenderfer-games/hub';
+ *
+ * const { user } = await hub.me();
+ * await hub.putSave('auto', { level: 7, gold: 120 });
+ * await hub.submitScore('highscore', 9001, { title: 'High Score' });
+ * ```
+ *
+ * In a hosted game the slug and API base are detected from the page; use
+ * {@link createHub} for others. Every call rejects with a {@link HubError}
+ * when it fails, except the fire-and-forget analytics (`recordPlay`,
+ * `heartbeat`, `event`). When the hub can't be reached, reads come from an
+ * offline cache and writes are queued in an outbox until it is back; games
+ * queue their own operations with `hub.offline` (docs: "Offline and replay").
+ *
+ * The page-wide namespaces hang off `hub` as lazy getters (`hub.input`,
+ * `hub.daily`, `hub.resume`, `hub.saved`, `hub.social`, `hub.mp`, `hub.rooms`, `hub.race`), and each has
+ * its own entry (`@diffenderfer-games/hub/input`, ...) for games that want
+ * only that part.
+ *
+ * @packageDocumentation
+ */
+export { createHub, Hub, hub } from './core/hub';
+export {
+  ContentRejectedError,
+  HubError,
+  OfflineError,
+  SAVE_UNKNOWN_CODE,
+  UNSUPPORTED_BY_HUB,
+  type HubErrorCode,
+  type HubErrorDetails,
+} from './core/errors';
+export type { SyncConflict, SyncResult } from './core/connection';
+export type { AuthResponse, ProfileUpdate, StatResult } from './core/hub-progress';
+export type { GrantBundle, TradeBundle, TradeId, TradeListOptions, TradeNoteOptions } from './core/hub-economy';
+export type { HubMenuControl } from './core/menu-control';
+export { HubResume, RESUME_DEBOUNCE_MS, RESUME_MAX_STATE_BYTES } from './core/resume/hub-resume';
+export { HubAvatar, type AvatarHost, type AvatarModule } from './core/avatar/hub-avatar';
+export type { AvatarChange, AvatarRef, DesignerResult, OpenDesignerOptions, RuntimeAvatarApi } from './core/avatar/avatar-types';
+export type { CarriesLook } from './core/avatar/avatar-ref';
+export type { ResumeBlocker, ResumeEntry, ResumeLoadOptions, ResumeProgress, ResumeRun, ResumeSaveInput } from './core/resume/resume-types';
+export { HubSaved, SAVED_CHANGE_QUIET_MS, type SavedChangeListener, type SavedOpenDetail, type SavedOpenHandler } from './core/saved/hub-saved';
+export { SAVED_CHANGE_EVENT, SAVED_KIND_PARAM, SAVED_OPEN_EVENT, SAVED_OPEN_PARAM, savedGameUrl } from './core/saved/saved-open';
+export type * from './core/saved/saved-types';
+export { HubTurns, TURN_LINK_PARAM, type TurnCreateOptions } from './core/turns/hub-turns';
+export { isNewlyDue, readYourTurnBuzz, saveYourTurnBuzz, YOUR_TURN_BUZZ, YOUR_TURN_BUZZ_KEY } from './core/turns/your-turn-buzz';
+export { TURN_CHAT_EVENT, TURN_EVENT, TURN_POLL_MS, TURN_QUIET_MS, TURN_RESYNC_EVENT, TurnGame, type TurnGameEvents, type TurnGameOptions, type TurnMoveEvent, type TurnOutcome } from './core/turns/turn-game';
+export type { OpenTurnGame, TurnChatLine, TurnDeadline, TurnGameView } from '@diffenderfer-games/hub-contract';
+export type { QueueOp, QueueOpInput, QueuedScoreOptions, ProfilePatch } from './core/offline/queue';
+export { OfflineApi } from './core/offline/offline-api';
+export { OUTBOX_FULL_CODE, type OfflineEventDetails, type OfflineEventName, type OfflineListener, type OfflineOp } from './core/offline/outbox';
+export type { OfflineHandler, OfflineKindDefinition, ReplayContext } from './core/offline/outbox-kinds';
+export { OUTBOX_MAX_CHARS, OUTBOX_MAX_ENTRIES } from './core/offline/outbox-store';
+export type { BufferedEvent } from './core/offline/events';
+export type { EndpointFields, EndpointName, EndpointReply } from './core/rest/endpoint-types';
+export { CLIENT_VERSION_HEADER } from './core/rest/rest-client';
+export type { ClientSupport } from './core/version/hub-version';
+export { HUB_CLIENT_VERSION } from './core/version/client-version.gen';
+export type * from './core/types';
+export * from './daily';
+export * from './input';
+export type * from './social';
+export type * from './mp';
+export type * from './race';
+export type * from './rooms';

package/src/realtime/runtime-api.ts

@@ -8,14 +8,15 @@ import type { HubMpApi, InviteLinkMethods } from './multiplayer-types';
 import type { HubRaceApi } from './race-types';
 import type { HubRoomsApi, RoomReclaimMethods } from './room-types';
 import type { HubNotifyApi, HubPresenceApi, HubSocialApi, PlayOnlineMethods } from './social-types';
+import type { RuntimeWorldApi } from './world-types';
 
 /**
  * The realtime feature version the runtime reports in {@link RealtimeApi.version}.
  * 2 added races; 3 added invite links and taking back a held seat; 4 added
- * "Play online" (tournaments); 5 added avatars (the designer and `ev:avatar`).
+ * "Play online" (tournaments); 5 added avatars (the designer and `ev:avatar`); 6 added the world (`world`).
  * A client feature-detects newer additions with it (or by the optional method).
  */
-export const REALTIME_FEATURE_VERSION = 5;
+export const REALTIME_FEATURE_VERSION = 6;
 
 /** `hub.social` as a runtime installs it: version 4's `openPlayOnline` is missing on older runtimes. */
 export type RuntimeSocialApi = Omit<HubSocialApi, keyof PlayOnlineMethods> & Partial<PlayOnlineMethods>;
@@ -68,4 +69,6 @@ export interface RealtimeApi {
   race?: HubRaceApi;
   /** Avatars: the designer and live changes (feature version 5 and later). */
   avatar?: RuntimeAvatarApi;
+  /** The world's ops and events (feature version 6 and later). */
+  world?: RuntimeWorldApi;
 }

package/src/realtime/types.ts

@@ -51,3 +51,4 @@ export type * from './multiplayer-types';
 export type * from './room-types';
 export type * from './race-types';
 export type { RealtimeApi } from './runtime-api';
+export type { RuntimeWorldApi, WorldEventName, WorldOpName } from './world-types';

package/src/realtime/world-types.ts

@@ -0,0 +1,20 @@
+/**
+ * The world over the runtime's socket (docs/plans/world.md §8.3): the
+ * `world.*` ops and events, typed from the contract. The hub's world client
+ * calls it; games don't need it.
+ */
+import type { EventData, EventName, events, OpAck, OpInput, OpName, ops } from '@diffenderfer-games/hub-contract';
+
+/** A `world.*` op name. */
+export type WorldOpName = Extract<OpName, `world.${string}`>;
+
+/** A `world.*` event name. */
+export type WorldEventName = Extract<EventName, `world.${string}`>;
+
+/** `rt.world` (realtime feature version 6 and later). */
+export interface RuntimeWorldApi {
+  /** Send a world op on the page's socket; rejects with the hub's refusal. */
+  op<Name extends WorldOpName>(name: Name, input: OpInput<(typeof ops)[Name]>): Promise<OpAck<(typeof ops)[Name]>>;
+  /** Hear a world event; returns the unsubscribe. */
+  on<Name extends WorldEventName>(name: Name, listener: (payload: EventData<(typeof events)[Name]>) => void): () => void;
+}

package/src/turns-rules.ts

@@ -1,12 +1,12 @@
-/**
- * `@diffenderfer-games/hub/turns-rules`: what an online turn game's rules
- * module imports (docs/multiplayer.md §16): `defineTurnRules` to type the
- * rules object, the rules contract's types, and the seeded RNG the hub
- * hands the rules. Nothing else comes with it (no zod, no client), so a
- * rules bundle that imports it stays a few KB. The conformance kit for
- * tests is `@diffenderfer-games/hub/turns`.
- *
- * @packageDocumentation
- */
-export { createTurnRng, defineTurnRules, turnRngStateFromSeed } from '@diffenderfer-games/hub-contract/turns-rules';
-export type { TurnApplyResult, TurnOutcome, TurnProgress, TurnRng, TurnRngState, TurnRules, TurnSetupContext } from '@diffenderfer-games/hub-contract/turns-rules';
+/**
+ * `@diffenderfer-games/hub/turns-rules`: what an online turn game's rules
+ * module imports (docs/multiplayer.md §16): `defineTurnRules` to type the
+ * rules object, the rules contract's types, and the seeded RNG the hub
+ * hands the rules. Nothing else comes with it (no zod, no client), so a
+ * rules bundle that imports it stays a few KB. The conformance kit for
+ * tests is `@diffenderfer-games/hub/turns`.
+ *
+ * @packageDocumentation
+ */
+export { createTurnRng, defineTurnRules, turnRngStateFromSeed } from '@diffenderfer-games/hub-contract/turns-rules';
+export type { TurnApplyResult, TurnOutcome, TurnProgress, TurnRng, TurnRngState, TurnRules, TurnSetupContext } from '@diffenderfer-games/hub-contract/turns-rules';