@dreamboard-games/sdk 0.2.0 → 0.2.1-alpha.1

package/dist/runtime/primitives.d.ts

@@ -1,14 +1,15 @@
-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 { bf as ZoneCardRenderItem } from '../ui-contract-rzKBwOLC.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-rzKBwOLC.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 { a as InteractionDescriptor, P as PluginStateSnapshot } from '../runtime-api-CPLm_XDG.js';
+import '../hex-board-view-1iAyJRFn.js';
 import '../ui/types/player-state.js';
 import '../cards-Sl3b40Mv.js';
 import '../hex-color-MhOyuY-o.js';
-import '../ThemeProvider-fy0_QzgO.js';
+import '../ThemeProvider-BBMVT3KG.js';
+import '../attributes-BeRyboMS.js';
 import '../runtime-api-3dshj6kK.js';
 
 interface InteractionDraftReadiness {

package/dist/runtime/primitives.js

@@ -85,9 +85,10 @@ import {
   useZoneCards,
   useZonePileContext,
   useZonePrimitiveContext
-} from "../chunk-TDSWKVZ4.js";
-import "../chunk-KAELH4KC.js";
-import "../chunk-WYPQ3GG5.js";
+} from "../chunk-ZABVH7AO.js";
+import "../chunk-QLG6VEMW.js";
+import "../chunk-NKCRKGR2.js";
+import "../chunk-WG4JQL3S.js";
 import "../chunk-VDXOF4FW.js";
 import "../chunk-PZ5AY32C.js";
 export {

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

@@ -1,16 +1,17 @@
 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 { l as BoardSpaceTargetProps, bj as ZoneListProps, b3 as UIContract } from '../ui-contract-rzKBwOLC.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-rzKBwOLC.js';
 import { H as HandRole } from '../ResourceCounter-CTREyF73.js';
 export { b as ResourceCounterComponents } from '../ResourceCounter-CTREyF73.js';
-import '../runtime-api-DWxvTr-O.js';
+import '../runtime-api-CPLm_XDG.js';
 import { ReactNode, ReactElement, ButtonHTMLAttributes } from 'react';
 import 'react/jsx-runtime';
-import '../hex-board-view-D_07hO6O.js';
+import '../hex-board-view-1iAyJRFn.js';
 import '../ui/types/player-state.js';
 import '../cards-Sl3b40Mv.js';
 import '../hex-color-MhOyuY-o.js';
-import '../ThemeProvider-fy0_QzgO.js';
+import '../ThemeProvider-BBMVT3KG.js';
+import '../attributes-BeRyboMS.js';
 import '../runtime-api-3dshj6kK.js';
 import '../primitive-props-DpKs-GCr.js';
 

package/dist/runtime/workspace-contract.js

@@ -1,11 +1,12 @@
 import {
   createWorkspaceUIContract
-} from "../chunk-GKKBPPSW.js";
+} from "../chunk-MZNVHMJ5.js";
 import "../chunk-T3ZKNUZ7.js";
-import "../chunk-U5C6BONG.js";
-import "../chunk-TDSWKVZ4.js";
-import "../chunk-KAELH4KC.js";
-import "../chunk-WYPQ3GG5.js";
+import "../chunk-326PGVAA.js";
+import "../chunk-ZABVH7AO.js";
+import "../chunk-QLG6VEMW.js";
+import "../chunk-NKCRKGR2.js";
+import "../chunk-WG4JQL3S.js";
 import "../chunk-VDXOF4FW.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/{runtime-api-DWxvTr-O.d.ts → runtime-api-CPLm_XDG.d.ts}

@@ -303,6 +303,12 @@ interface InteractionDescriptorBase<Key extends string = string> {
     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. */

package/dist/runtime.d.ts

@@ -1,12 +1,13 @@
-import { b3 as UIContract$1, A as DreamboardUI$1, b1 as TypedGame$1 } from './ui-contract-iQfTtUSL.js';
-export { a as InteractionDescriptor } from './runtime-api-DWxvTr-O.js';
+import { b3 as UIContract$1, A as DreamboardUI$1, b1 as TypedGame$1 } from './ui-contract-rzKBwOLC.js';
+export { a as InteractionDescriptor } from './runtime-api-CPLm_XDG.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
-import './hex-board-view-D_07hO6O.js';
+import './hex-board-view-1iAyJRFn.js';
 import './ui/types/player-state.js';
 import './cards-Sl3b40Mv.js';
 import './hex-color-MhOyuY-o.js';
-import './ThemeProvider-fy0_QzgO.js';
+import './ThemeProvider-BBMVT3KG.js';
+import './attributes-BeRyboMS.js';
 import './runtime-api-3dshj6kK.js';
 
 interface PluginRuntimeProps {

package/dist/runtime.js

@@ -1,10 +1,11 @@
 import {
   PluginRuntime
-} from "./chunk-7YAHLYBR.js";
-import "./chunk-U5C6BONG.js";
-import "./chunk-TDSWKVZ4.js";
-import "./chunk-KAELH4KC.js";
-import "./chunk-WYPQ3GG5.js";
+} from "./chunk-XV6D3ET4.js";
+import "./chunk-326PGVAA.js";
+import "./chunk-ZABVH7AO.js";
+import "./chunk-QLG6VEMW.js";
+import "./chunk-NKCRKGR2.js";
+import "./chunk-WG4JQL3S.js";
 import "./chunk-VDXOF4FW.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/testing.d.ts

@@ -1,5 +1,5 @@
-import { a as ReducerSessionState, R as ReducerBundleContract } from './bundle-TIZcw8LB.js';
-import { P as PluginStateSnapshot$1, G as GameplaySnapshot$1 } from './runtime-api-DWxvTr-O.js';
+import { a as ReducerSessionState, R as ReducerBundleContract } from './bundle-CDd5FKeD.js';
+import { P as PluginStateSnapshot$1, G as GameplaySnapshot$1 } from './runtime-api-CPLm_XDG.js';
 import { R as RuntimeAPI, a as PluginSessionState, V as ValidationResult } from './runtime-api-3dshj6kK.js';
 import './hex-color-MhOyuY-o.js';
 

package/dist/ui/components.d.ts

@@ -1,7 +1,7 @@
-export { A as ActionButton, a as ActionButtonProps, b as ActionGroup, c as ActionGroupProps, d as ActionPanel, e as ActionPanelProps, C as CardDragSurface, g as CardDragSurfaceContextValue, h as CardDragSurfaceController, i as CardDragSurfaceProps, j as CardDropTargetView, k as CardDropTargetViewProps, l as CardFace, m as CardFaceProps, p as ChromeSuppressionProvider, q as CostDisplay, r as CostDisplayProps, D as DefaultChessPiece, s as DefaultChessPieceProps, t as DefaultEmptySlot, u as DefaultEmptySlotProps, v as DefaultGridCell, w as DefaultGridCellProps, x as DefaultGridPiece, y as DefaultGridPieceProps, z as DefaultNetworkEdge, E as DefaultNetworkEdgeProps, F as DefaultNetworkNode, G as DefaultNetworkNodeProps, H as DefaultNetworkPiece, I as DefaultNetworkPieceProps, J as DefaultSlotItem, K as DefaultSlotItemProps, L as DefaultSlotOccupant, M as DefaultSlotOccupantProps, N as DefaultTrackConnection, O as DefaultTrackConnectionProps, P as DefaultTrackJump, Q as DefaultTrackJumpProps, R as DefaultTrackPiece, S as DefaultTrackPieceProps, T as DefaultTrackSpace, U as DefaultTrackSpaceProps, V as DefaultZone, W as DefaultZonePiece, X as DefaultZonePieceProps, Y as DefaultZonePieces, Z as DefaultZonePiecesProps, _ as DefaultZoneProps, $ as Dialog, a0 as DialogClose, a1 as DialogContent, a2 as DialogDescription, a3 as DialogFooter, a4 as DialogHeader, a5 as DialogOverlay, a6 as DialogPortal, a7 as DialogTitle, a8 as DialogTrigger, a9 as DiceRoller, aa as DiceRollerProps, ab as DragPhase, ac as Drawer, ad as DrawerClose, ae as DrawerContent, af as DrawerDescription, ag as DrawerFooter, ah as DrawerHeader, ai as DrawerOverlay, aj as DrawerPortal, ak as DrawerTitle, al as DrawerTrigger, am as ErrorBoundary, an as ErrorBoundaryProps, ao as GameEndDisplay, ap as GameEndDisplayProps, aq as GameSkeleton, ar as GameSkeletonProps, as as Hand, at as HandDock, au as HandDockMode, av as HandDockPlacement, aw as HandDockPresentation, ax as HandDockProps, ay as HandDockToggleContext, aA as HandProps, aB as Input, aC as InteractiveSquareEdge, aD as InteractiveSquareVertex, aE as Label, aF as MoreActions, aG as MoreActionsProps, aH as NetworkEdge, aI as NetworkGraph, aJ as NetworkGraphProps, aK as NetworkNode, aL as NetworkPiece, aM as PhaseIndicator, aN as PhaseIndicatorProps, aO as PlayArea, aP as PlayAreaProps, aQ as PlayerScore, aR as PrimaryActionAttention, aS as PrimaryActionButton, aT as PrimaryActionButtonProps, aU as PrimaryButton, aV as PrimaryButtonProps, aW as ResourceDefinition, aX as Select, aY as SelectContent, aZ as SelectItem, a_ as SelectTrigger, a$ as SlotDefinition, b0 as SlotOccupant, b1 as SlotSystem, b2 as SlotSystemProps, b3 as SquareEdgePosition, b4 as SquareGrid, b5 as SquareGridBoardProps, b6 as SquareGridProps, b7 as SquareVertexPosition, b8 as StagingZone, b9 as StagingZoneProps, ba as ThemedButton, bb as ThemedButtonProps, bc as Toast, bd as ToastActions, be as ToastActionsProps, bf as ToastActionsValue, bg as ToastNotification, bh as ToastProvider, bi as ToastType, bj as TrackBoard, bk as TrackBoardProps, bl as TrackPiece, bm as TrackSpace, bp as ZoneDefinition, bq as ZoneHighlightType, br as ZoneMap, bs as ZoneMapProps, bt as ZonePiece, bu as ZoneShape, bB as toAlgebraic, bC as toNumeric, bD as useCardDragSurface, bE as useChromeSuppression } from '../components-D5ZRE2Hl.js';
+export { A as ActionButton, a as ActionButtonProps, b as ActionGroup, c as ActionGroupProps, d as ActionPanel, e as ActionPanelProps, C as CardDragSurface, g as CardDragSurfaceContextValue, h as CardDragSurfaceController, i as CardDragSurfaceProps, j as CardDropTargetView, k as CardDropTargetViewProps, l as CardFace, m as CardFaceProps, p as ChromeSuppressionProvider, q as CostDisplay, r as CostDisplayProps, D as DefaultChessPiece, s as DefaultChessPieceProps, t as DefaultEmptySlot, u as DefaultEmptySlotProps, v as DefaultGridCell, w as DefaultGridCellProps, x as DefaultGridPiece, y as DefaultGridPieceProps, z as DefaultNetworkEdge, E as DefaultNetworkEdgeProps, F as DefaultNetworkNode, G as DefaultNetworkNodeProps, H as DefaultNetworkPiece, I as DefaultNetworkPieceProps, J as DefaultSlotItem, K as DefaultSlotItemProps, L as DefaultSlotOccupant, M as DefaultSlotOccupantProps, N as DefaultTrackConnection, O as DefaultTrackConnectionProps, P as DefaultTrackJump, Q as DefaultTrackJumpProps, R as DefaultTrackPiece, S as DefaultTrackPieceProps, T as DefaultTrackSpace, U as DefaultTrackSpaceProps, V as DefaultZone, W as DefaultZonePiece, X as DefaultZonePieceProps, Y as DefaultZonePieces, Z as DefaultZonePiecesProps, _ as DefaultZoneProps, $ as Dialog, a0 as DialogClose, a1 as DialogContent, a2 as DialogDescription, a3 as DialogFooter, a4 as DialogHeader, a5 as DialogOverlay, a6 as DialogPortal, a7 as DialogTitle, a8 as DialogTrigger, a9 as DiceRoller, aa as DiceRollerProps, ab as DragPhase, ac as Drawer, ad as DrawerClose, ae as DrawerContent, af as DrawerDescription, ag as DrawerFooter, ah as DrawerHeader, ai as DrawerOverlay, aj as DrawerPortal, ak as DrawerTitle, al as DrawerTrigger, am as ErrorBoundary, an as ErrorBoundaryProps, ao as GameEndDisplay, ap as GameEndDisplayProps, aq as GameSkeleton, ar as GameSkeletonProps, as as Hand, at as HandDock, au as HandDockMode, av as HandDockPlacement, aw as HandDockPresentation, ax as HandDockProps, ay as HandDockToggleContext, aA as HandProps, aB as Input, aC as InteractiveSquareEdge, aD as InteractiveSquareVertex, aE as Label, aF as MoreActions, aG as MoreActionsProps, aH as NetworkEdge, aI as NetworkGraph, aJ as NetworkGraphProps, aK as NetworkNode, aL as NetworkPiece, aM as PhaseIndicator, aN as PhaseIndicatorProps, aO as PlayArea, aP as PlayAreaProps, aQ as PlayerScore, aR as PrimaryActionAttention, aS as PrimaryActionButton, aT as PrimaryActionButtonProps, aU as PrimaryButton, aV as PrimaryButtonProps, aW as ResourceDefinition, aX as Select, aY as SelectContent, aZ as SelectItem, a_ as SelectTrigger, a$ as SlotDefinition, b0 as SlotOccupant, b1 as SlotSystem, b2 as SlotSystemProps, b3 as SquareEdgePosition, b4 as SquareGrid, b5 as SquareGridBoardProps, b6 as SquareGridProps, b7 as SquareVertexPosition, b8 as StagingZone, b9 as StagingZoneProps, ba as ThemedButton, bb as ThemedButtonProps, bc as Toast, bd as ToastActions, be as ToastActionsProps, bf as ToastActionsValue, bg as ToastNotification, bh as ToastProvider, bi as ToastType, bj as TrackBoard, bk as TrackBoardProps, bl as TrackPiece, bm as TrackSpace, bp as ZoneDefinition, bq as ZoneHighlightType, br as ZoneMap, bs as ZoneMapProps, bt as ZonePiece, bu as ZoneShape, bB as toAlgebraic, bC as toNumeric, bD as useCardDragSurface, bE as useChromeSuppression } from '../components-BoiVSYqx.js';
 export { H as HandInteractionPolicy, b as HandLayoutKind, c as HandLayoutPolicy, d as HandView, e as HandViewProps } from '../HandView-ncJIVLhN.js';
 export { B as BoundResourceCounterRootProps, H as HandRole, M as MobileHandRegistration, a as MobileHandTrayProvider, R as ResourceCounter, b as ResourceCounterComponents, c as ResourceCounterCount, d as ResourceCounterIcon, e as ResourceCounterItem, f as ResourceCounterItemState, g as ResourceCounterLabel, h as ResourceCounterPartProps, i as ResourceCounterProps, j as ResourceCounterRoot, k as ResourceCounterRootProps, l as ResourceDisplayConfig, m as ResourceIconProps, n as createResourceCounter, u as useMobileHandTrayActive, o as useRegisterMobileHand } from '../ResourceCounter-CTREyF73.js';
-export { D as DefaultHexEdge, g as DefaultHexEdgeProps, h as DefaultHexTile, i as DefaultHexTileProps, j as DefaultHexVertex, k as DefaultHexVertexProps, E as EdgePosition, r as HexBoardView, s as HexBoardViewTile, t as HexGrid, u as HexGridBoardProps, v as HexGridProps, w as HexOrientation, x as HexTileGeometry, y as InteractiveHexEdge, z as InteractiveHexVertex, J as InteractiveTargetLayer, K as InteractiveTargetRenderState, a2 as createHexBoardView, a3 as hexUtils } from '../hex-board-view-D_07hO6O.js';
+export { D as DefaultHexEdge, g as DefaultHexEdgeProps, h as DefaultHexTile, i as DefaultHexTileProps, j as DefaultHexVertex, k as DefaultHexVertexProps, E as EdgePosition, r as HexBoardView, s as HexBoardViewTile, t as HexGrid, u as HexGridBoardProps, v as HexGridProps, w as HexOrientation, x as HexTileGeometry, y as InteractiveHexEdge, z as InteractiveHexVertex, J as InteractiveTargetLayer, K as InteractiveTargetRenderState, a2 as createHexBoardView, a3 as hexUtils } from '../hex-board-view-1iAyJRFn.js';
 export { HexEdgeState, HexTileState, HexVertexState, SquareCellState, SquareEdgeState, SquarePieceState, SquareVertexState } from './types/player-state.js';
 export { C as CardCollection, V as ViewCard } from '../cards-Sl3b40Mv.js';
 export { V as ViewSlotOccupant } from '../slots-1GPGihk8.js';

package/dist/ui/components.js

@@ -92,7 +92,7 @@ import {
   useChromeSuppression,
   useMobileHandTrayActive,
   useRegisterMobileHand
-} from "../chunk-WYPQ3GG5.js";
+} from "../chunk-WG4JQL3S.js";
 import "../chunk-VDXOF4FW.js";
 import "../chunk-PZ5AY32C.js";
 export {

package/dist/{ui-contract-iQfTtUSL.d.ts → ui-contract-rzKBwOLC.d.ts}

@@ -1,10 +1,11 @@
 import * as react from 'react';
 import { CSSProperties, ReactNode, AriaAttributes, HTMLAttributes, JSX, ReactElement, ButtonHTMLAttributes, InputHTMLAttributes } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { _ as Theme, a0 as ThemeOverride, A as AnyHexBoardInput, d as BoardSpaceIdOf, u as HexGridBoardProps, r as HexBoardView } from './hex-board-view-D_07hO6O.js';
-import { a as ThemePresetId } from './ThemeProvider-fy0_QzgO.js';
-import { a as InteractionDescriptor, Z as ZoneHandlesSnapshot, I as InputDomain, b as InteractionInputDescriptor } from './runtime-api-DWxvTr-O.js';
+import { _ as Theme, a0 as ThemeOverride, A as AnyHexBoardInput, d as BoardSpaceIdOf, u as HexGridBoardProps, r as HexBoardView } from './hex-board-view-1iAyJRFn.js';
+import { a as ThemePresetId } from './ThemeProvider-BBMVT3KG.js';
+import { a as InteractionDescriptor, Z as ZoneHandlesSnapshot, I as InputDomain, b as InteractionInputDescriptor } from './runtime-api-CPLm_XDG.js';
 import { V as ViewCard } from './cards-Sl3b40Mv.js';
+import { j as BrowserInteractionAttributeMap } from './attributes-BeRyboMS.js';
 import { a as PluginSessionState, P as PlayerId } from './runtime-api-3dshj6kK.js';
 import { Player } from './ui/types/player-state.js';
 import { H as HexColor } from './hex-color-MhOyuY-o.js';
@@ -209,6 +210,7 @@ interface InteractiveTargetState {
     conflict: boolean;
     conflictInteractionKeys?: readonly string[];
     unavailableReason?: string;
+    browserAttributes?: BrowserInteractionAttributeMap;
     select?: () => unknown | Promise<unknown>;
 }
 interface InteractiveTargetLayer {

package/dist/ui.d.ts

@@ -1,8 +1,8 @@
-import { bm as TrackSpace, bl as TrackPiece } from './components-D5ZRE2Hl.js';
-export { A as ActionButton, a as ActionButtonProps, b as ActionGroup, c as ActionGroupProps, d as ActionPanel, e as ActionPanelProps, B as ButtonSize, f as ButtonVariant, C as CardDragSurface, g as CardDragSurfaceContextValue, h as CardDragSurfaceController, i as CardDragSurfaceProps, j as CardDropTargetView, k as CardDropTargetViewProps, l as CardFace, m as CardFaceProps, n as CardPositionProps, o as CardSize, p as ChromeSuppressionProvider, q as CostDisplay, r as CostDisplayProps, D as DefaultChessPiece, s as DefaultChessPieceProps, t as DefaultEmptySlot, u as DefaultEmptySlotProps, v as DefaultGridCell, w as DefaultGridCellProps, x as DefaultGridPiece, y as DefaultGridPieceProps, z as DefaultNetworkEdge, E as DefaultNetworkEdgeProps, F as DefaultNetworkNode, G as DefaultNetworkNodeProps, H as DefaultNetworkPiece, I as DefaultNetworkPieceProps, J as DefaultSlotItem, K as DefaultSlotItemProps, L as DefaultSlotOccupant, M as DefaultSlotOccupantProps, N as DefaultTrackConnection, O as DefaultTrackConnectionProps, P as DefaultTrackJump, Q as DefaultTrackJumpProps, R as DefaultTrackPiece, S as DefaultTrackPieceProps, T as DefaultTrackSpace, U as DefaultTrackSpaceProps, V as DefaultZone, W as DefaultZonePiece, X as DefaultZonePieceProps, Y as DefaultZonePieces, Z as DefaultZonePiecesProps, _ as DefaultZoneProps, $ as Dialog, a0 as DialogClose, a1 as DialogContent, a2 as DialogDescription, a3 as DialogFooter, a4 as DialogHeader, a5 as DialogOverlay, a6 as DialogPortal, a7 as DialogTitle, a8 as DialogTrigger, a9 as DiceRoller, aa as DiceRollerProps, ab as DragPhase, ac as Drawer, ad as DrawerClose, ae as DrawerContent, af as DrawerDescription, ag as DrawerFooter, ah as DrawerHeader, ai as DrawerOverlay, aj as DrawerPortal, ak as DrawerTitle, al as DrawerTrigger, am as ErrorBoundary, an as ErrorBoundaryProps, ao as GameEndDisplay, ap as GameEndDisplayProps, aq as GameSkeleton, ar as GameSkeletonProps, as as Hand, at as HandDock, au as HandDockMode, av as HandDockPlacement, aw as HandDockPresentation, ax as HandDockProps, ay as HandDockToggleContext, az as HandLayout, aA as HandProps, aB as Input, aC as InteractiveSquareEdge, aD as InteractiveSquareVertex, aE as Label, aF as MoreActions, aG as MoreActionsProps, aH as NetworkEdge, aI as NetworkGraph, aJ as NetworkGraphProps, aK as NetworkNode, aL as NetworkPiece, aM as PhaseIndicator, aN as PhaseIndicatorProps, aO as PlayArea, aP as PlayAreaProps, aQ as PlayerScore, aR as PrimaryActionAttention, aS as PrimaryActionButton, aT as PrimaryActionButtonProps, aU as PrimaryButton, aV as PrimaryButtonProps, aW as ResourceDefinition, aX as Select, aY as SelectContent, aZ as SelectItem, a_ as SelectTrigger, a$ as SlotDefinition, b0 as SlotOccupant, b1 as SlotSystem, b2 as SlotSystemProps, b3 as SquareEdgePosition, b4 as SquareGrid, b5 as SquareGridBoardProps, b6 as SquareGridProps, b7 as SquareVertexPosition, b8 as StagingZone, b9 as StagingZoneProps, ba as ThemedButton, bb as ThemedButtonProps, bc as Toast, bd as ToastActions, be as ToastActionsProps, bf as ToastActionsValue, bg as ToastNotification, bh as ToastProvider, bi as ToastType, bj as TrackBoard, bk as TrackBoardProps, bn as UseHandLayoutOptions, bo as UseHandLayoutReturn, bp as ZoneDefinition, bq as ZoneHighlightType, br as ZoneMap, bs as ZoneMapProps, bt as ZonePiece, bu as ZoneShape, bv as buttonStyle, bw as chipStyle, bx as intentForVariant, by as motionDuration, bz as playerColor, bA as surfaceStyle, bB as toAlgebraic, bC as toNumeric, bD as useCardDragSurface, bE as useChromeSuppression, bF as useHandLayout } from './components-D5ZRE2Hl.js';
-import { _ as Theme } from './hex-board-view-D_07hO6O.js';
-export { A as AnyHexBoardInput, a as AnySquareBoardInput, b as AuthoredHexBoardInput, c as AuthoredSquareBoardInput, B as BoardEdgeIdOf, d as BoardSpaceIdOf, e as BoardVertexIdOf, C as ColorRamp, f as ComponentTokens, D as DefaultHexEdge, g as DefaultHexEdgeProps, h as DefaultHexTile, i as DefaultHexTileProps, j as DefaultHexVertex, k as DefaultHexVertexProps, E as EdgePosition, l as Elevation, F as FoundationColor, G as GeneratedHexBoardInput, m as GeneratedHexSpaceStateLike, n as GeneratedSquareBoardInput, o as GeneratedSquareSpaceStateLike, p as GeneratedTiledEdgeStateLike, q as GeneratedTiledVertexStateLike, H as HexBoardInput, r as HexBoardView, s as HexBoardViewTile, t as HexGrid, u as HexGridBoardProps, v as HexGridProps, w as HexOrientation, x as HexTileGeometry, I as IntentColor, y as InteractiveHexEdge, z as InteractiveHexVertex, J as InteractiveTargetLayer, K as InteractiveTargetRenderState, M as Motion, N as NormalizedHexBoard, L as NormalizedHexEdgeOf, O as NormalizedHexTileOf, P as NormalizedHexVertexOf, Q as NormalizedSquareBoard, R as NormalizedSquareCellOf, S as NormalizedSquareEdgeOf, T as NormalizedSquarePieceOf, U as NormalizedSquareVertexOf, V as PlayerColor, W as Radius, X as SemanticColor, Y as Space, Z as SquareBoardInput, $ as ThemeMeta, a0 as ThemeOverride, a1 as Typography, a2 as createHexBoardView, a3 as hexUtils, a4 as mergeTheme, a5 as normalizeHexBoardInput, a6 as normalizeSquareBoardInput } from './hex-board-view-D_07hO6O.js';
-export { T as ThemeContextValue, a as ThemePresetId, b as ThemeProvider, c as ThemeProviderProps, g as getThemePreset, r as resolveTheme, u as useTheme, d as useThemeCssVars } from './ThemeProvider-fy0_QzgO.js';
+import { bm as TrackSpace, bl as TrackPiece } from './components-BoiVSYqx.js';
+export { A as ActionButton, a as ActionButtonProps, b as ActionGroup, c as ActionGroupProps, d as ActionPanel, e as ActionPanelProps, B as ButtonSize, f as ButtonVariant, C as CardDragSurface, g as CardDragSurfaceContextValue, h as CardDragSurfaceController, i as CardDragSurfaceProps, j as CardDropTargetView, k as CardDropTargetViewProps, l as CardFace, m as CardFaceProps, n as CardPositionProps, o as CardSize, p as ChromeSuppressionProvider, q as CostDisplay, r as CostDisplayProps, D as DefaultChessPiece, s as DefaultChessPieceProps, t as DefaultEmptySlot, u as DefaultEmptySlotProps, v as DefaultGridCell, w as DefaultGridCellProps, x as DefaultGridPiece, y as DefaultGridPieceProps, z as DefaultNetworkEdge, E as DefaultNetworkEdgeProps, F as DefaultNetworkNode, G as DefaultNetworkNodeProps, H as DefaultNetworkPiece, I as DefaultNetworkPieceProps, J as DefaultSlotItem, K as DefaultSlotItemProps, L as DefaultSlotOccupant, M as DefaultSlotOccupantProps, N as DefaultTrackConnection, O as DefaultTrackConnectionProps, P as DefaultTrackJump, Q as DefaultTrackJumpProps, R as DefaultTrackPiece, S as DefaultTrackPieceProps, T as DefaultTrackSpace, U as DefaultTrackSpaceProps, V as DefaultZone, W as DefaultZonePiece, X as DefaultZonePieceProps, Y as DefaultZonePieces, Z as DefaultZonePiecesProps, _ as DefaultZoneProps, $ as Dialog, a0 as DialogClose, a1 as DialogContent, a2 as DialogDescription, a3 as DialogFooter, a4 as DialogHeader, a5 as DialogOverlay, a6 as DialogPortal, a7 as DialogTitle, a8 as DialogTrigger, a9 as DiceRoller, aa as DiceRollerProps, ab as DragPhase, ac as Drawer, ad as DrawerClose, ae as DrawerContent, af as DrawerDescription, ag as DrawerFooter, ah as DrawerHeader, ai as DrawerOverlay, aj as DrawerPortal, ak as DrawerTitle, al as DrawerTrigger, am as ErrorBoundary, an as ErrorBoundaryProps, ao as GameEndDisplay, ap as GameEndDisplayProps, aq as GameSkeleton, ar as GameSkeletonProps, as as Hand, at as HandDock, au as HandDockMode, av as HandDockPlacement, aw as HandDockPresentation, ax as HandDockProps, ay as HandDockToggleContext, az as HandLayout, aA as HandProps, aB as Input, aC as InteractiveSquareEdge, aD as InteractiveSquareVertex, aE as Label, aF as MoreActions, aG as MoreActionsProps, aH as NetworkEdge, aI as NetworkGraph, aJ as NetworkGraphProps, aK as NetworkNode, aL as NetworkPiece, aM as PhaseIndicator, aN as PhaseIndicatorProps, aO as PlayArea, aP as PlayAreaProps, aQ as PlayerScore, aR as PrimaryActionAttention, aS as PrimaryActionButton, aT as PrimaryActionButtonProps, aU as PrimaryButton, aV as PrimaryButtonProps, aW as ResourceDefinition, aX as Select, aY as SelectContent, aZ as SelectItem, a_ as SelectTrigger, a$ as SlotDefinition, b0 as SlotOccupant, b1 as SlotSystem, b2 as SlotSystemProps, b3 as SquareEdgePosition, b4 as SquareGrid, b5 as SquareGridBoardProps, b6 as SquareGridProps, b7 as SquareVertexPosition, b8 as StagingZone, b9 as StagingZoneProps, ba as ThemedButton, bb as ThemedButtonProps, bc as Toast, bd as ToastActions, be as ToastActionsProps, bf as ToastActionsValue, bg as ToastNotification, bh as ToastProvider, bi as ToastType, bj as TrackBoard, bk as TrackBoardProps, bn as UseHandLayoutOptions, bo as UseHandLayoutReturn, bp as ZoneDefinition, bq as ZoneHighlightType, br as ZoneMap, bs as ZoneMapProps, bt as ZonePiece, bu as ZoneShape, bv as buttonStyle, bw as chipStyle, bx as intentForVariant, by as motionDuration, bz as playerColor, bA as surfaceStyle, bB as toAlgebraic, bC as toNumeric, bD as useCardDragSurface, bE as useChromeSuppression, bF as useHandLayout } from './components-BoiVSYqx.js';
+import { _ as Theme } from './hex-board-view-1iAyJRFn.js';
+export { A as AnyHexBoardInput, a as AnySquareBoardInput, b as AuthoredHexBoardInput, c as AuthoredSquareBoardInput, B as BoardEdgeIdOf, d as BoardSpaceIdOf, e as BoardVertexIdOf, C as ColorRamp, f as ComponentTokens, D as DefaultHexEdge, g as DefaultHexEdgeProps, h as DefaultHexTile, i as DefaultHexTileProps, j as DefaultHexVertex, k as DefaultHexVertexProps, E as EdgePosition, l as Elevation, F as FoundationColor, G as GeneratedHexBoardInput, m as GeneratedHexSpaceStateLike, n as GeneratedSquareBoardInput, o as GeneratedSquareSpaceStateLike, p as GeneratedTiledEdgeStateLike, q as GeneratedTiledVertexStateLike, H as HexBoardInput, r as HexBoardView, s as HexBoardViewTile, t as HexGrid, u as HexGridBoardProps, v as HexGridProps, w as HexOrientation, x as HexTileGeometry, I as IntentColor, y as InteractiveHexEdge, z as InteractiveHexVertex, J as InteractiveTargetLayer, K as InteractiveTargetRenderState, M as Motion, N as NormalizedHexBoard, L as NormalizedHexEdgeOf, O as NormalizedHexTileOf, P as NormalizedHexVertexOf, Q as NormalizedSquareBoard, R as NormalizedSquareCellOf, S as NormalizedSquareEdgeOf, T as NormalizedSquarePieceOf, U as NormalizedSquareVertexOf, V as PlayerColor, W as Radius, X as SemanticColor, Y as Space, Z as SquareBoardInput, $ as ThemeMeta, a0 as ThemeOverride, a1 as Typography, a2 as createHexBoardView, a3 as hexUtils, a4 as mergeTheme, a5 as normalizeHexBoardInput, a6 as normalizeSquareBoardInput } from './hex-board-view-1iAyJRFn.js';
+export { T as ThemeContextValue, a as ThemePresetId, b as ThemeProvider, c as ThemeProviderProps, g as getThemePreset, r as resolveTheme, u as useTheme, d as useThemeCssVars } from './ThemeProvider-BBMVT3KG.js';
 import { CSSProperties } from 'react';
 export { C as CardDropTargetVisualState, a as CardIntent, H as HandInteractionPolicy, b as HandLayoutKind, c as HandLayoutPolicy, d as HandView, e as HandViewProps, I as InteractionVisualState, T as TargetIntent, f as dropTargetVisualStateDataAttributes, v as visualStateDataAttributes } from './HandView-ncJIVLhN.js';
 export { B as BoundResourceCounterRootProps, H as HandRole, M as MobileHandRegistration, a as MobileHandTrayProvider, R as ResourceCounter, b as ResourceCounterComponents, c as ResourceCounterCount, d as ResourceCounterIcon, e as ResourceCounterItem, f as ResourceCounterItemState, g as ResourceCounterLabel, h as ResourceCounterPartProps, i as ResourceCounterProps, j as ResourceCounterRoot, k as ResourceCounterRootProps, l as ResourceDisplayConfig, m as ResourceIconProps, n as createResourceCounter, u as useMobileHandTrayActive, o as useRegisterMobileHand } from './ResourceCounter-CTREyF73.js';

package/dist/ui.js

@@ -5,7 +5,7 @@ import {
   parseHexColor,
   toTrackBoardData,
   useBoardTheme
-} from "./chunk-KAELH4KC.js";
+} from "./chunk-NKCRKGR2.js";
 import {
   ActionButton,
   ActionGroup,
@@ -123,7 +123,7 @@ import {
   useTheme,
   useThemeCssVars,
   visualStateDataAttributes
-} from "./chunk-WYPQ3GG5.js";
+} from "./chunk-WG4JQL3S.js";
 import "./chunk-VDXOF4FW.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamboard-games/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1-alpha.1",
   "description": "Dreamboard SDK package set metadata and public facade",
   "type": "module",
   "main": "./dist/index.js",
@@ -123,6 +123,12 @@
       "import": "./dist/testing.js",
       "default": "./dist/testing.js"
     },
+    "./browser-interaction": {
+      "bun": "./src/browser-interaction.ts",
+      "types": "./dist/browser-interaction.d.ts",
+      "import": "./dist/browser-interaction.js",
+      "default": "./dist/browser-interaction.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -140,12 +146,6 @@
     "!.turbo/**",
     "!tsconfig.tsbuildinfo"
   ],
-  "scripts": {
-    "build": "tsup && mkdir -p dist/ui && cp src/ui/plugin-styles.css dist/ui/plugin-styles.css",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint 'src/**/*.ts'",
-    "test": "bun test"
-  },
   "dependencies": {
     "@radix-ui/react-dialog": "^1.1.14",
     "@radix-ui/react-accordion": "^1.2.12",
@@ -195,5 +195,11 @@
     "sdk",
     "package-set"
   ],
-  "license": "SEE LICENSE IN LICENSE.md"
-}
+  "license": "SEE LICENSE IN LICENSE.md",
+  "scripts": {
+    "build": "tsup && mkdir -p dist/ui && cp src/ui/plugin-styles.css dist/ui/plugin-styles.css",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint 'src/**/*.ts'",
+    "test": "bun test"
+  }
+}

package/src/browser-interaction/attributes.ts

@@ -0,0 +1,211 @@
+import {
+  BROWSER_INTERACTION_ATTRIBUTES,
+  DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION,
+  GAMEPLAY_BROWSER_INTERACTION_SURFACE,
+} from "./constants.js";
+import { encodeCanonicalCandidateValue } from "./canonical.js";
+import {
+  encodeBrowserInteractionEffect,
+  encodeBrowserInteractionEffectPattern,
+} from "./effects.js";
+import type {
+  BrowserInteractionActuatorKind,
+  BrowserInteractionCandidateState,
+  BrowserInteractionEffectPattern,
+  BrowserInteractionIntent,
+  BrowserInteractionPreparationTarget,
+  BrowserInteractionReadiness,
+  BrowserInteractionSurfaceEffect,
+  GameplayBrowserInteractionIntent,
+  GameplaySemanticEffect,
+  GameplaySemanticEffectPattern,
+} from "./types.js";
+
+export type BrowserInteractionAttributeMap = Record<string, string | boolean>;
+
+export interface BrowserInteractionRootAttributesInput {
+  readonly surface: string;
+  readonly scopeId: string;
+  readonly interactionKey: string;
+  readonly interactionId: string;
+  readonly descriptorDigest?: string;
+  readonly draftDigest?: string;
+  readonly readiness: BrowserInteractionReadiness;
+}
+
+export interface BrowserInteractionActuatorAttributesInput {
+  readonly surface: string;
+  readonly scopeId: string;
+  readonly interactionKey: string;
+  readonly interactionId: string;
+  readonly descriptorDigest?: string;
+  readonly draftDigest?: string;
+  readonly intent: BrowserInteractionIntent;
+  readonly inputKey?: string;
+  readonly candidateValue?: unknown;
+  readonly candidateState?: BrowserInteractionCandidateState;
+  readonly enabled?: boolean;
+  readonly actuatorKind: BrowserInteractionActuatorKind;
+  readonly actuatorId?: string;
+  readonly semanticEffects?: readonly BrowserInteractionSurfaceEffect[];
+  readonly acceptedEffectPatterns?: readonly BrowserInteractionEffectPattern[];
+  readonly preparationPatterns?: readonly BrowserInteractionEffectPattern[];
+  readonly prepares?: BrowserInteractionPreparationTarget;
+}
+
+function baseGameplayAttributes(
+  input: Pick<
+    BrowserInteractionRootAttributesInput,
+    "surface" | "scopeId" | "interactionKey" | "interactionId"
+  >,
+): BrowserInteractionAttributeMap {
+  return {
+    [BROWSER_INTERACTION_ATTRIBUTES.protocol]:
+      DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION,
+    [BROWSER_INTERACTION_ATTRIBUTES.surface]: input.surface,
+    [BROWSER_INTERACTION_ATTRIBUTES.scope]: input.scopeId,
+    [BROWSER_INTERACTION_ATTRIBUTES.interactionKey]: input.interactionKey,
+    [BROWSER_INTERACTION_ATTRIBUTES.interactionId]: input.interactionId,
+  };
+}
+
+export function createBrowserInteractionRootAttributes(
+  input: BrowserInteractionRootAttributesInput,
+): BrowserInteractionAttributeMap {
+  return {
+    ...baseGameplayAttributes(input),
+    [BROWSER_INTERACTION_ATTRIBUTES.role]: "interaction",
+    [BROWSER_INTERACTION_ATTRIBUTES.descriptorDigest]:
+      input.descriptorDigest ?? "",
+    [BROWSER_INTERACTION_ATTRIBUTES.draftDigest]: input.draftDigest ?? "",
+    [BROWSER_INTERACTION_ATTRIBUTES.readiness]: input.readiness,
+  };
+}
+
+export function createBrowserInteractionActuatorAttributes(
+  input: BrowserInteractionActuatorAttributesInput,
+): BrowserInteractionAttributeMap {
+  const attrs: BrowserInteractionAttributeMap = {
+    ...baseGameplayAttributes(input),
+    [BROWSER_INTERACTION_ATTRIBUTES.role]: "actuator",
+    [BROWSER_INTERACTION_ATTRIBUTES.intent]: input.intent,
+    [BROWSER_INTERACTION_ATTRIBUTES.actuatorKind]: input.actuatorKind,
+    [BROWSER_INTERACTION_ATTRIBUTES.enabled]:
+      input.enabled === false ? "false" : "true",
+  };
+  if (input.descriptorDigest) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.descriptorDigest] =
+      input.descriptorDigest;
+  }
+  if (input.draftDigest) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.draftDigest] = input.draftDigest;
+  }
+  if (input.actuatorId) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.actuatorId] = input.actuatorId;
+  }
+  if (input.inputKey) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.inputKey] = input.inputKey;
+  }
+  if ("candidateValue" in input) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.candidateValue] =
+      encodeCanonicalCandidateValue(input.candidateValue);
+  }
+  if (input.candidateState) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.candidateState] = input.candidateState;
+  }
+  if (input.semanticEffects && input.semanticEffects.length > 0) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.semanticEffects] = JSON.stringify(
+      input.semanticEffects.map(encodeBrowserInteractionEffect),
+    );
+  }
+  if (input.acceptedEffectPatterns && input.acceptedEffectPatterns.length > 0) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.acceptedEffectPatterns] =
+      JSON.stringify(
+        input.acceptedEffectPatterns.map(encodeBrowserInteractionEffectPattern),
+      );
+  }
+  if (input.preparationPatterns && input.preparationPatterns.length > 0) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.preparationPatterns] = JSON.stringify(
+      input.preparationPatterns.map(encodeBrowserInteractionEffectPattern),
+    );
+  }
+  if (input.prepares) {
+    attrs[BROWSER_INTERACTION_ATTRIBUTES.preparesIntent] =
+      input.prepares.intent;
+    if (input.prepares.inputKey) {
+      attrs[BROWSER_INTERACTION_ATTRIBUTES.preparesInputKey] =
+        input.prepares.inputKey;
+    }
+    if (input.prepares.candidateValueKey) {
+      attrs[BROWSER_INTERACTION_ATTRIBUTES.preparesCandidateValue] =
+        input.prepares.candidateValueKey;
+    } else if ("candidateValue" in input.prepares) {
+      attrs[BROWSER_INTERACTION_ATTRIBUTES.preparesCandidateValue] =
+        encodeCanonicalCandidateValue(input.prepares.candidateValue);
+    }
+    if (input.prepares.actuatorKind) {
+      attrs[BROWSER_INTERACTION_ATTRIBUTES.preparesActuatorKind] =
+        input.prepares.actuatorKind;
+    }
+  }
+  return attrs;
+}
+
+export type GameplayInteractionRootAttributesInput = Omit<
+  BrowserInteractionRootAttributesInput,
+  "surface"
+>;
+
+export type GameplayActuatorAttributesInput = Omit<
+  BrowserInteractionActuatorAttributesInput,
+  | "surface"
+  | "intent"
+  | "semanticEffects"
+  | "acceptedEffectPatterns"
+  | "preparationPatterns"
+> & {
+  readonly intent: GameplayBrowserInteractionIntent;
+  readonly semanticEffects?: readonly GameplaySemanticEffect[];
+  readonly acceptedEffectPatterns?: readonly GameplaySemanticEffectPattern[];
+  readonly preparationPatterns?: readonly GameplaySemanticEffectPattern[];
+};
+
+export function createGameplayInteractionRootAttributes(
+  input: GameplayInteractionRootAttributesInput,
+): BrowserInteractionAttributeMap {
+  return createBrowserInteractionRootAttributes({
+    ...input,
+    surface: GAMEPLAY_BROWSER_INTERACTION_SURFACE,
+  });
+}
+
+export function createGameplayActuatorAttributes(
+  input: GameplayActuatorAttributesInput,
+): BrowserInteractionAttributeMap {
+  return createBrowserInteractionActuatorAttributes({
+    ...input,
+    surface: GAMEPLAY_BROWSER_INTERACTION_SURFACE,
+  });
+}
+
+export function createBrowserInteractionActuatorKey(input: {
+  readonly surface: string;
+  readonly scopeId: string;
+  readonly interactionKey: string;
+  readonly intent: BrowserInteractionIntent;
+  readonly inputKey?: string;
+  readonly candidateValueKey?: string;
+  readonly actuatorKind: BrowserInteractionActuatorKind;
+}): string {
+  return [
+    input.surface,
+    input.scopeId,
+    input.interactionKey,
+    input.intent,
+    input.inputKey ?? "",
+    input.candidateValueKey ?? "",
+    input.actuatorKind,
+  ]
+    .map((part) => encodeURIComponent(part))
+    .join("|");
+}

package/src/browser-interaction/canonical.ts

@@ -0,0 +1,77 @@
+export type CanonicalBrowserInteractionValue =
+  | null
+  | boolean
+  | number
+  | string
+  | readonly CanonicalBrowserInteractionValue[]
+  | { readonly [key: string]: CanonicalBrowserInteractionValue };
+
+function assertCanonicalValue(
+  value: unknown,
+): asserts value is CanonicalBrowserInteractionValue {
+  if (value === null) return;
+  switch (typeof value) {
+    case "boolean":
+    case "string":
+      return;
+    case "number":
+      if (Number.isFinite(value)) return;
+      break;
+    case "object":
+      if (Array.isArray(value)) {
+        value.forEach(assertCanonicalValue);
+        return;
+      }
+      if (Object.getPrototypeOf(value) !== Object.prototype) break;
+      for (const [key, item] of Object.entries(value)) {
+        if (item === undefined) {
+          throw new Error(
+            `Browser interaction candidate '${key}' cannot be undefined.`,
+          );
+        }
+        assertCanonicalValue(item);
+      }
+      return;
+  }
+  throw new Error(
+    `Browser interaction candidates must be JSON-serializable primitives, arrays or plain objects. Received ${typeof value}.`,
+  );
+}
+
+function canonicalizeValue(
+  value: CanonicalBrowserInteractionValue,
+): CanonicalBrowserInteractionValue {
+  if (Array.isArray(value)) {
+    return value.map(canonicalizeValue);
+  }
+  if (value && typeof value === "object") {
+    const objectValue = value as {
+      readonly [key: string]: CanonicalBrowserInteractionValue;
+    };
+    return Object.fromEntries(
+      Object.keys(objectValue)
+        .sort()
+        .map((key) => [key, canonicalizeValue(objectValue[key])]),
+    );
+  }
+  return value;
+}
+
+export function encodeCanonicalCandidateValue(value: unknown): string {
+  assertCanonicalValue(value);
+  return JSON.stringify(canonicalizeValue(value));
+}
+
+export function decodeCanonicalCandidateValue(
+  encoded: string,
+): CanonicalBrowserInteractionValue {
+  const parsed = JSON.parse(encoded) as unknown;
+  assertCanonicalValue(parsed);
+  return canonicalizeValue(parsed);
+}
+
+export function compareStableJson(a: unknown, b: unknown): number {
+  const encodedA = encodeCanonicalCandidateValue(a);
+  const encodedB = encodeCanonicalCandidateValue(b);
+  return encodedA.localeCompare(encodedB);
+}