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

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,173 +1,27 @@
-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 { ReactNode, ReactElement, ButtonHTMLAttributes } from 'react';
-import { H as HandRole } from '../ResourceCounter-BTXklCEZ.js';
-export { b as ResourceCounterComponents } from '../ResourceCounter-BTXklCEZ.js';
+export { C as ClientParamSchemaMap, D as DefineGameUIConfig, W as WorkspaceBoardSurface, a as WorkspaceBoardSurfaceDescriptor, b as WorkspaceBoardTargetInputSlot, c as WorkspaceCardCollectionSurface, d as WorkspaceCardCollectionSurfaceDescriptor, e as WorkspaceCardInputSlot, f as WorkspaceFormInputSlot, g as WorkspaceHandSurface, h as WorkspaceHandSurfaceDescriptor, i as WorkspaceInteractionFormDescriptor, j as WorkspaceInteractionFormsDescriptor, k as WorkspaceInteractionSlotComponent, l as WorkspacePileSurface, m as WorkspacePileSurfaceDescriptor, n as WorkspacePilesSurfaceDescriptor, o as WorkspaceSurfaceSpec, p as createWorkspaceUIContract } from '../index-BLwlj7mO.js';
+import { Z as InteractionDialogProps } from '../ui-contract-CY7cxsCC.js';
+export { f as BoardHexGridProps, h as BoardHexViewProps, l as BoardSpaceTargetProps, A as DreamboardUI, I as GameMeState, M as GamePlayersState, N as GameRenderState, Q as GameTurnState, a$ as TypedGame, b1 as UIContract, b3 as UIRootProps, bd as ZoneCardRenderItem, bh as ZoneListProps } from '../ui-contract-CY7cxsCC.js';
+export { b as ResourceCounterComponents } from '../ResourceCounter-BuiNstXs.js';
+import { ReactNode } from 'react';
 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) => {
-        success: true;
-        data: Record<string, unknown>;
-    } | {
-        success: false;
-        error: {
-            issues: ReadonlyArray<{
-                path: readonly PropertyKey[];
-                message: string;
-            }>;
-        };
-    };
+interface WorkspaceInteractionFormDialogProps extends Omit<InteractionDialogProps, "children"> {
+    title: ReactNode;
+    description?: ReactNode;
+    trigger?: ReactNode;
+    children: ReactNode;
+    contentClassName?: string;
+    overlayClassName?: string;
+    showCloseButton?: boolean;
 }
-type ClientParamSchemaMap = Readonly<Record<string, Readonly<Record<string, ClientParamSchema>>>>;
 
-type WorkspaceInteractionSlotComponent<Props = object> = (props: Props extends {
-    children: unknown;
-} ? Props : Props & {
-    children?: ReactNode;
-}) => ReactElement | null;
-interface WorkspaceFormInputSlot<Input extends string = string> {
-    readonly Field: WorkspaceInteractionSlotComponent;
-    readonly Options: WorkspaceInteractionSlotComponent<{
-        children?: (option: {
-            value: unknown;
-            label: string;
-        }) => ReactNode;
-    }>;
-    readonly Value: WorkspaceInteractionSlotComponent<{
-        children: (value: unknown | undefined) => ReactNode;
-    }>;
-    readonly Default: WorkspaceInteractionSlotComponent;
-    readonly __input?: Input;
-}
-interface WorkspaceCardInputSlot<Card extends string = string> {
-    readonly Card: WorkspaceInteractionSlotComponent<{
-        value: Card;
-    } & Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "disabled" | "aria-disabled" | "aria-pressed" | "onClick" | "type" | "value">>;
-    readonly Cards: WorkspaceInteractionSlotComponent<{
-        children: (card: {
-            id: Card;
-        }) => ReactNode;
-    }>;
-    readonly Value: WorkspaceInteractionSlotComponent<{
-        children: (value: unknown | undefined) => ReactNode;
-    }>;
-    readonly Default: WorkspaceInteractionSlotComponent;
-}
-interface WorkspaceBoardTargetInputSlot<Kind extends "space" | "edge" | "vertex" | "tile", Target extends string = string> {
-    readonly Target: WorkspaceInteractionSlotComponent<{
-        value: Target;
-    } & Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "disabled" | "aria-disabled" | "aria-pressed" | "onClick" | "type" | "value">>;
-    readonly Value: WorkspaceInteractionSlotComponent<{
-        children: (value: unknown | undefined) => ReactNode;
-    }>;
-    readonly Default: WorkspaceInteractionSlotComponent;
-    readonly __kind?: Kind;
-}
-interface WorkspaceBoardSurface<Space extends string = string, Edge extends string = string, Vertex extends string = string, Tile extends string = string> {
-    readonly Root: WorkspaceInteractionSlotComponent;
-    readonly Space: <Target extends Space>(props: BoardSpaceTargetProps<Target>) => ReactElement | null;
-    readonly slot: {
-        readonly space: WorkspaceBoardTargetInputSlot<"space", Space>;
-        readonly playerSpace: WorkspaceBoardTargetInputSlot<"space", Space>;
-        readonly edge: WorkspaceBoardTargetInputSlot<"edge", Edge>;
-        readonly vertex: WorkspaceBoardTargetInputSlot<"vertex", Vertex>;
-        readonly tile: WorkspaceBoardTargetInputSlot<"tile", Tile>;
-    };
-}
-type WorkspaceZoneCardsComponent<Card> = WorkspaceInteractionSlotComponent<Omit<ZoneListProps, "children" | "empty"> & {
-    empty?: ReactNode;
-    children: (card: Card) => ReactNode;
-}>;
-type WorkspaceZoneCardComponent<Card> = WorkspaceInteractionSlotComponent<Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" | "value"> & {
-    card: Card;
-}>;
-type WorkspaceZoneStagingComponent<Card> = WorkspaceInteractionSlotComponent<{
-    children: (card: Card) => ReactNode;
-    label?: ReactNode;
-    renderEmptySlot?: (index: number) => ReactNode;
-    cardSize?: "sm" | "md" | "lg";
-    ariaLabel?: string;
-    className?: string;
-}>;
-interface WorkspaceHandSurface<Zone extends string, Card> {
-    readonly Hand: WorkspaceZoneCardsComponent<Card>;
-    readonly Card: WorkspaceZoneCardComponent<Card>;
-    readonly Staging: WorkspaceZoneStagingComponent<Card>;
-    readonly slot: {
-        readonly card: WorkspaceCardInputSlot<Zone>;
-    };
-}
-interface WorkspacePileSurface<Card> {
-    readonly Pile: WorkspaceZoneCardsComponent<Card>;
-    readonly Card: WorkspaceZoneCardComponent<Card>;
-}
-interface WorkspaceCardCollectionSurface<Zone extends string, Card> {
-    readonly Collection: WorkspaceZoneCardsComponent<Card>;
-    readonly Card: WorkspaceZoneCardComponent<Card>;
-    readonly slot: {
-        readonly card: WorkspaceCardInputSlot<Zone>;
-    };
-}
-interface WorkspaceBoardSurfaceDescriptor<Board extends string = string> {
-    readonly kind: "board";
-    readonly board: Board;
-}
-interface WorkspaceHandSurfaceDescriptor<Zone extends string = string> {
-    readonly kind: "hand";
-    readonly zone: Zone;
-    readonly role: HandRole;
-    readonly label: string;
-    readonly order?: number;
-}
-interface WorkspacePileSurfaceDescriptor<Zone extends string = string> {
-    readonly kind: "pile";
-    readonly zone: Zone;
-}
-interface WorkspacePilesSurfaceDescriptor<Zones extends readonly string[] = readonly string[]> {
-    readonly kind: "piles";
-    readonly zones: Zones;
-}
-interface WorkspaceCardCollectionSurfaceDescriptor<Zones extends readonly string[] = readonly string[]> {
-    readonly kind: "cardCollection";
-    readonly zones: Zones;
-    readonly mode?: "all" | "top-card";
-}
-interface WorkspaceInteractionFormsDescriptor<Interactions extends Readonly<Record<string, string>> = Readonly<Record<string, string>>> {
-    readonly kind: "forms";
-    readonly interactions: Interactions;
-}
-interface WorkspaceInteractionFormDescriptor<Interaction extends string = string> {
-    readonly kind: "form";
-    readonly interaction: Interaction;
-}
-type WorkspaceSurfaceDescriptor = WorkspaceBoardSurfaceDescriptor | WorkspaceHandSurfaceDescriptor | WorkspacePileSurfaceDescriptor | WorkspacePilesSurfaceDescriptor | WorkspaceCardCollectionSurfaceDescriptor | WorkspaceInteractionFormDescriptor | WorkspaceInteractionFormsDescriptor;
-interface WorkspaceSurfaceSpec {
-    readonly [key: string]: WorkspaceSurfaceDescriptor | WorkspaceSurfaceSpec;
-}
-interface WorkspaceContractOptions<Contract extends UIContract, Resource extends string, Card, HexBoards extends Record<string, unknown>> {
-    readonly uiContract: Contract;
-    readonly clientParamSchemasByPhase?: ClientParamSchemaMap;
-    readonly formInputKeysForInteraction: (interaction: string) => ReadonlySet<string>;
-    readonly resourceIds: readonly Resource[];
-    readonly resourcePresentationById?: Partial<Record<string, {
-        label?: string;
-        icon?: string;
-    }>>;
-    readonly hexStaticBoards: HexBoards;
-    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, 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, createWorkspaceUIContract };
+export type { WorkspaceInteractionFormDialogProps };

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 };