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

package/dist/{hex-board-view-Kz9Q_zsv.d.ts → hex-board-view-BFlWDb9k.d.ts}

@@ -524,6 +524,121 @@ type NormalizedSquareBoard<TBoard extends AnySquareBoardInput> = Pick<SquareBoar
 declare function normalizeHexBoardInput<TBoard extends AnyHexBoardInput>(board: TBoard): NormalizedHexBoard<TBoard>;
 declare function normalizeSquareBoardInput<TBoard extends AnySquareBoardInput>(board: TBoard): NormalizedSquareBoard<TBoard>;
 
+/**
+ * Controlled visual state contract for `@dreamboard-games/sdk/ui` components.
+ *
+ * The SDK is Dreamboard-interaction unaware: components consume `display data`
+ * and `controlled semantic states`. Runtime adapters compute these states from
+ * descriptors/drafts and pass them in as plain props.
+ */
+/**
+ * Generic semantic state attached to a presentational component.
+ *
+ * Every flag is optional and renders as a stable `data-*` attribute on the
+ * underlying element so that selectors, snapshot diffs and accessibility
+ * announcements can react to state without inspecting class strings.
+ */
+interface InteractionVisualState {
+    /** Caller may activate this surface right now. */
+    eligible?: boolean;
+    /**
+     * Eligible *and* a meaningful subset — i.e. at least one peer surface is not
+     * eligible. Use this (rather than `eligible`) to drive a "highlight the
+     * playable cards" affordance: when every card in a hand is a legal target
+     * (e.g. a pass where any card may be chosen, or a turn where you may play
+     * anything) the highlight carries no information, so `distinctlyEligible` is
+     * `false` for all of them and the ring naturally disappears. `eligible`
+     * keeps its literal meaning ("is a legal target") for dimming/logic.
+     */
+    distinctlyEligible?: boolean;
+    /** Currently chosen as part of a draft selection or focus state. */
+    selected?: boolean;
+    /** Surface is non-interactive and visually muted. */
+    disabled?: boolean;
+    /** Caller's draft is invalid — render an error tint without removing the surface. */
+    invalid?: boolean;
+    /** Action has been submitted; render a settled/locked feedback state. */
+    submitted?: boolean;
+    /** Surface is being previewed (long-press, hover hold) without commitment. */
+    previewing?: boolean;
+    /**
+     * Optional 0..1 progress reading for an in-flight UI intent (swipe, hold,
+     * etc.). Components may render this as a fill, scale or halo without owning
+     * the gesture pipeline themselves.
+     */
+    intentProgress?: number;
+}
+/**
+ * Generic UI intent emitted by SDK components.
+ *
+ * Components do not know what `activate`/`drop` mean in Dreamboard terms —
+ * that mapping belongs to a runtime adapter. They only emit when a generic
+ * pointer/keyboard gesture completes.
+ *
+ * - `activate` is a single-target commit produced by a desktop click or a
+ *   keyboard activation in `direct-activate` mode.
+ * - `drop` is a card→target commit produced by mobile drag or keyboard drop
+ *   in `drag-to-target` mode. The opaque `targetId` is registered by a
+ *   `CardDropTargetView` and resolved against pointer geometry inside the
+ *   `CardDragSurface`.
+ * - `previewStart`/`previewEnd` bracket a long-press inspection that does
+ *   not commit.
+ */
+type CardIntent<CardId extends string = string, TargetId extends string = string> = {
+    type: "activate";
+    cardId: CardId;
+    source: "tap" | "keyboard";
+} | {
+    type: "previewStart";
+    cardId: CardId;
+} | {
+    type: "previewEnd";
+    cardId: CardId;
+} | {
+    type: "drop";
+    cardId: CardId;
+    targetId: TargetId;
+    source: "pointer" | "keyboard";
+};
+/**
+ * Generic UI intent emitted for a board target (space/edge/vertex).
+ */
+type TargetIntent<TargetId extends string = string> = {
+    type: "activate";
+    targetId: TargetId;
+    source: "tap" | "keyboard";
+} | {
+    type: "previewStart";
+    targetId: TargetId;
+} | {
+    type: "previewEnd";
+    targetId: TargetId;
+};
+/**
+ * Controlled visual state for a card drop target rendered through
+ * `CardDropTargetView`.
+ *
+ * `active` is `true` when any card is currently being dragged anywhere on
+ * the surface (eligible target should advertise itself). `over` is `true`
+ * only for the target that the lifted pointer would currently drop on.
+ */
+interface CardDropTargetVisualState extends InteractionVisualState {
+    active?: boolean;
+    over?: boolean;
+}
+/**
+ * Build the `data-*` attribute bag for an {@link InteractionVisualState} so
+ * that components apply a single consistent attribute surface.
+ *
+ * `undefined` values are emitted (rather than `false`) so that CSS
+ * `[data-…="true"]` selectors do not match by mistake.
+ */
+declare function visualStateDataAttributes(state: InteractionVisualState | undefined): Readonly<Record<string, string | undefined>>;
+/**
+ * Build the `data-*` attribute bag for a {@link CardDropTargetVisualState}.
+ */
+declare function dropTargetVisualStateDataAttributes(state: CardDropTargetVisualState | undefined): Readonly<Record<string, string | undefined>>;
+
 type BoardTargetKind = "edge" | "vertex" | "space" | "tile";
 interface InteractiveTargetState {
     kind?: BoardTargetKind;
@@ -931,4 +1046,4 @@ declare function createHexBoardView<const TBoard extends AnyHexBoardInput, const
     id: BoardSpaceIdOf<TBoard>;
 }>(board: TBoard, options: CreateHexBoardViewOptions<TSpaceView>): HexBoardView<TBoard, TSpaceView>;
 
-export { type Theme as $, type AnyHexBoardInput as A, type BoardEdgeIdOf as B, type ColorRamp as C, DefaultHexEdge as D, type EdgePosition as E, type FoundationColor as F, type GeneratedHexBoardInput as G, type HexBoardInput as H, type IntentColor as I, type InteractiveTargetLayer as J, type InteractiveTargetRenderState as K, type InteractiveTargetState as L, type Motion as M, type NormalizedHexBoard as N, type NormalizedHexEdgeOf as O, type NormalizedHexTileOf as P, type NormalizedHexVertexOf as Q, type NormalizedSquareBoard as R, type NormalizedSquareCellOf as S, type NormalizedSquareEdgeOf as T, type NormalizedSquarePieceOf as U, type NormalizedSquareVertexOf as V, type PlayerColor as W, type Radius as X, type SemanticColor as Y, type Space as Z, type SquareBoardInput as _, type AnySquareBoardInput as a, type ThemeMeta as a0, type ThemeOverride as a1, type Typography as a2, createHexBoardView as a3, hexUtils as a4, mergeTheme as a5, normalizeHexBoardInput as a6, normalizeSquareBoardInput as a7, type AuthoredHexBoardInput as b, type AuthoredSquareBoardInput as c, type BoardSpaceIdOf as d, type BoardVertexIdOf as e, type ComponentTokens as f, type DefaultHexEdgeProps as g, DefaultHexTile as h, type DefaultHexTileProps as i, DefaultHexVertex as j, type DefaultHexVertexProps as k, type Elevation as l, type GeneratedHexSpaceStateLike as m, type GeneratedSquareBoardInput as n, type GeneratedSquareSpaceStateLike as o, type GeneratedTiledEdgeStateLike as p, type GeneratedTiledVertexStateLike as q, type HexBoardView as r, type HexBoardViewTile as s, HexGrid as t, type HexGridBoardProps as u, type HexGridProps as v, type HexOrientation as w, type HexTileGeometry as x, type InteractiveHexEdge as y, type InteractiveHexVertex as z };
+export { type SemanticColor as $, type AnyHexBoardInput as A, type BoardEdgeIdOf as B, type CardDropTargetVisualState as C, DefaultHexEdge as D, type EdgePosition as E, type FoundationColor as F, type GeneratedHexBoardInput as G, type HexBoardInput as H, type IntentColor as I, type InteractionVisualState as J, type InteractiveHexEdge as K, type InteractiveHexVertex as L, type InteractiveTargetLayer as M, type InteractiveTargetRenderState as N, type InteractiveTargetState as O, type Motion as P, type NormalizedHexBoard as Q, type NormalizedHexEdgeOf as R, type NormalizedHexTileOf as S, type NormalizedHexVertexOf as T, type NormalizedSquareBoard as U, type NormalizedSquareCellOf as V, type NormalizedSquareEdgeOf as W, type NormalizedSquarePieceOf as X, type NormalizedSquareVertexOf as Y, type PlayerColor as Z, type Radius as _, type AnySquareBoardInput as a, type Space as a0, type SquareBoardInput as a1, type TargetIntent as a2, type Theme as a3, type ThemeMeta as a4, type ThemeOverride as a5, type Typography as a6, createHexBoardView as a7, dropTargetVisualStateDataAttributes as a8, hexUtils as a9, mergeTheme as aa, normalizeHexBoardInput as ab, normalizeSquareBoardInput as ac, visualStateDataAttributes as ad, type AuthoredHexBoardInput as b, type AuthoredSquareBoardInput as c, type BoardSpaceIdOf as d, type BoardVertexIdOf as e, type CardIntent as f, type ColorRamp as g, type ComponentTokens as h, type DefaultHexEdgeProps as i, DefaultHexTile as j, type DefaultHexTileProps as k, DefaultHexVertex as l, type DefaultHexVertexProps as m, type Elevation as n, type GeneratedHexSpaceStateLike as o, type GeneratedSquareBoardInput as p, type GeneratedSquareSpaceStateLike as q, type GeneratedTiledEdgeStateLike as r, type GeneratedTiledVertexStateLike as s, type HexBoardView as t, type HexBoardViewTile as u, HexGrid as v, type HexGridBoardProps as w, type HexGridProps as x, type HexOrientation as y, type HexTileGeometry as z };

package/dist/index-gjxQichK.d.ts

@@ -0,0 +1,192 @@
+import { ReactNode, ReactElement, ButtonHTMLAttributes } from 'react';
+import { l as BoardSpaceTargetProps, bh as ZoneListProps, b1 as UIContract } from './ui-contract-B4NjRlvC.js';
+import { J as InteractionVisualState } from './hex-board-view-BFlWDb9k.js';
+import { H as HandRole } from './ResourceCounter-BFxJknqp.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;
+}>;
+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: WorkspaceInteractionSlotComponent<{
+        children: ReactNode | ((card: Card, state: InteractionVisualState) => ReactNode);
+    }>;
+    readonly Cards: WorkspaceHandCardsComponent<Card>;
+    readonly Summary: WorkspaceHandSummaryComponent;
+    readonly Actions: WorkspaceHandSummaryComponent;
+    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;
+}
+
+interface DefineGameUIConfig<GameState, Surfaces> {
+    useSurfaces: () => Surfaces;
+    interactionRoutes?: (context: {
+        game: GameState;
+        surfaces: Surfaces;
+    }) => Record<string, {
+        collect: Record<string, unknown>;
+    }>;
+    phases: Record<string, (context: {
+        game: GameState;
+        surfaces: Surfaces;
+    }) => ReactNode>;
+    renderInteractions?: (context: {
+        game: GameState;
+        surfaces: Surfaces;
+    }) => ReactNode;
+    fallback?: ReactNode | ((phase: string | null) => ReactNode);
+    includeUnavailableInteractions?: boolean | null;
+}
+declare function createWorkspaceUIContract<WorkspaceUI, Contract extends UIContract, Resource extends string, Card, HexBoards extends Record<string, unknown>>(options: WorkspaceContractOptions<Contract, Resource, Card, HexBoards>): WorkspaceUI;
+
+export { type ClientParamSchemaMap as C, type DefineGameUIConfig as D, type WorkspaceBoardSurface as W, type WorkspaceBoardSurfaceDescriptor as a, type WorkspaceBoardTargetInputSlot as b, type WorkspaceCardCollectionSurface as c, type WorkspaceCardCollectionSurfaceDescriptor as d, type WorkspaceCardInputSlot as e, type WorkspaceFormInputSlot as f, type WorkspaceHandSurface as g, type WorkspaceHandSurfaceDescriptor as h, type WorkspaceInteractionFormDescriptor as i, type WorkspaceInteractionFormsDescriptor as j, type WorkspaceInteractionSlotComponent as k, type WorkspacePileSurface as l, type WorkspacePileSurfaceDescriptor as m, type WorkspacePilesSurfaceDescriptor as n, type WorkspaceSurfaceSpec as o, createWorkspaceUIContract as p };

package/dist/index.js

@@ -2,8 +2,8 @@ import {
   DREAMBOARD_SDK_PACKAGES,
   DREAMBOARD_SDK_PACKAGE_SET,
   DREAMBOARD_SDK_VERSION
-} from "./chunk-HWJS3VOJ.js";
-import "./chunk-ZAS2SENW.js";
+} from "./chunk-LKJLAGND.js";
+import "./chunk-SUMZ5OEH.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DREAMBOARD_SDK_PACKAGES,

package/dist/package-set.d.ts

@@ -1,6 +1,6 @@
-declare const DREAMBOARD_SDK_VERSION: "0.4.0-alpha.2";
+declare const DREAMBOARD_SDK_VERSION: "0.4.0-alpha.4";
 declare const DREAMBOARD_SDK_PACKAGES: {
-    readonly "@dreamboard-games/sdk": "0.4.0-alpha.2";
+    readonly "@dreamboard-games/sdk": "0.4.0-alpha.4";
 };
 type DreamboardSdkPackageName = keyof typeof DREAMBOARD_SDK_PACKAGES;
 type DreamboardSdkPackageSet = {

package/dist/package-set.js

@@ -2,8 +2,8 @@ import {
   DREAMBOARD_SDK_PACKAGES,
   DREAMBOARD_SDK_PACKAGE_SET,
   DREAMBOARD_SDK_VERSION
-} from "./chunk-HWJS3VOJ.js";
-import "./chunk-ZAS2SENW.js";
+} from "./chunk-LKJLAGND.js";
+import "./chunk-SUMZ5OEH.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DREAMBOARD_SDK_PACKAGES,

package/dist/runtime/primitives.d.ts

@@ -1,17 +1,17 @@
-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 { bd as ZoneCardRenderItem } from '../ui-contract-B4NjRlvC.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-B4NjRlvC.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 { f as CardIntent, J as InteractionVisualState, C as CardDropTargetVisualState } from '../hex-board-view-BFlWDb9k.js';
+import { a as HandLayoutKind, b as HandLayoutPolicy, H as HandInteractionPolicy } from '../HandView-x8MhbhFl.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-Kz9Q_zsv.js';
-import '../player-state-Cqpyeql0.js';
+import '../ThemeProvider-DRalAWzY.js';
 import '../types.js';
-import '../ThemeProvider-B1sIoBlX.js';
 import '../attributes-DbvyMbXw.js';
 import '../types-DJj5MJkl.js';
 import '../runtime-api-C6aWo9c0.js';
+import '../player-state-Cqpyeql0.js';
 
 interface InteractionDraftReadiness {
     values: Record<string, unknown>;
@@ -142,29 +142,26 @@ interface HandSurfaceViewProps<Card extends ZoneCardRenderItem> {
     /** 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.
+     * Render-safe slot for selection summary content. Fires during render with
+     * the latest projected summary so authors can compose count chrome 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;
+    summarySlot?: (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.
+     * consumers may safely call `setState` in response. Use `summarySlot` 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.
+     * Render-safe slot for the hand's commit/action chrome. Receives the same
+     * live summary as `summarySlot`. 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.
      */
-    renderActions?: (summary: HandSelectionSummary) => ReactNode;
+    actionsSlot?: (summary: HandSelectionSummary) => ReactNode;
     /** Layout policy forwarded to the SDK HandView. */
     layout?: HandLayoutKind | HandLayoutPolicy;
     /** Mobile interaction policy. Defaults to `direct-activate`. */
@@ -208,7 +205,7 @@ interface HandSurfaceViewProps<Card extends ZoneCardRenderItem> {
  * 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;
+declare function HandSurfaceView<Card extends ZoneCardRenderItem>({ zone, cards, renderCard, layout, mobileInteraction, dropTargets, renderDropTargets, cardSize, renderEmpty, ariaLabel, onIntentRouted, onSelectionSummary, summarySlot, actionsSlot, 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

package/dist/runtime/primitives.js

@@ -82,10 +82,10 @@ import {
   useZoneCards,
   useZonePileContext,
   useZonePrimitiveContext
-} from "../chunk-WOWFONLZ.js";
-import "../chunk-FWVV2X74.js";
+} from "../chunk-QOFFRHZR.js";
+import "../chunk-XZ667T4K.js";
 import "../chunk-T3ZKNUZ7.js";
-import "../chunk-45FI6XII.js";
+import "../chunk-E3X552YM.js";
 import {
   composeEventHandlers,
   renderPrimitive