@dreamboard-games/sdk 0.4.0-alpha.1 → 0.4.0-alpha.2

package/dist/runtime/primitives.d.ts

@@ -1,17 +1,17 @@
-import { bd as ZoneCardRenderItem } from '../ui-contract-W2-kxObe.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-W2-kxObe.js';
+import { bd as ZoneCardRenderItem } from '../ui-contract-CY7cxsCC.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 GameViewport, S as GameViewportProps, T as Interaction, U as InteractionCardInput, V as InteractionCardInputProps, W as InteractionCardInputRenderState, X as InteractionDescription, Y as InteractionDialog, Z as InteractionDialogProps, _ as InteractionDialogRenderState, $ as InteractionDialogState, a0 as InteractionFieldPrimitiveProps, a1 as InteractionFormPrimitive, a2 as InteractionFormPrimitiveProps, a3 as InteractionInput, a4 as InteractionInputProps, a5 as InteractionLabel, a6 as InteractionPartProps, a7 as InteractionRoot, a8 as InteractionRootProps, a9 as InteractionRoute, aa as InteractionRoutes, ab as InteractionRoutesMap, ac as InteractionRoutesProps, ad as InteractionState, ae as InteractionStateProps, af as InteractionStateSnapshot, ag as InteractionSubmit, ah as InteractionSubmitProps, ai as InteractionSwitch, aj as InteractionSwitchProps, ak as InteractionSwitchRenderState, al as InteractionSwitchRouteMap, am as InteractionTrigger, an as InteractionTriggerProps, ao as InteractionUnavailableMessage, ap as InteractionValidationMessage, aq as Phase, ar as PhaseFallback, as as PhaseRouteMap, at as PhaseSwitch, au as PhaseSwitchProps, av as PlayerRoster, aw as PlayerRosterBadge, ax as PlayerRosterBadges, ay as PlayerRosterComponents, az as PlayerRosterEmpty, aA as PlayerRosterEntry, aB as PlayerRosterList, aC as PlayerRosterListProps, aD as PlayerRosterName, aE as PlayerRosterPartProps, aF as PlayerRosterRoot, aG as PlayerRosterRootProps, aH as PlayerRosterScore, 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-CY7cxsCC.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-PYDmehVD.js';
-import { a as InteractionDescriptor, d as PluginStateSnapshot } from '../runtime-api-BXd70c2e.js';
+import { a as InteractionDescriptor } from '../runtime-api-BJharVaj.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 '../hex-board-view-Kz9Q_zsv.js';
+import '../player-state-Cqpyeql0.js';
 import '../types.js';
-import '../hex-color-MhOyuY-o.js';
-import '../ThemeProvider-DvMl17Ny.js';
-import '../attributes-BrZtP9az.js';
-import '../types-BqzHkNMA.js';
+import '../ThemeProvider-B1sIoBlX.js';
+import '../attributes-DbvyMbXw.js';
+import '../types-DJj5MJkl.js';
+import '../runtime-api-C6aWo9c0.js';
 
 interface InteractionDraftReadiness {
     values: Record<string, unknown>;
@@ -223,6 +223,6 @@ declare function dropTargetIdFor(kind: RuntimeDropTargetKind, value: string): st
  * to decide whether to mount a drag surface even before the author wires
  * dropTargets.
  */
-declare function descriptorsHaveDestinationInput(state: PluginStateSnapshot): boolean;
+declare function descriptorsHaveDestinationInput(availableInteractions: readonly InteractionDescriptor[]): boolean;
 
 export { type AuthoredCardIntent, HandSurfaceView, type HandSurfaceViewProps, type RuntimeCardIntentResult, type RuntimeDropTarget, type UseCardIntentAdapterOptions, ZoneCardRenderItem, decodeAuthoredCardIntent, descriptorsHaveDestinationInput, dropTargetIdFor, useCardIntentAdapter };

package/dist/runtime/primitives.js

@@ -14,6 +14,7 @@ import {
   Game,
   GameChrome,
   GameRoot,
+  GameViewport,
   HandSurfaceView,
   Interaction,
   InteractionCardInput,
@@ -39,7 +40,6 @@ import {
   PlayerRosterName,
   PlayerRosterRoot,
   PlayerRosterScore,
-  PlayerRosterSwitchButton,
   Prompt,
   PromptDialog,
   PromptInbox,
@@ -82,15 +82,17 @@ import {
   useZoneCards,
   useZonePileContext,
   useZonePrimitiveContext
-} from "../chunk-CZMFAS3E.js";
-import "../chunk-XJYUSD5F.js";
-import "../chunk-7W6TQO3X.js";
+} from "../chunk-WOWFONLZ.js";
+import "../chunk-FWVV2X74.js";
+import "../chunk-T3ZKNUZ7.js";
+import "../chunk-45FI6XII.js";
 import {
   composeEventHandlers,
   renderPrimitive
 } from "../chunk-VDXOF4FW.js";
-import "../chunk-MALRKLRR.js";
-import "../chunk-AEUXCFGM.js";
+import "../chunk-O6M6PN4E.js";
+import "../chunk-WUIVY2KE.js";
+import "../chunk-PF7L4BMG.js";
 import "../chunk-PZ5AY32C.js";
 export {
   Board,
@@ -108,6 +110,7 @@ export {
   Game,
   GameChrome,
   GameRoot,
+  GameViewport,
   HandSurfaceView,
   Interaction,
   InteractionCardInput,
@@ -133,7 +136,6 @@ export {
   PlayerRosterName,
   PlayerRosterRoot,
   PlayerRosterScore,
-  PlayerRosterSwitchButton,
   Prompt,
   PromptDialog,
   PromptInbox,

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

@@ -1,2 +1,2 @@
-export { c as PluginSessionState, d as PluginStateSnapshot, R as RuntimeAPI, S as SubmissionError, V as ValidationResult, Z as ZoneHandlesSnapshot } from '../runtime-api-BXd70c2e.js';
-import '../hex-color-MhOyuY-o.js';
+export { a as PluginSessionState, R as RuntimeAPI, b as RuntimeDiagnosticEvent, c as RuntimeDiagnosticHandler, S as SubmissionError, V as ValidationResult } from '../runtime-api-C6aWo9c0.js';
+export { Z as ZoneHandlesSnapshot } from '../runtime-api-BJharVaj.js';

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

@@ -1,18 +1,18 @@
-import { l as BoardSpaceTargetProps, bh as ZoneListProps, b1 as UIContract } from '../ui-contract-W2-kxObe.js';
-export { f as BoardHexGridProps, h as BoardHexViewProps, A as DreamboardUI, I as GameMeState, M as GamePlayersState, N as GameRenderState, Q as GameTurnState, a$ as TypedGame, b3 as UIRootProps, bd as ZoneCardRenderItem } from '../ui-contract-W2-kxObe.js';
+import { l as BoardSpaceTargetProps, bh as ZoneListProps, b1 as UIContract } from '../ui-contract-CY7cxsCC.js';
+export { f as BoardHexGridProps, h as BoardHexViewProps, A as DreamboardUI, I as GameMeState, M as GamePlayersState, N as GameRenderState, Q as GameTurnState, a$ as TypedGame, b3 as UIRootProps, bd as ZoneCardRenderItem } from '../ui-contract-CY7cxsCC.js';
 import { ReactNode, ReactElement, ButtonHTMLAttributes } from 'react';
-import { H as HandRole } from '../ResourceCounter-BTXklCEZ.js';
-export { b as ResourceCounterComponents } from '../ResourceCounter-BTXklCEZ.js';
+import { H as HandRole } from '../ResourceCounter-BuiNstXs.js';
+export { b as ResourceCounterComponents } from '../ResourceCounter-BuiNstXs.js';
 import 'react/jsx-runtime';
-import '../hex-board-view-UCUjMALd.js';
-import '../ui/player-state.js';
+import '../hex-board-view-Kz9Q_zsv.js';
+import '../player-state-Cqpyeql0.js';
 import '../types.js';
-import '../hex-color-MhOyuY-o.js';
-import '../ThemeProvider-DvMl17Ny.js';
-import '../runtime-api-BXd70c2e.js';
+import '../ThemeProvider-B1sIoBlX.js';
+import '../runtime-api-BJharVaj.js';
+import '../runtime-api-C6aWo9c0.js';
 import '../primitive-props-BNHDkgd7.js';
-import '../attributes-BrZtP9az.js';
-import '../types-BqzHkNMA.js';
+import '../attributes-DbvyMbXw.js';
+import '../types-DJj5MJkl.js';
 
 interface ClientParamSchema {
     safeParse: (value: unknown) => {
@@ -99,8 +99,19 @@ type WorkspaceZoneStagingComponent<Card> = WorkspaceInteractionSlotComponent<{
     ariaLabel?: string;
     className?: string;
 }>;
+type WorkspaceHandCardsComponent<Card> = WorkspaceInteractionSlotComponent<{
+    children: (card: Card, state: unknown) => ReactNode;
+}>;
+type WorkspaceHandSummaryComponent = WorkspaceInteractionSlotComponent<{
+    children?: ReactNode | ((summary: unknown) => ReactNode);
+}>;
 interface WorkspaceHandSurface<Zone extends string, Card> {
-    readonly Hand: WorkspaceZoneCardsComponent<Card>;
+    readonly Hand: WorkspaceInteractionSlotComponent<{
+        children: ReactNode;
+    }>;
+    readonly Cards: WorkspaceHandCardsComponent<Card>;
+    readonly Summary: WorkspaceHandSummaryComponent;
+    readonly Actions: WorkspaceHandSummaryComponent;
     readonly Card: WorkspaceZoneCardComponent<Card>;
     readonly Staging: WorkspaceZoneStagingComponent<Card>;
     readonly slot: {

package/dist/runtime/workspace-contract.js

@@ -1,13 +1,14 @@
 import {
   createWorkspaceUIContract
-} from "../chunk-3K362ZKR.js";
-import "../chunk-CZMFAS3E.js";
-import "../chunk-XJYUSD5F.js";
+} from "../chunk-6JQFGSLD.js";
+import "../chunk-WOWFONLZ.js";
+import "../chunk-FWVV2X74.js";
 import "../chunk-T3ZKNUZ7.js";
-import "../chunk-7W6TQO3X.js";
+import "../chunk-45FI6XII.js";
 import "../chunk-VDXOF4FW.js";
-import "../chunk-MALRKLRR.js";
-import "../chunk-AEUXCFGM.js";
+import "../chunk-O6M6PN4E.js";
+import "../chunk-WUIVY2KE.js";
+import "../chunk-PF7L4BMG.js";
 import "../chunk-PZ5AY32C.js";
 export {
   createWorkspaceUIContract

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

@@ -0,0 +1,198 @@
+import './runtime-api-C6aWo9c0.js';
+
+/** Choice option surfaced on a prompt-kind interaction's structured context. */
+interface InteractionContextOption {
+    id: string;
+    label?: string;
+}
+/** Structured context attached to a prompt-kind InteractionDescriptor. */
+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[];
+}
+type InteractionCommitPolicy = {
+    mode: "manual";
+} | {
+    mode: "autoWhenReady";
+};
+type InputSelection = {
+    mode: "single";
+} | {
+    mode: "many";
+    min: number;
+    max?: number;
+    distinct?: boolean;
+};
+type InputDomain = CardTargetDomain | BoardTargetDomain | ResourceMapDomain | BoundedNumberDomain | ChoiceDomain | ChoiceListDomain;
+type InputDomainResolver = EagerInputDomainDependencies | LazyInputDomainDependencies;
+interface EagerInputDomainDependencies {
+    mode: "eager";
+    dependentCases: readonly InputDomainDependencyCase[];
+}
+interface LazyInputDomainDependencies {
+    mode: "lazy";
+    dependsOn: readonly string[];
+    resolver: {
+        interactionKey?: string;
+        inputKey: string;
+    };
+}
+interface ResolvedCardTargetDomain {
+    type: "cardTarget";
+    projection: "resolved";
+    zoneId?: string;
+    zoneIds?: readonly string[];
+    eligibleTargets: readonly string[];
+    selection?: InputSelection;
+    dependencies?: InputDomainResolver;
+}
+interface LazyCardTargetDomain {
+    type: "cardTarget";
+    projection: "lazy";
+    zoneId?: string;
+    zoneIds?: readonly string[];
+    selection?: InputSelection;
+    dependencies: LazyInputDomainDependencies;
+}
+type CardTargetDomain = ResolvedCardTargetDomain | LazyCardTargetDomain;
+interface ResolvedBoardTargetDomain {
+    type: "boardTarget";
+    projection: "resolved";
+    targetKind: string;
+    boardId?: string;
+    eligibleTargets: readonly string[];
+    selection?: InputSelection;
+    dependencies?: InputDomainResolver;
+}
+interface LazyBoardTargetDomain {
+    type: "boardTarget";
+    projection: "lazy";
+    targetKind: string;
+    boardId?: string;
+    selection?: InputSelection;
+    dependencies: LazyInputDomainDependencies;
+}
+type BoardTargetDomain = ResolvedBoardTargetDomain | LazyBoardTargetDomain;
+interface ResourceMapDomain {
+    type: "resourceMap";
+    resources?: ReadonlyArray<{
+        resourceId: string;
+        label?: string;
+        icon?: string;
+        min: number;
+        max: number;
+    }>;
+    dependencies?: InputDomainResolver;
+}
+interface BoundedNumberDomain {
+    type: "boundedNumber";
+    min?: number;
+    max?: number;
+    step?: number;
+    dependencies?: InputDomainResolver;
+}
+interface ChoiceDomain {
+    type: "choice";
+    choices?: readonly InteractionChoiceOption[];
+    selection?: InputSelection;
+    dependencies?: InputDomainResolver;
+}
+interface ChoiceListDomain {
+    type: "choiceList";
+    choices?: readonly InteractionChoiceOption[];
+    min?: number;
+    max?: number;
+    selection?: InputSelection;
+    dependencies?: InputDomainResolver;
+}
+interface InputDomainDependencyCase {
+    when: Readonly<Record<string, string>>;
+    domain: InputDomain;
+}
+interface InteractionChoiceOption {
+    value: string | null;
+    label: string;
+    icon?: string;
+    badge?: string;
+    description?: string;
+    disabled?: boolean;
+    disabledReason?: string;
+}
+interface InteractionInputDescriptor {
+    key: string;
+    kind: string;
+    domain: InputDomain;
+    defaultValue?: unknown;
+}
+interface InteractionDiagnosticReason {
+    ruleId: string;
+    errorCode: string;
+}
+type InteractionAvailability = {
+    status: "available";
+} | {
+    status: "notYourTurn";
+    reason: string;
+} | {
+    status: "insufficientResources";
+    reason: string;
+    missingResources: Readonly<Record<string, number>>;
+} | {
+    status: "blocked";
+    reason: string;
+    code?: string;
+};
+interface InteractionDescriptorBase<Key extends string = string> {
+    phaseName: string;
+    interactionKey: Key;
+    interactionId: string;
+    /** Draft commit policy. Always materialized by the trusted reducer bundle. */
+    commit: InteractionCommitPolicy;
+    /** Canonical descriptor digest used by browser replay/protocol tooling when projected by the host. */
+    descriptorDigest?: string;
+    /** Explicit authoring/runtime actor seat used by browser replay draft digests. */
+    actorSeat?: number;
+    /** Canonical draft digest used by browser replay/protocol tooling when projected by the host. */
+    draftDigest?: string;
+    /** 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>;
+    /** Authoritative availability state for this descriptor. */
+    availability: InteractionAvailability;
+    /** Optional verbose diagnostics for dev tooling; omitted from production projections. */
+    reasons?: readonly InteractionDiagnosticReason[];
+}
+type ActionInteractionDescriptor<Key extends string = string> = InteractionDescriptorBase<Key> & {
+    kind: "action";
+};
+type PromptInteractionDescriptor<Key extends string = string> = InteractionDescriptorBase<Key> & {
+    kind: "prompt";
+    /** Structured prompt context for prompt-kind interactions. */
+    context: InteractionContext;
+};
+type InteractionDescriptor<Key extends string = string> = ActionInteractionDescriptor<Key> | PromptInteractionDescriptor<Key>;
+/**
+ * Per-player view of a single zone. Mirrors the ZoneHandles wire shape from
+ * the trusted bundle's resolveZoneHandles; `cardViewsById` is JSON-serialized
+ * `ViewCard` and `playableByCardId` lists the interactions that are playable
+ * on each card (eligibility already filtered by each interaction's validate).
+ */
+interface ZoneHandlesSnapshot<InteractionType extends string = string> {
+    cardIds: readonly string[];
+    cardViewsById: Readonly<Record<string, string>>;
+    playableByCardId: Readonly<Record<string, ReadonlyArray<InteractionDescriptor<InteractionType>>>>;
+}
+
+export type { InputDomain as I, ZoneHandlesSnapshot as Z, InteractionDescriptor as a, InteractionInputDescriptor as b };

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

@@ -0,0 +1,95 @@
+type PlayerId = string;
+
+/**
+ * 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;
+}
+type RuntimeDiagnosticEvent = {
+    type: "runtimeLog";
+    level: "log" | "warn" | "error";
+    message: string;
+    details?: readonly unknown[];
+} | {
+    type: "internalError";
+    code: string;
+    message: string;
+    stack?: string;
+};
+type RuntimeDiagnosticHandler = (event: RuntimeDiagnosticEvent) => void;
+/**
+ * Plugin session state
+ */
+interface PluginSessionState {
+    /** Session initialization status */
+    status: "loading" | "ready";
+    /** Current session ID (null if not initialized) */
+    sessionId: string | null;
+    /** The player perspective represented by the current gameplay frame */
+    controllingPlayerId: PlayerId | 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 interactionId - Identifier of the interaction
+     * @param params - Interaction-specific payload
+     * @returns Promise that resolves with validation result
+     */
+    validateInteraction: (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 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: (interactionId: string, params: unknown) => Promise<void>;
+    emitDiagnostic?: (event: RuntimeDiagnosticEvent) => void;
+    setDiagnosticHandler?: (handler: RuntimeDiagnosticHandler | undefined) => 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;
+}
+
+export type { PlayerId as P, RuntimeAPI as R, SubmissionError as S, ValidationResult as V, PluginSessionState as a, RuntimeDiagnosticEvent as b, RuntimeDiagnosticHandler as c };

package/dist/runtime.d.ts

@@ -1,53 +1,43 @@
-import { b1 as UIContract$1, A as DreamboardUI$1, a$ as TypedGame$1 } from './ui-contract-W2-kxObe.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-W2-kxObe.js';
-export { a as InteractionDescriptor } from './runtime-api-BXd70c2e.js';
+import { b1 as UIContract$1, A as DreamboardUI$1, a$ as TypedGame$1 } from './ui-contract-CY7cxsCC.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-CY7cxsCC.js';
 export { ClientParamSchemaMap, WorkspaceBoardSurface, WorkspaceBoardSurfaceDescriptor, WorkspaceBoardTargetInputSlot, WorkspaceCardCollectionSurface, WorkspaceCardCollectionSurfaceDescriptor, WorkspaceCardInputSlot, WorkspaceFormInputSlot, WorkspaceHandSurface, WorkspaceHandSurfaceDescriptor, WorkspaceInteractionFormDescriptor, WorkspaceInteractionFormsDescriptor, WorkspaceInteractionSlotComponent, WorkspacePileSurface, WorkspacePileSurfaceDescriptor, WorkspacePilesSurfaceDescriptor, WorkspaceSurfaceSpec, createWorkspaceUIContract } from './runtime/workspace-contract.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
-export { b as ResourceCounterComponents } from './ResourceCounter-BTXklCEZ.js';
-import './hex-board-view-UCUjMALd.js';
-import './ui/player-state.js';
+import { c as RuntimeDiagnosticHandler } from './runtime-api-C6aWo9c0.js';
+import { P as PluginRuntimeClient, a as PluginRuntimeClientOptions, b as PluginTransport } from './types-CYeN0wLK.js';
+export { R as RuntimeClock, c as RuntimeIdFactory } from './types-CYeN0wLK.js';
+export { a as InteractionDescriptor } from './runtime-api-BJharVaj.js';
+export { b as ResourceCounterComponents } from './ResourceCounter-BuiNstXs.js';
+import './hex-board-view-Kz9Q_zsv.js';
+import './player-state-Cqpyeql0.js';
 import './types.js';
-import './hex-color-MhOyuY-o.js';
-import './ThemeProvider-DvMl17Ny.js';
+import './ThemeProvider-B1sIoBlX.js';
 import './primitive-props-BNHDkgd7.js';
-import './attributes-BrZtP9az.js';
-import './types-BqzHkNMA.js';
-
-type PluginRuntimeDiagnosticEvent = {
-    type: "runtimeLog";
-    level: "log" | "warn" | "error";
-    message: string;
-    details?: readonly unknown[];
-} | {
-    type: "internalError";
-    code: string;
-    message: string;
-    stack?: string;
-};
-type PluginRuntimeDiagnosticHandler = (event: PluginRuntimeDiagnosticEvent) => void;
+import './attributes-DbvyMbXw.js';
+import './types-DJj5MJkl.js';
+import './protocol-BP193lva.js';
 
 interface PluginRuntimeProps {
-    /** Child components to render after state sync has started */
+    /** Child components to render after gameplay frame has started */
     children: react__default.ReactNode;
     /**
-     * Timeout in milliseconds to wait for the first state-sync snapshot.
+     * Timeout in milliseconds to wait for the first gameplay-frame snapshot.
      * @default 10000 (10 seconds)
      */
     timeout?: number;
-    /** Custom loading component to show while waiting for state sync */
+    /** Custom loading component to show while waiting for gameplay frame */
     loadingComponent?: react__default.ReactNode;
     /** Custom error component to show when initialization fails */
     errorComponent?: (error: string) => react__default.ReactNode;
-    onDiagnostic?: PluginRuntimeDiagnosticHandler;
+    onDiagnostic?: RuntimeDiagnosticHandler;
 }
 /**
  * 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
+ * - Creates a transport-backed runtime client
+ * - Waits for the first projected gameplay frame before rendering children
+ * - Provides runtime commands plus session/frame state to all child components
  *
  * @example
  * ```tsx
@@ -64,6 +54,20 @@ interface PluginRuntimeProps {
  */
 declare function PluginRuntime({ children, timeout, loadingComponent, errorComponent, onDiagnostic, }: PluginRuntimeProps): react_jsx_runtime.JSX.Element;
 
+declare function PluginRuntimeBoundary({ runtime, children, }: {
+    runtime: PluginRuntimeClient;
+    children: react__default.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare function createPluginRuntimeClient(options: PluginRuntimeClientOptions): PluginRuntimeClient;
+
+interface PostMessagePluginTransportOptions {
+    readonly targetWindow?: Window;
+    readonly parentWindow?: Window;
+    readonly onInvalidMessage?: (reason: string, value: unknown) => void;
+}
+declare function createPostMessagePluginTransport(options?: PostMessagePluginTransportOptions): PluginTransport;
+
 interface DreamboardUIRegister {
     readonly __dreamboardUIRegister?: never;
 }
@@ -75,4 +79,4 @@ 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 };
+export { type DreamboardUI, type DreamboardUIRegister, PluginRuntime, PluginRuntimeBoundary, PluginRuntimeClient, PluginRuntimeClientOptions, type PluginRuntimeProps, PluginTransport, type PostMessagePluginTransportOptions, type RegisteredUI, type TypedGame, type UIContract, createPluginRuntimeClient, createPostMessagePluginTransport };