@dreamboard-games/sdk 0.2.0

package/dist/runtime/primitives.d.ts

@@ -0,0 +1,226 @@
+import { bf as ZoneCardRenderItem } from '../ui-contract-iQfTtUSL.js';
+export { B as Board, a as BoardEdgeTarget, b as BoardEdgeTargetProps, c as BoardHexGrid, d as BoardHexGridInteractionFilter, e as BoardHexGridInteractions, f as BoardHexGridProps, g as BoardHexView, h as BoardHexViewProps, i as BoardRoot, j as BoardRootProps, k as BoardSpaceTarget, l as BoardSpaceTargetProps, m as BoardState, n as BoardStateProps, o as BoardTarget, p as BoardTargetExtraInputs, q as BoardTargetProps, r as BoardVertexTarget, s as BoardVertexTargetProps, D as Dice, t as DiceComponents, u as DiceRoot, v as DiceRootProps, w as DiceState, x as DiceValue, y as DiceValues, z as DiceValuesProps, G as Game, C as GameActiveActionState, E as GameChrome, F as GameChromeProps, H as GameChromeState, I as GameMeState, J as GamePendingInputState, K as GamePlayer, L as GamePlayerEntry, M as GamePlayersState, N as GameRenderState, O as GameRoot, P as GameRootProps, Q as GameTurnState, R as Interaction, S as InteractionCardInput, T as InteractionCardInputProps, U as InteractionCardInputRenderState, V as InteractionDescription, W as InteractionDialog, X as InteractionDialogProps, Y as InteractionDialogRenderState, Z as InteractionDialogState, _ as InteractionFieldPrimitiveProps, $ as InteractionFormPrimitive, a0 as InteractionFormPrimitiveProps, a1 as InteractionInput, a2 as InteractionInputProps, a3 as InteractionLabel, a4 as InteractionPartProps, a5 as InteractionRoot, a6 as InteractionRootProps, a7 as InteractionRoute, a8 as InteractionRoutes, a9 as InteractionRoutesMap, aa as InteractionRoutesProps, ab as InteractionState, ac as InteractionStateProps, ad as InteractionStateSnapshot, ae as InteractionSubmit, af as InteractionSubmitProps, ag as InteractionSwitch, ah as InteractionSwitchProps, ai as InteractionSwitchRenderState, aj as InteractionSwitchRouteMap, ak as InteractionTrigger, al as InteractionTriggerProps, am as InteractionUnavailableMessage, an as InteractionValidationMessage, ao as Phase, ap as PhaseFallback, aq as PhaseRouteMap, ar as PhaseSwitch, as as PhaseSwitchProps, at as PlayerRoster, au as PlayerRosterBadge, av as PlayerRosterBadges, aw as PlayerRosterComponents, ax as PlayerRosterEmpty, ay as PlayerRosterEntry, az as PlayerRosterList, aA as PlayerRosterListProps, aB as PlayerRosterName, aC as PlayerRosterPartProps, aD as PlayerRosterRoot, aE as PlayerRosterRootProps, aF as PlayerRosterScore, aG as PlayerRosterSwitchButton, aH as PlayerRosterSwitchButtonProps, aI as PrimitiveCommonProps, aJ as PrimitiveDataAttributes, aK as Prompt, aL as PromptDialog, aM as PromptDialogProps, aN as PromptDialogRenderState, aO as PromptDialogState, aP as PromptInbox, aQ as PromptInboxEmpty, aR as PromptInboxItems, aS as PromptInboxItemsProps, aT as PromptInboxRoot, aU as PromptMessage, aV as PromptOption, aW as PromptOptionProps, aX as PromptOptionRenderItem, aY as PromptOptions, aZ as PromptOptionsProps, a_ as PromptRoot, a$ as PromptRootProps, b0 as PromptTitle, b2 as UI, b4 as UIRoot, b5 as UIRootProps, b6 as UseZoneCardsOptions, b7 as UseZoneCardsResult, b8 as Zone, b9 as ZoneCardAction, ba as ZoneCardActionExtraInputs, bb as ZoneCardActionProps, bc as ZoneCardActionResult, bd as ZoneCardAt, be as ZoneCardAtProps, bg as ZoneItem, bh as ZoneItemProps, bi as ZoneList, bj as ZoneListProps, bk as ZonePileCards, bl as ZonePileCardsProps, bm as ZonePileContextValue, bn as ZonePileCount, bo as ZonePileCountProps, bp as ZonePileDescription, bq as ZonePileDescriptionProps, br as ZonePileLabel, bs as ZonePileLabelProps, bt as ZonePileRoot, bu as ZonePileRootProps, bv as ZonePileTrigger, bw as ZonePileTriggerProps, bx as ZoneRoot, by as ZoneRootProps, bz as ZoneTopCard, bA as ZoneTopCardProps, bB as composeEventHandlers, bC as createZoneCardRenderItem, bD as normalizeDiceState, bE as renderPrimitive, bF as useBoardPrimitiveContext, bG as useDicePrimitiveContext, bH as useGameActionError, bI as useInteractionPrimitiveContext, bJ as useOptionalZonePrimitiveContext, bK as useResolvedCardTargetValue, bL as useZoneCardContext, bM as useZoneCards, bN as useZonePileContext, bO as useZonePrimitiveContext } from '../ui-contract-iQfTtUSL.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { a as CardIntent, I as InteractionVisualState, b as HandLayoutKind, c as HandLayoutPolicy, H as HandInteractionPolicy, C as CardDropTargetVisualState } from '../HandView-ncJIVLhN.js';
+import { a as InteractionDescriptor, P as PluginStateSnapshot } from '../runtime-api-DWxvTr-O.js';
+import '../hex-board-view-D_07hO6O.js';
+import '../ui/types/player-state.js';
+import '../cards-Sl3b40Mv.js';
+import '../hex-color-MhOyuY-o.js';
+import '../ThemeProvider-fy0_QzgO.js';
+import '../runtime-api-3dshj6kK.js';
+
+interface InteractionDraftReadiness {
+    values: Record<string, unknown>;
+    missingInputs: readonly string[];
+    readyFrontier: readonly string[];
+    blockedInputs: readonly string[];
+    fieldErrors: Partial<Record<string, readonly string[]>>;
+    ready: boolean;
+}
+
+type RuntimeDropTargetKind = "card" | "space" | "edge" | "vertex" | "tile";
+type CardIntentResult = {
+    status: "ignored";
+    reason: CardIntentIgnoredReason;
+} | {
+    status: "pending";
+    descriptor: InteractionDescriptor;
+    readiness: InteractionDraftReadiness;
+    params: Record<string, unknown>;
+} | {
+    status: "submitted";
+    descriptor: InteractionDescriptor;
+    readiness: InteractionDraftReadiness;
+    params: Record<string, unknown>;
+} | {
+    status: "submitting";
+    descriptor: InteractionDescriptor;
+    readiness: InteractionDraftReadiness;
+    params: Record<string, unknown>;
+} | {
+    status: "error";
+    descriptor: InteractionDescriptor;
+    error: unknown;
+};
+type CardIntentIgnoredReason = "no-descriptor" | "interaction-unavailable" | "no-card-input" | "card-not-eligible" | "drop-target-not-decodable" | "drop-target-input-unknown" | "drop-target-not-eligible" | "ambiguous-drop" | "already-submitting";
+
+type RuntimeCardIntentResult = CardIntentResult;
+/**
+ * Author-facing card intent. Mirrors the SDK shape, but for `drop` intents
+ * `targetId` is the manifest id (e.g. `"hex-a"`) — the runtime adapter
+ * decodes the opaque SDK target id before invoking author callbacks. This
+ * matches the type the generated `hand.Hand` facade declares.
+ */
+type AuthoredCardIntent = {
+    type: "activate";
+    cardId: string;
+    source: "tap" | "keyboard";
+} | {
+    type: "previewStart";
+    cardId: string;
+} | {
+    type: "previewEnd";
+    cardId: string;
+} | {
+    type: "drop";
+    cardId: string;
+    targetId: string;
+    source: "pointer" | "keyboard";
+};
+/**
+ * Translate a raw SDK `CardIntent` into the author-facing
+ * `AuthoredCardIntent` shape. For drop intents the opaque encoded
+ * `targetId` is decoded into its manifest value; non-decodable target
+ * ids fall through unchanged so authors can detect and ignore them.
+ */
+declare function decodeAuthoredCardIntent(intent: CardIntent): AuthoredCardIntent;
+interface UseCardIntentAdapterOptions {
+    /** Zone the hand is rendering. Used for snapshot lookup. */
+    zone: string;
+    /**
+     * Optional hook for the host to react to the runtime classification of an
+     * intent. Useful for confirmation animations or analytics. The intent is
+     * already routed by the time this fires. Receives the decoded
+     * authored-shape intent so `targetId` is the manifest id, not the SDK
+     * opaque encoding.
+     */
+    onResult?: (intent: AuthoredCardIntent, result: RuntimeCardIntentResult) => void;
+}
+/**
+ * Bind SDK card intent emission to the canonical runtime collector pipeline.
+ *
+ * The returned callback accepts the SDK `CardIntent` shape unchanged. The
+ * adapter looks up the descriptor for the originating card, atomically
+ * applies the card and any decoded drop-target inputs, and routes
+ * pending/submitting/submitted classifications through the runtime API.
+ *
+ * Preview intents are forwarded to the optional `onResult` callback as
+ * `ignored` results so authors can attach analytics without owning the
+ * routing logic themselves.
+ */
+declare function useCardIntentAdapter({ zone, onResult, }: UseCardIntentAdapterOptions): (intent: CardIntent) => Promise<RuntimeCardIntentResult>;
+
+interface RuntimeDropTarget {
+    /** Stable opaque id; runtime adapter encodes the inputKey + value here. */
+    targetId: string;
+    /** Plain text label used by the SDK live-region announcements. */
+    label: string;
+    /** Optional `CardDropTargetVisualState` overrides. */
+    visualState?: CardDropTargetVisualState;
+    /** Visible content inside the drop target. */
+    render: (state: CardDropTargetVisualState) => ReactNode;
+    /** ARIA role override. Defaults to "button". */
+    role?: string;
+    /** Extra container className. */
+    className?: string;
+    /** Order hint for keyboard traversal. */
+    order?: number;
+}
+/**
+ * Per-hand summary projected alongside the card list. Authors can render
+ * counts ("3 of 5 selected") without re-deriving selection state.
+ */
+interface HandSelectionSummary {
+    /** How many cards in this hand are part of the active many-select draft. */
+    selectedCount: number;
+    /** Card ids currently in the many-select draft, in iteration order. */
+    selectedIds: readonly string[];
+    /**
+     * Whether at least one descriptor in this zone has form-side validation
+     * errors against the current draft. Authors can use this to render an
+     * inline hint without inspecting individual fields.
+     */
+    hasInvalidSelection: boolean;
+}
+interface HandSurfaceViewProps<Card extends ZoneCardRenderItem> {
+    zone: string;
+    cards: readonly Card[];
+    /** Visual surface for a single card. */
+    renderCard: (card: Card, state: InteractionVisualState, index: number) => ReactNode;
+    /**
+     * Render-safe slot for selection summary content. Fires during render
+     * with the latest projected summary so authors can compose count chrome
+     * (e.g. "3 of 5 selected") inline. The returned node is hoisted above
+     * the hand region. Use this for visible UI; use `onSelectionSummary`
+     * only for analytics or external state mirrors that need an effect.
+     */
+    renderSummary?: (summary: HandSelectionSummary) => ReactNode;
+    /**
+     * Optional selection summary observer. Invoked from a layout effect so
+     * consumers may safely call `setState` in response. Use `renderSummary`
+     * for inline rendering instead — that path avoids effect-timing
+     * surprises.
+     */
+    onSelectionSummary?: (summary: HandSelectionSummary) => void;
+    /**
+     * Render-safe slot for the hand's commit/action chrome (e.g. a submit
+     * button for a many-select interaction). Receives the same live summary as
+     * `renderSummary`. Rendered below the hand inline on desktop and pinned as a
+     * sticky footer inside the mobile dock, so the action stays reachable while
+     * the hand is docked. Use this instead of anchoring the action elsewhere on
+     * the board, where the dock would otherwise hide it.
+     */
+    renderActions?: (summary: HandSelectionSummary) => ReactNode;
+    /** Layout policy forwarded to the SDK HandView. */
+    layout?: HandLayoutKind | HandLayoutPolicy;
+    /** Mobile interaction policy. Defaults to `direct-activate`. */
+    mobileInteraction?: HandInteractionPolicy;
+    /**
+     * Drop targets to render around the hand. When provided, the hand renders
+     * inside a `CardDragSurface` so SDK `drop` intents arrive with an opaque
+     * target id that the runtime adapter can decode.
+     */
+    dropTargets?: readonly RuntimeDropTarget[];
+    /**
+     * Optional outer chrome around the drop targets, when `dropTargets` is
+     * provided. Defaults to a flex row above the hand.
+     */
+    renderDropTargets?: (children: ReactNode) => ReactNode;
+    /** Card width hint forwarded to the SDK HandView. */
+    cardSize?: "sm" | "md" | "lg";
+    /** Extra empty-state slot. */
+    renderEmpty?: () => ReactNode;
+    /** ARIA label for the hand region. */
+    ariaLabel?: string;
+    /**
+     * Optional analytics hook. Receives the decoded authored intent (so
+     * `targetId` is the manifest value, not the SDK opaque encoding) plus
+     * the runtime classification.
+     */
+    onIntentRouted?: (intent: AuthoredCardIntent, result: RuntimeCardIntentResult) => void;
+    className?: string;
+}
+/**
+ * Generated hand presentation entry point.
+ *
+ * Lives in `ui-runtime` because it owns:
+ *
+ * - mapping descriptor/draft state into SDK `InteractionVisualState`
+ * - hiding selected cards from the visible hand layout while the runtime keeps
+ *   the actual zone snapshot intact
+ * - forwarding SDK `CardIntent` through the canonical collector adapter
+ *
+ * The component is intentionally Dreamboard-aware. The presentational
+ * pieces (`HandView`, `CardDragSurface`, `CardDropTargetView`) come from
+ * `@dreamboard-games/sdk/ui` and stay descriptor/draft unaware.
+ */
+declare function HandSurfaceView<Card extends ZoneCardRenderItem>({ zone, cards, renderCard, layout, mobileInteraction, dropTargets, renderDropTargets, cardSize, renderEmpty, ariaLabel, onIntentRouted, onSelectionSummary, renderSummary, renderActions, className, }: HandSurfaceViewProps<Card>): react_jsx_runtime.JSX.Element;
+/**
+ * Convenience helper for builders of generated hand surfaces. Encodes a
+ * typed target kind plus value into the opaque `targetId` that the SDK
+ * presents to its drop pipeline. The runtime adapter resolves the kind to
+ * the matching descriptor input at drop time, so authors never need to
+ * know collector input names. Generated typed targets call this internally.
+ */
+declare function dropTargetIdFor(kind: RuntimeDropTargetKind, value: string): string;
+/**
+ * Determine whether any descriptor in the available list expects a board or
+ * card destination input alongside a card target. Used by generated facades
+ * to decide whether to mount a drag surface even before the author wires
+ * dropTargets.
+ */
+declare function descriptorsHaveDestinationInput(state: PluginStateSnapshot): boolean;
+
+export { type AuthoredCardIntent, HandSurfaceView, type HandSurfaceViewProps, type RuntimeCardIntentResult, type RuntimeDropTarget, type UseCardIntentAdapterOptions, ZoneCardRenderItem, decodeAuthoredCardIntent, descriptorsHaveDestinationInput, dropTargetIdFor, useCardIntentAdapter };

package/dist/runtime/primitives.js

@@ -0,0 +1,180 @@
+import "../chunk-T52J5RMF.js";
+import {
+  Board,
+  BoardEdgeTarget,
+  BoardHexGrid,
+  BoardHexView,
+  BoardRoot,
+  BoardSpaceTarget,
+  BoardState,
+  BoardTarget,
+  BoardVertexTarget,
+  Dice,
+  DiceRoot,
+  DiceValues,
+  Game,
+  GameChrome,
+  GameRoot,
+  HandSurfaceView,
+  Interaction,
+  InteractionCardInput,
+  InteractionDescription,
+  InteractionDialog,
+  InteractionFormPrimitive,
+  InteractionInput,
+  InteractionLabel,
+  InteractionRoot,
+  InteractionRoutes,
+  InteractionState,
+  InteractionSubmit,
+  InteractionSwitch,
+  InteractionTrigger,
+  InteractionUnavailableMessage,
+  InteractionValidationMessage,
+  Phase,
+  PhaseSwitch,
+  PlayerRoster,
+  PlayerRosterBadges,
+  PlayerRosterEmpty,
+  PlayerRosterList,
+  PlayerRosterName,
+  PlayerRosterRoot,
+  PlayerRosterScore,
+  PlayerRosterSwitchButton,
+  Prompt,
+  PromptDialog,
+  PromptInbox,
+  PromptInboxEmpty,
+  PromptInboxItems,
+  PromptInboxRoot,
+  PromptMessage,
+  PromptOption,
+  PromptOptions,
+  PromptRoot,
+  PromptTitle,
+  UI,
+  UIRoot,
+  Zone,
+  ZoneCardAction,
+  ZoneCardAt,
+  ZoneItem,
+  ZoneList,
+  ZonePileCards,
+  ZonePileCount,
+  ZonePileDescription,
+  ZonePileLabel,
+  ZonePileRoot,
+  ZonePileTrigger,
+  ZoneRoot,
+  ZoneTopCard,
+  composeEventHandlers,
+  createZoneCardRenderItem,
+  decodeAuthoredCardIntent,
+  descriptorsHaveDestinationInput,
+  dropTargetIdFor,
+  normalizeDiceState,
+  renderPrimitive,
+  useBoardPrimitiveContext,
+  useCardIntentAdapter,
+  useDicePrimitiveContext,
+  useGameActionError,
+  useInteractionPrimitiveContext,
+  useOptionalZonePrimitiveContext,
+  useResolvedCardTargetValue,
+  useZoneCardContext,
+  useZoneCards,
+  useZonePileContext,
+  useZonePrimitiveContext
+} from "../chunk-TDSWKVZ4.js";
+import "../chunk-KAELH4KC.js";
+import "../chunk-WYPQ3GG5.js";
+import "../chunk-VDXOF4FW.js";
+import "../chunk-PZ5AY32C.js";
+export {
+  Board,
+  BoardEdgeTarget,
+  BoardHexGrid,
+  BoardHexView,
+  BoardRoot,
+  BoardSpaceTarget,
+  BoardState,
+  BoardTarget,
+  BoardVertexTarget,
+  Dice,
+  DiceRoot,
+  DiceValues,
+  Game,
+  GameChrome,
+  GameRoot,
+  HandSurfaceView,
+  Interaction,
+  InteractionCardInput,
+  InteractionDescription,
+  InteractionDialog,
+  InteractionFormPrimitive,
+  InteractionInput,
+  InteractionLabel,
+  InteractionRoot,
+  InteractionRoutes,
+  InteractionState,
+  InteractionSubmit,
+  InteractionSwitch,
+  InteractionTrigger,
+  InteractionUnavailableMessage,
+  InteractionValidationMessage,
+  Phase,
+  PhaseSwitch,
+  PlayerRoster,
+  PlayerRosterBadges,
+  PlayerRosterEmpty,
+  PlayerRosterList,
+  PlayerRosterName,
+  PlayerRosterRoot,
+  PlayerRosterScore,
+  PlayerRosterSwitchButton,
+  Prompt,
+  PromptDialog,
+  PromptInbox,
+  PromptInboxEmpty,
+  PromptInboxItems,
+  PromptInboxRoot,
+  PromptMessage,
+  PromptOption,
+  PromptOptions,
+  PromptRoot,
+  PromptTitle,
+  UI,
+  UIRoot,
+  Zone,
+  ZoneCardAction,
+  ZoneCardAt,
+  ZoneItem,
+  ZoneList,
+  ZonePileCards,
+  ZonePileCount,
+  ZonePileDescription,
+  ZonePileLabel,
+  ZonePileRoot,
+  ZonePileTrigger,
+  ZoneRoot,
+  ZoneTopCard,
+  composeEventHandlers,
+  createZoneCardRenderItem,
+  decodeAuthoredCardIntent,
+  descriptorsHaveDestinationInput,
+  dropTargetIdFor,
+  normalizeDiceState,
+  renderPrimitive,
+  useBoardPrimitiveContext,
+  useCardIntentAdapter,
+  useDicePrimitiveContext,
+  useGameActionError,
+  useInteractionPrimitiveContext,
+  useOptionalZonePrimitiveContext,
+  useResolvedCardTargetValue,
+  useZoneCardContext,
+  useZoneCards,
+  useZonePileContext,
+  useZonePrimitiveContext
+};
+//# sourceMappingURL=primitives.js.map

package/dist/runtime/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1 @@
+export { a as PluginSessionState, R as RuntimeAPI, S as SubmissionError, V as ValidationResult } from '../../runtime-api-3dshj6kK.js';

package/dist/runtime/types/runtime-api.js

@@ -0,0 +1,2 @@
+import "../../chunk-I46YJSOD.js";
+//# sourceMappingURL=runtime-api.js.map

package/dist/runtime/types/runtime-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,172 @@
+export { DreamboardUI, TypedGame, UIContract } from '../runtime.js';
+import { l as BoardSpaceTargetProps, bj as ZoneListProps, b3 as UIContract } from '../ui-contract-iQfTtUSL.js';
+export { f as BoardHexGridProps, h as BoardHexViewProps, I as GameMeState, M as GamePlayersState, N as GameRenderState, Q as GameTurnState, b5 as UIRootProps, bf as ZoneCardRenderItem } from '../ui-contract-iQfTtUSL.js';
+import { H as HandRole } from '../ResourceCounter-CTREyF73.js';
+export { b as ResourceCounterComponents } from '../ResourceCounter-CTREyF73.js';
+import '../runtime-api-DWxvTr-O.js';
+import { ReactNode, ReactElement, ButtonHTMLAttributes } from 'react';
+import 'react/jsx-runtime';
+import '../hex-board-view-D_07hO6O.js';
+import '../ui/types/player-state.js';
+import '../cards-Sl3b40Mv.js';
+import '../hex-color-MhOyuY-o.js';
+import '../ThemeProvider-fy0_QzgO.js';
+import '../runtime-api-3dshj6kK.js';
+import '../primitive-props-DpKs-GCr.js';
+
+interface ClientParamSchema {
+    safeParse: (value: unknown) => {
+        success: true;
+        data: Record<string, unknown>;
+    } | {
+        success: false;
+        error: {
+            issues: ReadonlyArray<{
+                path: readonly PropertyKey[];
+                message: string;
+            }>;
+        };
+    };
+}
+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, 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

@@ -0,0 +1,14 @@
+import {
+  createWorkspaceUIContract
+} from "../chunk-GKKBPPSW.js";
+import "../chunk-T3ZKNUZ7.js";
+import "../chunk-U5C6BONG.js";
+import "../chunk-TDSWKVZ4.js";
+import "../chunk-KAELH4KC.js";
+import "../chunk-WYPQ3GG5.js";
+import "../chunk-VDXOF4FW.js";
+import "../chunk-PZ5AY32C.js";
+export {
+  createWorkspaceUIContract
+};
+//# sourceMappingURL=workspace-contract.js.map

package/dist/runtime/workspace-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}