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

package/dist/runtime/primitives.d.ts

@@ -1,16 +1,17 @@
-import { bd as ZoneCardRenderItem } from '../ui-contract-BUC6iS3s.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-BUC6iS3s.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-BeRyboMS.js';
+import '../ThemeProvider-B1sIoBlX.js';
+import '../attributes-DbvyMbXw.js';
+import '../types-DJj5MJkl.js';
+import '../runtime-api-C6aWo9c0.js';
 
 interface InteractionDraftReadiness {
     values: Record<string, unknown>;
@@ -222,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,14 +82,17 @@ import {
   useZoneCards,
   useZonePileContext,
   useZonePrimitiveContext
-} from "../chunk-P7F4L2FF.js";
-import "../chunk-2LDZ5C3T.js";
-import "../chunk-Q5O7GPVY.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-QLG6VEMW.js";
+import "../chunk-O6M6PN4E.js";
+import "../chunk-WUIVY2KE.js";
+import "../chunk-PF7L4BMG.js";
 import "../chunk-PZ5AY32C.js";
 export {
   Board,
@@ -107,6 +110,7 @@ export {
   Game,
   GameChrome,
   GameRoot,
+  GameViewport,
   HandSurfaceView,
   Interaction,
   InteractionCardInput,
@@ -132,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,30 +1,18 @@
-import { l as BoardSpaceTargetProps, bh as ZoneListProps, b1 as UIContract$1, A as DreamboardUI$1, a$ as TypedGame$1 } from '../ui-contract-BUC6iS3s.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-BUC6iS3s.js';
-import { H as HandRole } from '../ResourceCounter-BTXklCEZ.js';
-export { b as ResourceCounterComponents } from '../ResourceCounter-BTXklCEZ.js';
-import '../runtime-api-BXd70c2e.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 { 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-BuiNstXs.js';
+export { b as ResourceCounterComponents } from '../ResourceCounter-BuiNstXs.js';
+import 'react/jsx-runtime';
+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 '../runtime-api-BJharVaj.js';
+import '../runtime-api-C6aWo9c0.js';
 import '../primitive-props-BNHDkgd7.js';
-import '../attributes-BeRyboMS.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';
 
 interface ClientParamSchema {
     safeParse: (value: unknown) => {
@@ -42,43 +30,6 @@ 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;
-    onDiagnostic?: PluginRuntimeDiagnosticHandler;
-}
-/**
- * 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, onDiagnostic, }: PluginRuntimeProps): react_jsx_runtime.JSX.Element;
-
 type WorkspaceInteractionSlotComponent<Props = object> = (props: Props extends {
     children: unknown;
 } ? Props : Props & {
@@ -148,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: {
@@ -203,7 +165,7 @@ type WorkspaceSurfaceDescriptor = WorkspaceBoardSurfaceDescriptor | WorkspaceHan
 interface WorkspaceSurfaceSpec {
     readonly [key: string]: WorkspaceSurfaceDescriptor | WorkspaceSurfaceSpec;
 }
-interface WorkspaceContractOptions<Contract extends UIContract$1, Resource extends string, Card, HexBoards extends Record<string, unknown>> {
+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>;
@@ -217,16 +179,6 @@ interface WorkspaceContractOptions<Contract extends UIContract$1, Resource exten
     readonly zoneIdFromZoneCard: (card: Card) => string;
 }
 
-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>;
+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 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 };
+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 };

package/dist/runtime/workspace-contract.js

@@ -1,12 +1,14 @@
 import {
   createWorkspaceUIContract
-} from "../chunk-4G7552LO.js";
-import "../chunk-P7F4L2FF.js";
-import "../chunk-2LDZ5C3T.js";
+} from "../chunk-6JQFGSLD.js";
+import "../chunk-WOWFONLZ.js";
+import "../chunk-FWVV2X74.js";
 import "../chunk-T3ZKNUZ7.js";
-import "../chunk-Q5O7GPVY.js";
+import "../chunk-45FI6XII.js";
 import "../chunk-VDXOF4FW.js";
-import "../chunk-QLG6VEMW.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-json-CQ9QbLZ5.d.ts

@@ -0,0 +1,5 @@
+type RuntimeJson = null | boolean | number | string | RuntimeJson[] | {
+    [key: string]: RuntimeJson;
+};
+
+export type { RuntimeJson as R };

package/dist/runtime.d.ts

@@ -1,13 +1,82 @@
-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-BUC6iS3s.js';
-export { a as InteractionDescriptor } from './runtime-api-BXd70c2e.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 { 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';
+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-BeRyboMS.js';
+import './attributes-DbvyMbXw.js';
+import './types-DJj5MJkl.js';
+import './protocol-BP193lva.js';
+
+interface PluginRuntimeProps {
+    /** Child components to render after gameplay frame has started */
+    children: react__default.ReactNode;
+    /**
+     * 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 gameplay frame */
+    loadingComponent?: react__default.ReactNode;
+    /** Custom error component to show when initialization fails */
+    errorComponent?: (error: string) => react__default.ReactNode;
+    onDiagnostic?: RuntimeDiagnosticHandler;
+}
+/**
+ * PluginRuntime provides the RuntimeContext for plugin components.
+ *
+ * This component:
+ * - 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
+ * // 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, 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;
+}
+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, PluginRuntimeBoundary, PluginRuntimeClient, PluginRuntimeClientOptions, type PluginRuntimeProps, PluginTransport, type PostMessagePluginTransportOptions, type RegisteredUI, type TypedGame, type UIContract, createPluginRuntimeClient, createPostMessagePluginTransport };