@dreamboard-games/sdk 0.2.1-alpha.1 → 0.3.0-alpha.1

package/dist/runtime/primitives.d.ts

@@ -1,16 +1,16 @@
-import { bf as ZoneCardRenderItem } from '../ui-contract-rzKBwOLC.js';
-export { B as Board, a as BoardEdgeTarget, b as BoardEdgeTargetProps, c as BoardHexGrid, d as BoardHexGridInteractionFilter, e as BoardHexGridInteractions, f as BoardHexGridProps, g as BoardHexView, h as BoardHexViewProps, i as BoardRoot, j as BoardRootProps, k as BoardSpaceTarget, l as BoardSpaceTargetProps, m as BoardState, n as BoardStateProps, o as BoardTarget, p as BoardTargetExtraInputs, q as BoardTargetProps, r as BoardVertexTarget, s as BoardVertexTargetProps, D as Dice, t as DiceComponents, u as DiceRoot, v as DiceRootProps, w as DiceState, x as DiceValue, y as DiceValues, z as DiceValuesProps, G as Game, C as GameActiveActionState, E as GameChrome, F as GameChromeProps, H as GameChromeState, I as GameMeState, J as GamePendingInputState, K as GamePlayer, L as GamePlayerEntry, M as GamePlayersState, N as GameRenderState, O as GameRoot, P as GameRootProps, Q as GameTurnState, R as Interaction, S as InteractionCardInput, T as InteractionCardInputProps, U as InteractionCardInputRenderState, V as InteractionDescription, W as InteractionDialog, X as InteractionDialogProps, Y as InteractionDialogRenderState, Z as InteractionDialogState, _ as InteractionFieldPrimitiveProps, $ as InteractionFormPrimitive, a0 as InteractionFormPrimitiveProps, a1 as InteractionInput, a2 as InteractionInputProps, a3 as InteractionLabel, a4 as InteractionPartProps, a5 as InteractionRoot, a6 as InteractionRootProps, a7 as InteractionRoute, a8 as InteractionRoutes, a9 as InteractionRoutesMap, aa as InteractionRoutesProps, ab as InteractionState, ac as InteractionStateProps, ad as InteractionStateSnapshot, ae as InteractionSubmit, af as InteractionSubmitProps, ag as InteractionSwitch, ah as InteractionSwitchProps, ai as InteractionSwitchRenderState, aj as InteractionSwitchRouteMap, ak as InteractionTrigger, al as InteractionTriggerProps, am as InteractionUnavailableMessage, an as InteractionValidationMessage, ao as Phase, ap as PhaseFallback, aq as PhaseRouteMap, ar as PhaseSwitch, as as PhaseSwitchProps, at as PlayerRoster, au as PlayerRosterBadge, av as PlayerRosterBadges, aw as PlayerRosterComponents, ax as PlayerRosterEmpty, ay as PlayerRosterEntry, az as PlayerRosterList, aA as PlayerRosterListProps, aB as PlayerRosterName, aC as PlayerRosterPartProps, aD as PlayerRosterRoot, aE as PlayerRosterRootProps, aF as PlayerRosterScore, aG as PlayerRosterSwitchButton, aH as PlayerRosterSwitchButtonProps, aI as PrimitiveCommonProps, aJ as PrimitiveDataAttributes, aK as Prompt, aL as PromptDialog, aM as PromptDialogProps, aN as PromptDialogRenderState, aO as PromptDialogState, aP as PromptInbox, aQ as PromptInboxEmpty, aR as PromptInboxItems, aS as PromptInboxItemsProps, aT as PromptInboxRoot, aU as PromptMessage, aV as PromptOption, aW as PromptOptionProps, aX as PromptOptionRenderItem, aY as PromptOptions, aZ as PromptOptionsProps, a_ as PromptRoot, a$ as PromptRootProps, b0 as PromptTitle, b2 as UI, b4 as UIRoot, b5 as UIRootProps, b6 as UseZoneCardsOptions, b7 as UseZoneCardsResult, b8 as Zone, b9 as ZoneCardAction, ba as ZoneCardActionExtraInputs, bb as ZoneCardActionProps, bc as ZoneCardActionResult, bd as ZoneCardAt, be as ZoneCardAtProps, bg as ZoneItem, bh as ZoneItemProps, bi as ZoneList, bj as ZoneListProps, bk as ZonePileCards, bl as ZonePileCardsProps, bm as ZonePileContextValue, bn as ZonePileCount, bo as ZonePileCountProps, bp as ZonePileDescription, bq as ZonePileDescriptionProps, br as ZonePileLabel, bs as ZonePileLabelProps, bt as ZonePileRoot, bu as ZonePileRootProps, bv as ZonePileTrigger, bw as ZonePileTriggerProps, bx as ZoneRoot, by as ZoneRootProps, bz as ZoneTopCard, bA as ZoneTopCardProps, bB as composeEventHandlers, bC as createZoneCardRenderItem, bD as normalizeDiceState, bE as renderPrimitive, bF as useBoardPrimitiveContext, bG as useDicePrimitiveContext, bH as useGameActionError, bI as useInteractionPrimitiveContext, bJ as useOptionalZonePrimitiveContext, bK as useResolvedCardTargetValue, bL as useZoneCardContext, bM as useZoneCards, bN as useZonePileContext, bO as useZonePrimitiveContext } from '../ui-contract-rzKBwOLC.js';
+import { bd as ZoneCardRenderItem } from '../ui-contract-SctM4ibF.js';
+export { B as Board, a as BoardEdgeTarget, b as BoardEdgeTargetProps, c as BoardHexGrid, d as BoardHexGridInteractionFilter, e as BoardHexGridInteractions, f as BoardHexGridProps, g as BoardHexView, h as BoardHexViewProps, i as BoardRoot, j as BoardRootProps, k as BoardSpaceTarget, l as BoardSpaceTargetProps, m as BoardState, n as BoardStateProps, o as BoardTarget, p as BoardTargetExtraInputs, q as BoardTargetProps, r as BoardVertexTarget, s as BoardVertexTargetProps, D as Dice, t as DiceComponents, u as DiceRoot, v as DiceRootProps, w as DiceState, x as DiceValue, y as DiceValues, z as DiceValuesProps, G as Game, C as GameActiveActionState, E as GameChrome, F as GameChromeProps, H as GameChromeState, I as GameMeState, J as GamePendingInputState, K as GamePlayer, L as GamePlayerEntry, M as GamePlayersState, N as GameRenderState, O as GameRoot, P as GameRootProps, Q as GameTurnState, R as Interaction, S as InteractionCardInput, T as InteractionCardInputProps, U as InteractionCardInputRenderState, V as InteractionDescription, W as InteractionDialog, X as InteractionDialogProps, Y as InteractionDialogRenderState, Z as InteractionDialogState, _ as InteractionFieldPrimitiveProps, $ as InteractionFormPrimitive, a0 as InteractionFormPrimitiveProps, a1 as InteractionInput, a2 as InteractionInputProps, a3 as InteractionLabel, a4 as InteractionPartProps, a5 as InteractionRoot, a6 as InteractionRootProps, a7 as InteractionRoute, a8 as InteractionRoutes, a9 as InteractionRoutesMap, aa as InteractionRoutesProps, ab as InteractionState, ac as InteractionStateProps, ad as InteractionStateSnapshot, ae as InteractionSubmit, af as InteractionSubmitProps, ag as InteractionSwitch, ah as InteractionSwitchProps, ai as InteractionSwitchRenderState, aj as InteractionSwitchRouteMap, ak as InteractionTrigger, al as InteractionTriggerProps, am as InteractionUnavailableMessage, an as InteractionValidationMessage, ao as Phase, ap as PhaseFallback, aq as PhaseRouteMap, ar as PhaseSwitch, as as PhaseSwitchProps, at as PlayerRoster, au as PlayerRosterBadge, av as PlayerRosterBadges, aw as PlayerRosterComponents, ax as PlayerRosterEmpty, ay as PlayerRosterEntry, az as PlayerRosterList, aA as PlayerRosterListProps, aB as PlayerRosterName, aC as PlayerRosterPartProps, aD as PlayerRosterRoot, aE as PlayerRosterRootProps, aF as PlayerRosterScore, aG as PlayerRosterSwitchButton, aH as PlayerRosterSwitchButtonProps, aI as Prompt, aJ as PromptDialog, aK as PromptDialogProps, aL as PromptDialogRenderState, aM as PromptDialogState, aN as PromptInbox, aO as PromptInboxEmpty, aP as PromptInboxItems, aQ as PromptInboxItemsProps, aR as PromptInboxRoot, aS as PromptMessage, aT as PromptOption, aU as PromptOptionProps, aV as PromptOptionRenderItem, aW as PromptOptions, aX as PromptOptionsProps, aY as PromptRoot, aZ as PromptRootProps, a_ as PromptTitle, b0 as UI, b2 as UIRoot, b3 as UIRootProps, b4 as UseZoneCardsOptions, b5 as UseZoneCardsResult, b6 as Zone, b7 as ZoneCardAction, b8 as ZoneCardActionExtraInputs, b9 as ZoneCardActionProps, ba as ZoneCardActionResult, bb as ZoneCardAt, bc as ZoneCardAtProps, be as ZoneItem, bf as ZoneItemProps, bg as ZoneList, bh as ZoneListProps, bi as ZonePileCards, bj as ZonePileCardsProps, bk as ZonePileContextValue, bl as ZonePileCount, bm as ZonePileCountProps, bn as ZonePileDescription, bo as ZonePileDescriptionProps, bp as ZonePileLabel, bq as ZonePileLabelProps, br as ZonePileRoot, bs as ZonePileRootProps, bt as ZonePileTrigger, bu as ZonePileTriggerProps, bv as ZoneRoot, bw as ZoneRootProps, bx as ZoneTopCard, by as ZoneTopCardProps, bz as createZoneCardRenderItem, bA as normalizeDiceState, bB as useBoardPrimitiveContext, bC as useDicePrimitiveContext, bD as useGameActionError, bE as useInteractionPrimitiveContext, bF as useOptionalZonePrimitiveContext, bG as useResolvedCardTargetValue, bH as useZoneCardContext, bI as useZoneCards, bJ as useZonePileContext, bK as useZonePrimitiveContext } from '../ui-contract-SctM4ibF.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { a as CardIntent, I as InteractionVisualState, b as HandLayoutKind, c as HandLayoutPolicy, H as HandInteractionPolicy, C as CardDropTargetVisualState } from '../HandView-ncJIVLhN.js';
-import { a as InteractionDescriptor, P as PluginStateSnapshot } from '../runtime-api-CPLm_XDG.js';
-import '../hex-board-view-1iAyJRFn.js';
-import '../ui/types/player-state.js';
-import '../cards-Sl3b40Mv.js';
+import { a as CardIntent, I as InteractionVisualState, b as HandLayoutKind, c as HandLayoutPolicy, H as HandInteractionPolicy, C as CardDropTargetVisualState } from '../HandView-PYDmehVD.js';
+import { a as InteractionDescriptor, d as PluginStateSnapshot } from '../runtime-api-tGL3ArsB.js';
+export { P as PrimitiveCommonProps, a as PrimitiveDataAttributes, c as composeEventHandlers, r as renderPrimitive } from '../primitive-props-BNHDkgd7.js';
+import '../hex-board-view-UCUjMALd.js';
+import '../ui/player-state.js';
+import '../types.js';
 import '../hex-color-MhOyuY-o.js';
-import '../ThemeProvider-BBMVT3KG.js';
+import '../ThemeProvider-DvMl17Ny.js';
 import '../attributes-BeRyboMS.js';
-import '../runtime-api-3dshj6kK.js';
 
 interface InteractionDraftReadiness {
     values: Record<string, unknown>;

package/dist/runtime/primitives.js

@@ -1,4 +1,3 @@
-import "../chunk-T52J5RMF.js";
 import {
   Board,
   BoardEdgeTarget,
@@ -67,13 +66,11 @@ import {
   ZonePileTrigger,
   ZoneRoot,
   ZoneTopCard,
-  composeEventHandlers,
   createZoneCardRenderItem,
   decodeAuthoredCardIntent,
   descriptorsHaveDestinationInput,
   dropTargetIdFor,
   normalizeDiceState,
-  renderPrimitive,
   useBoardPrimitiveContext,
   useCardIntentAdapter,
   useDicePrimitiveContext,
@@ -85,11 +82,14 @@ import {
   useZoneCards,
   useZonePileContext,
   useZonePrimitiveContext
-} from "../chunk-ZABVH7AO.js";
+} from "../chunk-ADYH6PVT.js";
+import "../chunk-3RQEICD3.js";
+import "../chunk-QZ6X4B5P.js";
+import {
+  composeEventHandlers,
+  renderPrimitive
+} from "../chunk-VDXOF4FW.js";
 import "../chunk-QLG6VEMW.js";
-import "../chunk-NKCRKGR2.js";
-import "../chunk-WG4JQL3S.js";
-import "../chunk-VDXOF4FW.js";
 import "../chunk-PZ5AY32C.js";
 export {
   Board,

package/dist/runtime/runtime-api.d.ts

@@ -0,0 +1,2 @@
+export { c as PluginSessionState, d as PluginStateSnapshot, R as RuntimeAPI, S as SubmissionError, V as ValidationResult, Z as ZoneHandlesSnapshot } from '../runtime-api-tGL3ArsB.js';
+import '../hex-color-MhOyuY-o.js';

package/dist/runtime/runtime-api.js

@@ -0,0 +1 @@
+//# sourceMappingURL=runtime-api.js.map

package/dist/runtime/workspace-contract.d.ts

@@ -1,19 +1,17 @@
-export { DreamboardUI, TypedGame, UIContract } from '../runtime.js';
-import { l as BoardSpaceTargetProps, bj as ZoneListProps, b3 as UIContract } from '../ui-contract-rzKBwOLC.js';
-export { f as BoardHexGridProps, h as BoardHexViewProps, I as GameMeState, M as GamePlayersState, N as GameRenderState, Q as GameTurnState, b5 as UIRootProps, bf as ZoneCardRenderItem } from '../ui-contract-rzKBwOLC.js';
-import { H as HandRole } from '../ResourceCounter-CTREyF73.js';
-export { b as ResourceCounterComponents } from '../ResourceCounter-CTREyF73.js';
-import '../runtime-api-CPLm_XDG.js';
-import { ReactNode, ReactElement, ButtonHTMLAttributes } from 'react';
-import 'react/jsx-runtime';
-import '../hex-board-view-1iAyJRFn.js';
-import '../ui/types/player-state.js';
-import '../cards-Sl3b40Mv.js';
+import { l as BoardSpaceTargetProps, bh as ZoneListProps, b1 as UIContract$1, A as DreamboardUI$1, a$ as TypedGame$1 } from '../ui-contract-SctM4ibF.js';
+export { f as BoardHexGridProps, h as BoardHexViewProps, I as GameMeState, M as GamePlayersState, N as GameRenderState, Q as GameTurnState, b3 as UIRootProps, bd as ZoneCardRenderItem } from '../ui-contract-SctM4ibF.js';
+import { H as HandRole } from '../ResourceCounter-BTXklCEZ.js';
+export { b as ResourceCounterComponents } from '../ResourceCounter-BTXklCEZ.js';
+import '../runtime-api-tGL3ArsB.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import react__default, { ReactNode, ReactElement, ButtonHTMLAttributes } from 'react';
+import '../hex-board-view-UCUjMALd.js';
+import '../ui/player-state.js';
+import '../types.js';
 import '../hex-color-MhOyuY-o.js';
-import '../ThemeProvider-BBMVT3KG.js';
+import '../ThemeProvider-DvMl17Ny.js';
+import '../primitive-props-BNHDkgd7.js';
 import '../attributes-BeRyboMS.js';
-import '../runtime-api-3dshj6kK.js';
-import '../primitive-props-DpKs-GCr.js';
 
 interface ClientParamSchema {
     safeParse: (value: unknown) => {
@@ -31,6 +29,42 @@ interface ClientParamSchema {
 }
 type ClientParamSchemaMap = Readonly<Record<string, Readonly<Record<string, ClientParamSchema>>>>;
 
+interface PluginRuntimeProps {
+    /** Child components to render after state sync has started */
+    children: react__default.ReactNode;
+    /**
+     * Timeout in milliseconds to wait for the first state-sync snapshot.
+     * @default 10000 (10 seconds)
+     */
+    timeout?: number;
+    /** Custom loading component to show while waiting for state sync */
+    loadingComponent?: react__default.ReactNode;
+    /** Custom error component to show when initialization fails */
+    errorComponent?: (error: string) => react__default.ReactNode;
+}
+/**
+ * PluginRuntime provides the RuntimeContext for plugin components.
+ *
+ * This component:
+ * - Creates a RuntimeAPI instance using the SDK-provided implementation
+ * - Waits for the first reducer-native state-sync snapshot before rendering children
+ * - Provides RuntimeAPI and session state to all child components
+ *
+ * @example
+ * ```tsx
+ * // In your plugin's index.tsx
+ * import { PluginRuntime } from "./components/dreamboard";
+ * import App from './App';
+ *
+ * ReactDOM.createRoot(document.getElementById('root')!).render(
+ *   <PluginRuntime>
+ *     <App />
+ *   </PluginRuntime>
+ * );
+ * ```
+ */
+declare function PluginRuntime({ children, timeout, loadingComponent, errorComponent, }: PluginRuntimeProps): react_jsx_runtime.JSX.Element;
+
 type WorkspaceInteractionSlotComponent<Props = object> = (props: Props extends {
     children: unknown;
 } ? Props : Props & {
@@ -155,7 +189,7 @@ type WorkspaceSurfaceDescriptor = WorkspaceBoardSurfaceDescriptor | WorkspaceHan
 interface WorkspaceSurfaceSpec {
     readonly [key: string]: WorkspaceSurfaceDescriptor | WorkspaceSurfaceSpec;
 }
-interface WorkspaceContractOptions<Contract extends UIContract, Resource extends string, Card, HexBoards extends Record<string, unknown>> {
+interface WorkspaceContractOptions<Contract extends UIContract$1, Resource extends string, Card, HexBoards extends Record<string, unknown>> {
     readonly uiContract: Contract;
     readonly clientParamSchemasByPhase?: ClientParamSchemaMap;
     readonly formInputKeysForInteraction: (interaction: string) => ReadonlySet<string>;
@@ -168,6 +202,17 @@ interface WorkspaceContractOptions<Contract extends UIContract, Resource extends
     readonly cardIdFromZoneCard: (card: Card) => string;
     readonly zoneIdFromZoneCard: (card: Card) => string;
 }
-declare function createWorkspaceUIContract<WorkspaceUI, Contract extends UIContract, Resource extends string, Card, HexBoards extends Record<string, unknown>>(options: WorkspaceContractOptions<Contract, Resource, Card, HexBoards>): WorkspaceUI;
 
-export { BoardSpaceTargetProps, type ClientParamSchemaMap, type WorkspaceBoardSurface, type WorkspaceBoardSurfaceDescriptor, type WorkspaceBoardTargetInputSlot, type WorkspaceCardCollectionSurface, type WorkspaceCardCollectionSurfaceDescriptor, type WorkspaceCardInputSlot, type WorkspaceFormInputSlot, type WorkspaceHandSurface, type WorkspaceHandSurfaceDescriptor, type WorkspaceInteractionFormDescriptor, type WorkspaceInteractionFormsDescriptor, type WorkspaceInteractionSlotComponent, type WorkspacePileSurface, type WorkspacePileSurfaceDescriptor, type WorkspacePilesSurfaceDescriptor, type WorkspaceSurfaceSpec, ZoneListProps, createWorkspaceUIContract };
+declare function createWorkspaceUIContract<WorkspaceUI, Contract extends UIContract$1, Resource extends string, Card, HexBoards extends Record<string, unknown>>(options: WorkspaceContractOptions<Contract, Resource, Card, HexBoards>): WorkspaceUI;
+
+interface DreamboardUIRegister {
+}
+type UIContract = UIContract$1;
+type RegisteredUIContract = DreamboardUIRegister extends {
+    ui: infer Registered extends UIContract;
+} ? Registered : UIContract;
+type RegisteredUI = RegisteredUIContract;
+type DreamboardUI<Contract extends UIContract = RegisteredUI> = DreamboardUI$1<Contract>;
+type TypedGame<Contract extends UIContract, View = unknown, Player extends string = string, Phase extends string = string> = TypedGame$1<Contract, View, Player, Phase>;
+
+export { BoardSpaceTargetProps, type ClientParamSchemaMap, type DreamboardUIRegister as D, type DreamboardUI, PluginRuntime as P, type RegisteredUI as R, type TypedGame, type UIContract, type WorkspaceBoardSurface, type WorkspaceBoardSurfaceDescriptor, type WorkspaceBoardTargetInputSlot, type WorkspaceCardCollectionSurface, type WorkspaceCardCollectionSurfaceDescriptor, type WorkspaceCardInputSlot, type WorkspaceFormInputSlot, type WorkspaceHandSurface, type WorkspaceHandSurfaceDescriptor, type WorkspaceInteractionFormDescriptor, type WorkspaceInteractionFormsDescriptor, type WorkspaceInteractionSlotComponent, type WorkspacePileSurface, type WorkspacePileSurfaceDescriptor, type WorkspacePilesSurfaceDescriptor, type WorkspaceSurfaceSpec, ZoneListProps, type PluginRuntimeProps as a, createWorkspaceUIContract };

package/dist/runtime/workspace-contract.js

@@ -1,13 +1,12 @@
 import {
   createWorkspaceUIContract
-} from "../chunk-MZNVHMJ5.js";
+} from "../chunk-TXXLS3OI.js";
+import "../chunk-ADYH6PVT.js";
+import "../chunk-3RQEICD3.js";
 import "../chunk-T3ZKNUZ7.js";
-import "../chunk-326PGVAA.js";
-import "../chunk-ZABVH7AO.js";
-import "../chunk-QLG6VEMW.js";
-import "../chunk-NKCRKGR2.js";
-import "../chunk-WG4JQL3S.js";
+import "../chunk-QZ6X4B5P.js";
 import "../chunk-VDXOF4FW.js";
+import "../chunk-QLG6VEMW.js";
 import "../chunk-PZ5AY32C.js";
 export {
   createWorkspaceUIContract

package/dist/{runtime-api-CPLm_XDG.d.ts → runtime-api-tGL3ArsB.d.ts}

@@ -1,6 +1,7 @@
-import { P as PlayerId } from './runtime-api-3dshj6kK.js';
 import { H as HexColor } from './hex-color-MhOyuY-o.js';
 
+type PlayerId = string;
+
 /**
  * Plugin State Types
  *
@@ -130,7 +131,7 @@ interface Notification {
  * This includes player switching info that was previously sent via
  * separate player-switched messages.
  */
-interface PluginSessionState {
+interface PluginSessionState$1 {
     /** Current session ID */
     sessionId: string | null;
     /** Player IDs that this user can control (immutable after game starts) */
@@ -375,11 +376,109 @@ interface PluginStateSnapshot<View = unknown, PhaseType extends string = string,
     /** Notification queue (from YOUR_TURN, ACTION_REJECTED, PROMPT_OPENED, etc.) */
     notifications: Notification[];
     /** Session state (includes controllingPlayerId for player switching) */
-    session: PluginSessionState;
+    session: PluginSessionState$1;
     /** History state for host navigation (null if not host or history disabled) */
     history: HistoryState | null;
     /** Monotonic sync ID for acknowledgment tracking */
     syncId: number;
 }
 
-export type { GameplaySnapshot as G, InputDomain as I, PluginStateSnapshot as P, ZoneHandlesSnapshot as Z, InteractionDescriptor as a, InteractionInputDescriptor as b };
+/**
+ * Result of validating a player action
+ */
+interface ValidationResult {
+    /** Whether the action is valid */
+    valid: boolean;
+    /** Machine-readable error code if validation failed */
+    errorCode?: string;
+    /** Human-readable error message if validation failed */
+    message?: string;
+}
+/**
+ * Structured authoritative submission failure returned by runtime submit APIs.
+ */
+interface SubmissionError extends Error {
+    /** Machine-readable error code when available */
+    errorCode?: string;
+}
+/**
+ * Plugin session state
+ */
+interface PluginSessionState {
+    /** Session initialization status */
+    status: "loading" | "ready";
+    /** Current session ID (null if not initialized) */
+    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 (null if not initialized) */
+    userId: string | null;
+}
+/**
+ * RuntimeAPI provides the interface between plugin code and the game runtime.
+ * This API is exposed to plugin iframes for subscribing to game events and submitting actions.
+ */
+interface RuntimeAPI {
+    /**
+     * Validate a player interaction before submitting it. `params` is typed
+     * as `unknown` because a `promptInput` collector can declare a scalar
+     * response schema (`z.enum([...])`, `z.string()`, `z.number()`, ...)
+     * while ordinary collectors pass an object.
+     *
+     * @param playerId - ID of the player performing the interaction
+     * @param interactionId - Identifier of the interaction
+     * @param params - Interaction-specific payload
+     * @returns Promise that resolves with validation result
+     */
+    validateInteraction: (playerId: PlayerId, interactionId: string, params: unknown) => Promise<ValidationResult>;
+    /**
+     * Submit a player interaction to the game server. `submitInteraction`
+     * is the single submission verb for every interaction kind — authors
+     * do not split between "action" and "prompt response" calls.
+     *
+     * @param playerId - ID of the player performing the interaction
+     * @param interactionId - Identifier of the interaction
+     * @param params - Interaction-specific payload (see
+     *   {@link validateInteraction} for the `unknown` typing rationale)
+     * @throws SubmissionError if submission is rejected by the authority.
+     */
+    submitInteraction: (playerId: PlayerId, interactionId: string, params: unknown) => Promise<void>;
+    /**
+     * Get the current plugin session state.
+     * Returns initialization status and session/player IDs.
+     *
+     * @returns Current plugin session state
+     *
+     * @example
+     * ```typescript
+     * const { status, sessionId, playerId } = runtime.getSessionState();
+     * if (status === "ready") {
+     *   console.log('Connected to session:', sessionId);
+     * }
+     * ```
+     */
+    getSessionState: () => PluginSessionState;
+    /**
+     * Disconnect from the runtime and clean up all listeners.
+     * Should be called when the plugin is unmounting.
+     */
+    disconnect: () => void;
+    /**
+     * Request to switch to a different player.
+     * Only works if the user controls multiple seats.
+     * The parent window will handle the switch and update the session state.
+     *
+     * @param playerId - ID of the player to switch to
+     *
+     * @example
+     * ```typescript
+     * // Switch to player-2
+     * runtime.switchPlayer?.('player-2');
+     * ```
+     */
+    switchPlayer?: (playerId: PlayerId) => void;
+}
+
+export type { GameplaySnapshot as G, InputDomain as I, PlayerId as P, RuntimeAPI as R, SubmissionError as S, ValidationResult as V, ZoneHandlesSnapshot as Z, InteractionDescriptor as a, InteractionInputDescriptor as b, PluginSessionState as c, PluginStateSnapshot as d };

package/dist/runtime.d.ts

@@ -1,59 +1,13 @@
-import { b3 as UIContract$1, A as DreamboardUI$1, b1 as TypedGame$1 } from './ui-contract-rzKBwOLC.js';
-export { a as InteractionDescriptor } from './runtime-api-CPLm_XDG.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import react__default from 'react';
-import './hex-board-view-1iAyJRFn.js';
-import './ui/types/player-state.js';
-import './cards-Sl3b40Mv.js';
+export { f as BoardHexGridProps, h as BoardHexViewProps, l as BoardSpaceTargetProps, I as GameMeState, M as GamePlayersState, N as GameRenderState, Q as GameTurnState, b3 as UIRootProps, bd as ZoneCardRenderItem, bh as ZoneListProps } from './ui-contract-SctM4ibF.js';
+export { a as InteractionDescriptor } from './runtime-api-tGL3ArsB.js';
+export { ClientParamSchemaMap, DreamboardUI, D as DreamboardUIRegister, P as PluginRuntime, a as PluginRuntimeProps, R as RegisteredUI, TypedGame, UIContract, WorkspaceBoardSurface, WorkspaceBoardSurfaceDescriptor, WorkspaceBoardTargetInputSlot, WorkspaceCardCollectionSurface, WorkspaceCardCollectionSurfaceDescriptor, WorkspaceCardInputSlot, WorkspaceFormInputSlot, WorkspaceHandSurface, WorkspaceHandSurfaceDescriptor, WorkspaceInteractionFormDescriptor, WorkspaceInteractionFormsDescriptor, WorkspaceInteractionSlotComponent, WorkspacePileSurface, WorkspacePileSurfaceDescriptor, WorkspacePilesSurfaceDescriptor, WorkspaceSurfaceSpec, createWorkspaceUIContract } from './runtime/workspace-contract.js';
+export { b as ResourceCounterComponents } from './ResourceCounter-BTXklCEZ.js';
+import 'react';
+import 'react/jsx-runtime';
+import './hex-board-view-UCUjMALd.js';
+import './ui/player-state.js';
+import './types.js';
 import './hex-color-MhOyuY-o.js';
-import './ThemeProvider-BBMVT3KG.js';
+import './ThemeProvider-DvMl17Ny.js';
+import './primitive-props-BNHDkgd7.js';
 import './attributes-BeRyboMS.js';
-import './runtime-api-3dshj6kK.js';
-
-interface PluginRuntimeProps {
-    /** Child components to render after state sync has started */
-    children: react__default.ReactNode;
-    /**
-     * Timeout in milliseconds to wait for the first state-sync snapshot.
-     * @default 10000 (10 seconds)
-     */
-    timeout?: number;
-    /** Custom loading component to show while waiting for state sync */
-    loadingComponent?: react__default.ReactNode;
-    /** Custom error component to show when initialization fails */
-    errorComponent?: (error: string) => react__default.ReactNode;
-}
-/**
- * PluginRuntime provides the RuntimeContext for plugin components.
- *
- * This component:
- * - Creates a RuntimeAPI instance using the SDK-provided implementation
- * - Waits for the first reducer-native state-sync snapshot before rendering children
- * - Provides RuntimeAPI and session state to all child components
- *
- * @example
- * ```tsx
- * // In your plugin's index.tsx
- * import { PluginRuntime } from "./components/dreamboard";
- * import App from './App';
- *
- * ReactDOM.createRoot(document.getElementById('root')!).render(
- *   <PluginRuntime>
- *     <App />
- *   </PluginRuntime>
- * );
- * ```
- */
-declare function PluginRuntime({ children, timeout, loadingComponent, errorComponent, }: PluginRuntimeProps): react_jsx_runtime.JSX.Element;
-
-interface DreamboardUIRegister {
-}
-type UIContract = UIContract$1;
-type RegisteredUIContract = DreamboardUIRegister extends {
-    ui: infer Registered extends UIContract;
-} ? Registered : UIContract;
-type RegisteredUI = RegisteredUIContract;
-type DreamboardUI<Contract extends UIContract = RegisteredUI> = DreamboardUI$1<Contract>;
-type TypedGame<Contract extends UIContract, View = unknown, Player extends string = string, Phase extends string = string> = TypedGame$1<Contract, View, Player, Phase>;
-
-export { type DreamboardUI, type DreamboardUIRegister, PluginRuntime, type PluginRuntimeProps, type RegisteredUI, type TypedGame, type UIContract };