@dreamboard-games/ui-sdk 0.0.41

package/dist/types/player-state.d.ts

@@ -0,0 +1,337 @@
+import type { ViewCard } from "@dreamboard/sdk-types";
+import type { PlayerId, CardId, CardIdsByDeckId, CardProperties, EdgeTypeId, VertexTypeId, BoardBaseId, BoardId, BoardRef, PerPlayer, PerPlayerBoardRef, PieceId, PieceTypeId, SharedBoardRef, SpaceId, SpaceTypeId, DieId } from "@dreamboard/manifest-contract";
+export type { BoardRef, PerPlayer, PerPlayerBoardRef, SharedBoardRef };
+/**
+ * Hands are keyed by the authored hand id and split per seat. The per-seat
+ * entries are populated from the runtime seat list, not the static manifest
+ * upper bound, so views always match what the backend actually computed.
+ */
+type CardIdsByHandId = Record<string, PerPlayer<CardId[]>>;
+type StateName = string;
+type TilePropertiesByBoardId = Record<BoardId, Record<string, unknown>>;
+type EdgePropertiesByBoardId = Record<BoardId, Record<string, unknown>>;
+type VertexPropertiesByBoardId = Record<BoardId, Record<string, unknown>>;
+export interface Player {
+    /** Player ID */
+    playerId: PlayerId;
+    /** Player display name */
+    name: string;
+    /** Whether this player is the host */
+    isHost?: boolean;
+    /** Player's assigned color */
+    color?: string;
+}
+export interface HexTileState<B extends string = BoardId, SpaceIdValue extends SpaceId = SpaceId, Properties = B extends keyof TilePropertiesByBoardId ? TilePropertiesByBoardId[B] : undefined, View = unknown> {
+    /** Unique tile identifier */
+    id: SpaceIdValue;
+    /** Axial coordinate Q */
+    q: number;
+    /** Axial coordinate R */
+    r: number;
+    /** Tile type identifier for rendering */
+    typeId?: SpaceTypeId;
+    /** Display label on the tile */
+    label?: string;
+    /** Player ID who owns this tile */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: Properties;
+    /**
+     * Optional view-projection overlay merged onto the static topology by
+     * `createHexBoardView` / `useHexBoardView`. Authored boards can also
+     * supply this directly when building tiles by hand.
+     */
+    view?: View;
+}
+/** State of an edge on a reducer-projected hex board. */
+export interface HexEdgeState<B extends string = BoardId, SpaceIdValue extends SpaceId = SpaceId, EdgeIdValue extends string = string, Properties = B extends keyof EdgePropertiesByBoardId ? EdgePropertiesByBoardId[B] : undefined> {
+    /** Unique edge identifier (serialized string, e.g., "tile1-tile2") */
+    id: EdgeIdValue;
+    /** First hex tile ID this edge borders */
+    hex1: SpaceIdValue;
+    /** Second hex tile ID this edge borders */
+    hex2: SpaceIdValue;
+    /** Edge type identifier for rendering */
+    typeId?: EdgeTypeId;
+    /** Display label for setup or rendering */
+    label?: string;
+    /** Player ID who owns this edge */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: Properties;
+}
+/** State of a vertex on a reducer-projected hex board. */
+export interface HexVertexState<B extends string = BoardId, SpaceIdValue extends SpaceId = SpaceId, VertexIdValue extends string = string, Properties = B extends keyof VertexPropertiesByBoardId ? VertexPropertiesByBoardId[B] : undefined> {
+    /** Unique vertex identifier (serialized string, e.g., "tile1-tile2-tile3") */
+    id: VertexIdValue;
+    /** The hex tile IDs this vertex touches */
+    hexes: readonly SpaceIdValue[];
+    /** Vertex type identifier for rendering */
+    typeId?: VertexTypeId;
+    /** Display label for setup or rendering */
+    label?: string;
+    /** Player ID who owns this vertex */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: Properties;
+}
+/** Complete state of a reducer-projected hex board. */
+export interface HexBoardState<B extends string = BoardId, SpaceIdValue extends SpaceId = SpaceId, EdgeIdValue extends string = string, VertexIdValue extends string = string, TileProperties = B extends keyof TilePropertiesByBoardId ? TilePropertiesByBoardId[B] : undefined, EdgeProperties = B extends keyof EdgePropertiesByBoardId ? EdgePropertiesByBoardId[B] : undefined, VertexProperties = B extends keyof VertexPropertiesByBoardId ? VertexPropertiesByBoardId[B] : undefined> {
+    /** Unique board identifier */
+    id: B;
+    /** All tiles on the board */
+    tiles: ReadonlyArray<HexTileState<B, SpaceIdValue, TileProperties>>;
+    /** All edges on the board */
+    edges: ReadonlyArray<HexEdgeState<B, SpaceIdValue, EdgeIdValue, EdgeProperties>>;
+    /** All vertices on the board */
+    vertices: ReadonlyArray<HexVertexState<B, SpaceIdValue, VertexIdValue, VertexProperties>>;
+}
+/** State of a node in a reducer-projected network board. */
+export interface NetworkNodeState {
+    /** Unique node identifier */
+    id: SpaceId;
+    /** X coordinate position */
+    x: number;
+    /** Y coordinate position */
+    y: number;
+    /** Node type identifier for rendering */
+    typeId?: SpaceTypeId;
+    /** Display label on the node */
+    label?: string;
+    /** Player ID who owns this node */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: string;
+}
+/** State of an edge connecting two nodes in a reducer-projected network board. */
+export interface NetworkEdgeState {
+    /** Unique edge identifier */
+    id: string;
+    /** Source node ID */
+    from: SpaceId;
+    /** Target node ID */
+    to: SpaceId;
+    /** Edge type identifier for rendering */
+    typeId?: string;
+    /** Display label on the edge */
+    label?: string;
+    /** Player ID who owns this edge */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: string;
+}
+/** State of a piece placed on a reducer-projected network node. */
+export interface NetworkPieceState {
+    /** Unique piece identifier */
+    id: PieceId;
+    /** Node ID where this piece is placed */
+    nodeId: SpaceId;
+    /** Piece type identifier for rendering */
+    typeId?: PieceTypeId;
+    /** Player ID who owns this piece */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: string;
+}
+/** Complete state of a reducer-projected network board. */
+export interface NetworkBoardState {
+    /** Unique board identifier */
+    id: BoardId;
+    /** All nodes on the board */
+    nodes: NetworkNodeState[];
+    /** All edges on the board */
+    edges: NetworkEdgeState[];
+    /** All pieces on the board */
+    pieces: NetworkPieceState[];
+}
+/** State of a cell on a reducer-projected square grid board. */
+export interface SquareCellState<SpaceIdValue extends SpaceId = SpaceId, Properties = Record<string, unknown>> {
+    /** Unique cell identifier */
+    id: SpaceIdValue;
+    /** Row index (0-based) */
+    row: number;
+    /** Column index (0-based) */
+    col: number;
+    /** Cell type identifier for rendering */
+    typeId?: SpaceTypeId;
+    /** Display label on the cell */
+    label?: string;
+    /** Player ID who owns this cell */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: Properties;
+}
+/** State of an edge on a reducer-projected square grid board. */
+export interface SquareEdgeState<SpaceIdValue extends SpaceId = SpaceId, EdgeIdValue extends string = string, Properties = Record<string, unknown>> {
+    /** Unique edge identifier */
+    id: EdgeIdValue;
+    /** The cell IDs this edge borders */
+    spaceIds: readonly SpaceIdValue[];
+    /** Edge type identifier for rendering */
+    typeId?: EdgeTypeId;
+    /** Display label for setup or rendering */
+    label?: string;
+    /** Player ID who owns this edge */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: Properties;
+}
+/** State of a vertex on a reducer-projected square grid board. */
+export interface SquareVertexState<SpaceIdValue extends SpaceId = SpaceId, VertexIdValue extends string = string, Properties = Record<string, unknown>> {
+    /** Unique vertex identifier */
+    id: VertexIdValue;
+    /** The cell IDs that touch this corner */
+    spaceIds: readonly SpaceIdValue[];
+    /** Vertex type identifier for rendering */
+    typeId?: VertexTypeId;
+    /** Display label for setup or rendering */
+    label?: string;
+    /** Player ID who owns this vertex */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: Properties;
+}
+/** State of a piece placed on a reducer-projected square grid cell. */
+export interface SquarePieceState<PieceIdValue extends PieceId = PieceId, Properties = Record<string, unknown>> {
+    /** Unique piece identifier */
+    id: PieceIdValue;
+    /** Row index where piece is located */
+    row: number;
+    /** Column index where piece is located */
+    col: number;
+    /** Piece type identifier for rendering */
+    typeId: PieceTypeId;
+    /** Player ID who owns this piece */
+    owner?: PlayerId;
+    /** JSON-serialized custom properties */
+    properties?: Properties;
+}
+/** Complete state of a reducer-projected square grid board. */
+export interface SquareBoardState<B extends string = BoardId, SpaceIdValue extends SpaceId = SpaceId, EdgeIdValue extends string = string, VertexIdValue extends string = string, PieceIdValue extends PieceId = PieceId, CellProperties = Record<string, unknown>, EdgeProperties = Record<string, unknown>, VertexProperties = Record<string, unknown>, PieceProperties = Record<string, unknown>> {
+    /** Unique board identifier */
+    id: B;
+    /** Number of rows in the grid */
+    rows: number;
+    /** Number of columns in the grid */
+    cols: number;
+    /** All authored cells on the board */
+    cells: ReadonlyArray<SquareCellState<SpaceIdValue, CellProperties>>;
+    /** All edges on the board */
+    edges: ReadonlyArray<SquareEdgeState<SpaceIdValue, EdgeIdValue, EdgeProperties>>;
+    /** All vertices on the board */
+    vertices: ReadonlyArray<SquareVertexState<SpaceIdValue, VertexIdValue, VertexProperties>>;
+    /** All pieces on the board */
+    pieces: ReadonlyArray<SquarePieceState<PieceIdValue, PieceProperties>>;
+}
+/** State of a space on a reducer-projected track board. */
+export interface TrackSpaceState {
+    /** Unique space identifier */
+    id: SpaceId;
+    /** Position index in the track sequence */
+    index: number;
+    /** X coordinate for rendering */
+    x: number;
+    /** Y coordinate for rendering */
+    y: number;
+    /** Display name of the space */
+    name?: string;
+    /** Space type identifier for rendering */
+    typeId?: SpaceTypeId;
+    /** Player ID who owns this space */
+    owner?: PlayerId;
+    /** IDs of spaces that can be reached from here (for branching tracks) */
+    nextSpaces?: SpaceId[];
+    /** JSON-serialized custom properties */
+    properties?: string;
+}
+/** State of a piece on a reducer-projected track board. */
+export interface TrackPieceState {
+    /** Unique piece identifier */
+    id: PieceId;
+    /** ID of the space this piece occupies */
+    spaceId: SpaceId;
+    /** Player ID who owns this piece */
+    owner: PlayerId;
+    /** Piece type identifier for rendering */
+    typeId?: PieceTypeId;
+    /** JSON-serialized custom properties */
+    properties?: string;
+}
+/** Complete state of a reducer-projected track board. */
+export interface TrackBoardState {
+    /** Unique board identifier */
+    id: BoardId;
+    /** All spaces on the track */
+    spaces: TrackSpaceState[];
+    /** All pieces on the track */
+    pieces: TrackPieceState[];
+}
+/** State of a reducer-projected die component. */
+export interface DieState {
+    /** Unique die identifier */
+    id: DieId;
+    /** Number of sides on the die (e.g., 6 for standard die) */
+    sides: number;
+    /** Current face value (1 to sides, undefined if not rolled) */
+    currentValue?: number;
+    /** Optional color for visual identification */
+    color?: string;
+}
+/**
+ * Collection of boards of a particular kind, split into shared boards
+ * (indexed by base id, e.g. `"market-board"`) and per-player boards
+ * (indexed by base id, then by the runtime seat list via `PerPlayer<T>`).
+ *
+ * Splitting by the `BoardRef` discriminator keeps the UI types honest about
+ * what the runtime actually produced: per-player board state only exists
+ * for the seats that are currently playing, never for a static `maxPlayers`
+ * upper bound.
+ */
+export interface BoardKindStates<State> {
+    /** Shared boards keyed by base id. */
+    shared: Record<BoardBaseId, State>;
+    /** Per-player boards keyed by base id, then by seat via `PerPlayer<T>`. */
+    perPlayer: Record<BoardBaseId, PerPlayer<State>>;
+}
+/**
+ * Container for all board states organized by kind.
+ * This is the strongly-typed board payload authored UIs consume from reducer views.
+ */
+export interface BoardStates {
+    /** Hex boards split into shared vs per-player collections. */
+    hex: BoardKindStates<HexBoardState>;
+    /** Network boards split into shared vs per-player collections. */
+    network: BoardKindStates<NetworkBoardState>;
+    /** Square grid boards split into shared vs per-player collections. */
+    square: BoardKindStates<SquareBoardState>;
+    /** Track boards split into shared vs per-player collections. */
+    track: BoardKindStates<TrackBoardState>;
+}
+/**
+ * Container for all dice states.
+ * Maps die IDs to their die state.
+ */
+export type DiceStates = Record<DieId, DieState>;
+export interface GameState {
+    /** All currently active players (supports MULTIPLE_ACTIVE_PLAYER states) */
+    currentPlayerIds: PlayerId[];
+    decks: CardIdsByDeckId;
+    /**
+     * Player-scoped hands keyed by the authored hand id. The inner
+     * `PerPlayer<CardId[]>` is keyed by the runtime seat list and only
+     * contains entries for players who actually hold the hand.
+     */
+    hands: CardIdsByHandId;
+    /** Map of card IDs to their card info including type and properties */
+    cards: Record<CardId, ViewCard<CardId, string, CardProperties>>;
+    /**
+     * Per-player resource totals keyed by the runtime seat list. The inner
+     * record maps resource id → amount for that seat.
+     */
+    playerResources: PerPlayer<Record<string, number>>;
+    currentState: StateName;
+    isMyTurn: boolean;
+    boards: BoardStates;
+    dice: DiceStates;
+}
+//# sourceMappingURL=player-state.d.ts.map

package/dist/types/player-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-state.d.ts","sourceRoot":"","sources":["../../src/types/player-state.ts"],"names":[],"mappings":"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"}

package/dist/types/player-state.js

@@ -0,0 +1 @@
+export {};

package/dist/types/plugin-state.d.ts

@@ -0,0 +1,324 @@
+import type { PlayerId } from "@dreamboard/manifest-contract";
+/**
+ * Plugin State Types
+ *
+ * These types define the state structure that the host app sends to the plugin
+ * via state-sync messages. The plugin uses these types to access pre-computed
+ * game state without needing to parse raw SSE messages.
+ */
+type ActionName = string;
+export interface SeatAssignment {
+    playerId: PlayerId;
+    controllerUserId?: string;
+    displayName: string;
+    playerColor?: string;
+    isHost?: boolean;
+}
+export interface HistoryEntrySummary {
+    id: string;
+    version: number;
+    timestamp: string;
+    description: string;
+    playerId?: PlayerId;
+    actionType?: ActionName;
+    isCurrent: boolean;
+}
+/**
+ * Lobby state for the pre-game lobby phase
+ */
+export interface LobbyState {
+    /** Current seat assignments in the lobby */
+    seats: SeatAssignment[];
+    /** Whether the game can be started (all seats filled) */
+    canStart: boolean;
+    /** User ID of the session host */
+    hostUserId: string;
+}
+/**
+ * Notification types that get queued for the plugin
+ */
+export type NotificationType = "YOUR_TURN" | "PROMPT_OPENED" | "ACTION_EXECUTED" | "ACTION_REJECTED" | "TURN_CHANGED" | "STATE_CHANGED" | "GAME_ENDED" | "ERROR";
+/**
+ * YOUR_TURN notification payload
+ */
+export interface YourTurnPayload {
+    type: "YOUR_TURN";
+    activePlayers: PlayerId[];
+}
+/**
+ * PROMPT_OPENED notification payload
+ */
+export interface PromptOpenedPayload {
+    type: "PROMPT_OPENED";
+    promptId: string;
+    promptInstanceId: string;
+    targetPlayer: PlayerId;
+    title?: string;
+}
+/**
+ * ACTION_EXECUTED notification payload
+ */
+export interface ActionExecutedPayload {
+    type: "ACTION_EXECUTED";
+    playerId: PlayerId;
+    actionType: string;
+}
+/**
+ * ACTION_REJECTED notification payload
+ */
+export interface ActionRejectedPayload {
+    type: "ACTION_REJECTED";
+    reason: string;
+    targetPlayer?: string;
+}
+/**
+ * STATE_CHANGED notification payload
+ */
+export interface StateChangedPayload {
+    type: "STATE_CHANGED";
+    newState: string;
+}
+/**
+ * TURN_CHANGED notification payload
+ */
+export interface TurnChangedPayload {
+    type: "TURN_CHANGED";
+    previousPlayers: PlayerId[];
+    currentPlayers: PlayerId[];
+}
+/**
+ * GAME_ENDED notification payload
+ */
+export interface GameEndedPayload {
+    type: "GAME_ENDED";
+    winner?: string;
+    finalScores: Record<string, number>;
+    reason: string;
+}
+/**
+ * ERROR notification payload
+ */
+export interface ErrorPayload {
+    type: "ERROR";
+    message: string;
+    code?: string;
+}
+/**
+ * Union of all notification payloads
+ */
+export type NotificationPayload = YourTurnPayload | PromptOpenedPayload | ActionExecutedPayload | ActionRejectedPayload | TurnChangedPayload | StateChangedPayload | GameEndedPayload | ErrorPayload;
+/**
+ * Notification entry in the queue.
+ * Notifications are ephemeral events that the plugin can consume and mark as read.
+ */
+export interface Notification {
+    /** Unique notification ID */
+    id: string;
+    /** Type of notification */
+    type: NotificationType;
+    /** Type-specific payload */
+    payload: NotificationPayload;
+    /** Timestamp when the notification was created */
+    timestamp: number;
+    /** Whether the plugin has marked this notification as read */
+    read: boolean;
+}
+/**
+ * Session state that gets synchronized to the plugin.
+ * This includes player switching info that was previously sent via
+ * separate player-switched messages.
+ */
+export interface PluginSessionState {
+    /** Current session ID */
+    sessionId: string | null;
+    /** Player IDs that this user can control (immutable after game starts) */
+    controllablePlayerIds: PlayerId[];
+    /** The currently selected player ID that the user is controlling */
+    controllingPlayerId: PlayerId | null;
+    /** User ID of the controller */
+    userId: string | null;
+}
+/**
+ * History state for the host's history navigator.
+ * Only sent to the host user.
+ */
+export interface HistoryState {
+    /** List of history entries (newest first when displayed) */
+    entries: HistoryEntrySummary[];
+    /** Index of the current state in the history */
+    currentIndex: number;
+    /** Whether there are earlier states to restore to */
+    canGoBack: boolean;
+    /** Whether there are later states to restore to */
+    canGoForward: boolean;
+}
+export interface GameplayPromptOption {
+    id: string;
+    label: string;
+}
+/** Choice option surfaced on a prompt-kind interaction's structured context. */
+export interface InteractionContextOption {
+    id: string;
+    label?: string;
+    data?: unknown;
+}
+/** Structured context attached to a prompt-kind InteractionDescriptor. */
+export interface InteractionContext {
+    /** Addressed player id. */
+    to: string;
+    title?: string;
+    /** Authored prompt payload. Shape is defined by the game's prompt schema. */
+    payload?: Record<string, unknown>;
+    /** Selectable options for choice-kind prompts. */
+    options?: readonly InteractionContextOption[];
+}
+/**
+ * Authoritative interaction descriptor resolved by the trusted bundle.
+ * Eligibility, cost, and availability are authoritative — clients MUST NOT recompute.
+ */
+export type InteractionKind = "action" | "prompt";
+export type InteractionCommitPolicy = {
+    mode: "manual";
+} | {
+    mode: "autoWhenReady";
+};
+export interface InputSelection {
+    mode: "single" | "many";
+    min?: number;
+    max?: number;
+    distinct?: boolean;
+}
+export interface InputDomain {
+    type: "target" | "resourceMap" | "boundedNumber" | "choice" | "choiceList";
+    targetKind?: string;
+    boardId?: string;
+    zoneId?: string;
+    zoneIds?: readonly string[];
+    eligibleTargets?: readonly string[];
+    resources?: ReadonlyArray<{
+        resourceId: string;
+        label?: string;
+        icon?: string;
+        min: number;
+        max: number;
+    }>;
+    min?: number;
+    max?: number;
+    step?: number;
+    choices?: readonly InteractionChoiceOption[];
+    selection?: InputSelection;
+}
+export interface InteractionChoiceOption {
+    value: string;
+    label: string;
+    icon?: string;
+    badge?: string;
+    description?: string;
+    disabled?: boolean;
+    disabledReason?: string;
+}
+export interface InteractionInputDescriptor {
+    key: string;
+    kind: string;
+    domain: InputDomain;
+    defaultValue?: unknown;
+}
+export interface InteractionDescriptor<Key extends string = string> {
+    phaseName: string;
+    interactionKey: Key;
+    interactionId: string;
+    /**
+     * Authoring-level interaction kind. `"action"` is an ordinary interaction
+     * any active player may attempt. `"prompt"` is an addressed request whose
+     * `context` slot carries title/options so the default `InboxSurface` can
+     * render it without custom dispatch code.
+     */
+    kind: InteractionKind;
+    /** Draft commit policy. Always materialized by the trusted reducer bundle. */
+    commit: InteractionCommitPolicy;
+    /** Source zone id for zone-scoped interactions (e.g., cardInput). */
+    zoneId?: string;
+    /** Source zone ids for zone-scoped interactions that span multiple zones. */
+    zoneIds?: readonly string[];
+    /** Ordered input descriptors. This is the canonical source for input keys, collector kind, and valid-value domains. */
+    inputs: readonly InteractionInputDescriptor[];
+    /** Resolved cost map keyed by resource id (if interaction declares one). */
+    cost?: Record<string, unknown>;
+    /** Snapshot of seat's currently available resources keyed by resource id. */
+    currentResources?: Record<string, unknown>;
+    /** Whether the interaction is executable as of this snapshot. */
+    available: boolean;
+    unavailableReason?: string;
+    /** Structured prompt context for prompt-kind interactions. */
+    context?: InteractionContext;
+}
+/**
+ * Per-player view of a single zone. Mirrors the ZoneHandles wire shape from
+ * the trusted bundle's resolveZoneHandles; `cardsById` is JSON-serialized
+ * `ViewCard` and `playableByCardId` lists the interactions that are playable
+ * on each card (eligibility already filtered by each interaction's validate).
+ */
+export interface ZoneHandlesSnapshot<InteractionType extends string = string> {
+    cardIds: readonly string[];
+    cardsById: Readonly<Record<string, string>>;
+    playableByCardId: Readonly<Record<string, ReadonlyArray<InteractionDescriptor<InteractionType>>>>;
+}
+export interface SimultaneousPhaseSnapshot {
+    phaseName: string;
+    interactionId: string;
+    actorIds: PlayerId[];
+    sealedPlayerIds: PlayerId[];
+    pendingPlayerIds: PlayerId[];
+}
+export interface GameplaySnapshot<PhaseType extends string = string, StageType extends string = string, InteractionType extends string = string> {
+    currentPhase: PhaseType | null;
+    currentStage: StageType | null;
+    activePlayers: PlayerId[];
+    simultaneousPhase?: SimultaneousPhaseSnapshot | null;
+    availableInteractions: ReadonlyArray<InteractionDescriptor<InteractionType>>;
+    /**
+     * Zone handles scoped to the controlling player. Keyed by zoneId.
+     * Authored via phase `zones`; projected from `resolveZoneHandles`.
+     */
+    zones: Readonly<Record<string, ZoneHandlesSnapshot<InteractionType>>>;
+}
+/**
+ * The complete state snapshot sent to the plugin via state-sync.
+ * This is the single source of truth for all reducer-native plugin state.
+ */
+export interface PluginStateSnapshot<View = unknown, PhaseType extends string = string, StageType extends string = string, InteractionType extends string = string> {
+    /** Projected seat-specific reducer-native view for the controlling player */
+    view: View | null;
+    /** Gameplay transport state that sits alongside the projected reducer view */
+    gameplay: GameplaySnapshot<PhaseType, StageType, InteractionType>;
+    /** Lobby state (from LOBBY_UPDATE) - null if game has started */
+    lobby: LobbyState | null;
+    /** Notification queue (from YOUR_TURN, ACTION_REJECTED, PROMPT_OPENED, etc.) */
+    notifications: Notification[];
+    /** Session state (includes controllingPlayerId for player switching) */
+    session: PluginSessionState;
+    /** History state for host navigation (null if not host or history disabled) */
+    history: HistoryState | null;
+    /** Monotonic sync ID for acknowledgment tracking */
+    syncId: number;
+}
+/**
+ * Message sent from host to plugin to sync state
+ */
+export interface StateSyncMessage {
+    type: "state-sync";
+    /** Sync ID for acknowledgment tracking */
+    syncId: number;
+    /** Complete state snapshot */
+    state: PluginStateSnapshot;
+}
+/**
+ * Message sent from plugin to host to acknowledge state receipt
+ */
+export interface StateAckMessage {
+    type: "state-ack";
+    /** Echoes back the syncId that was received */
+    syncId: number;
+}
+export {};
+//# sourceMappingURL=plugin-state.d.ts.map