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

package/REFERENCE.md

@@ -47,7 +47,7 @@ _No JSDoc summary is available yet._
 
 ```ts
 const DREAMBOARD_SDK_PACKAGES: {
-  readonly "@dreamboard-games/sdk": "0.4.0-alpha.1";
+  readonly "@dreamboard-games/sdk": "0.4.0-alpha.2";
 };
 ```
 
@@ -56,7 +56,7 @@ _No JSDoc summary is available yet._
 ### DREAMBOARD_SDK_VERSION
 
 ```ts
-const DREAMBOARD_SDK_VERSION = "0.4.0-alpha.1";
+const DREAMBOARD_SDK_VERSION: "0.4.0-alpha.2";
 ```
 
 _No JSDoc summary is available yet._
@@ -95,7 +95,7 @@ _No JSDoc summary is available yet._
 
 ```ts
 const DREAMBOARD_SDK_PACKAGES: {
-  readonly "@dreamboard-games/sdk": "0.4.0-alpha.1";
+  readonly "@dreamboard-games/sdk": "0.4.0-alpha.2";
 };
 ```
 
@@ -104,7 +104,7 @@ _No JSDoc summary is available yet._
 ### DREAMBOARD_SDK_VERSION
 
 ```ts
-const DREAMBOARD_SDK_VERSION = "0.4.0-alpha.1";
+const DREAMBOARD_SDK_VERSION: "0.4.0-alpha.2";
 ```
 
 _No JSDoc summary is available yet._
@@ -1270,24 +1270,7 @@ Supported player-count metadata for the game
 ### PresetCardSetDefinition
 
 ```ts
-type PresetCardSetDefinition = {
-  /**
-   * Unique local identifier for the authored card set
-   */
-  id: string;
-  /**
-   * Built-in preset card-set selector
-   */
-  presetId: string;
-  /**
-   * Display name of the card set
-   */
-  name: string;
-  /**
-   * Type of card set source
-   */
-  type: "preset";
-};
+type PresetCardSetDefinition = ...;
 ```
 
 _No JSDoc summary is available yet._
@@ -8372,6 +8355,7 @@ function CardDropTargetView({
   style,
   order,
   role,
+  browserInteractionAttributes,
 }: CardDropTargetViewProps): react_jsx_runtime.JSX.Element;
 ```
 
@@ -10618,6 +10602,149 @@ function normalizeSquareBoardInput<TBoard extends AnySquareBoardInput>(
 
 _No JSDoc summary is available yet._
 
+### Panel
+
+```ts
+const Panel: {
+  Root: typeof PanelRoot;
+  Header: typeof PanelHeader;
+  Title: typeof PanelTitle;
+  Description: typeof PanelDescription;
+  Body: typeof PanelBody;
+  Actions: typeof PanelActions;
+};
+```
+
+_No JSDoc summary is available yet._
+
+### PanelActions
+
+```ts
+function PanelActions({
+  className,
+  style,
+  children,
+  ...props
+}: PanelPartProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelBody
+
+```ts
+function PanelBody({
+  className,
+  style,
+  children,
+  ...props
+}: PanelPartProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelDescription
+
+```ts
+function PanelDescription({
+  className,
+  style,
+  children,
+  ...props
+}: PanelDescriptionProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelDescriptionProps
+
+```ts
+interface PanelDescriptionProps extends HTMLAttributes<HTMLParagraphElement> {
+  children?: ReactNode;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PanelHeader
+
+```ts
+function PanelHeader({
+  className,
+  style,
+  children,
+  ...props
+}: PanelPartProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelPartProps
+
+```ts
+interface PanelPartProps extends HTMLAttributes<HTMLDivElement> {
+  children?: ReactNode;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PanelRoot
+
+```ts
+function PanelRoot({
+  tone,
+  className,
+  children,
+  style,
+  ...props
+}: PanelRootProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelRootProps
+
+```ts
+interface PanelRootProps extends HTMLAttributes<HTMLDivElement> {
+  tone?: PanelTone;
+  children: ReactNode;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PanelTitle
+
+```ts
+function PanelTitle({
+  className,
+  style,
+  children,
+  ...props
+}: PanelTitleProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelTitleProps
+
+```ts
+interface PanelTitleProps extends HTMLAttributes<HTMLHeadingElement> {
+  children?: ReactNode;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PanelTone
+
+```ts
+type PanelTone = "card" | "hud" | "inset";
+```
+
+_No JSDoc summary is available yet._
+
 ### PanZoomTransform
 
 ```ts
@@ -11862,6 +11989,14 @@ function useMobileHandTrayActive(): boolean;
 
 Whether the mobile hand tray is currently presenting hands — i.e. the viewport is below the mobile breakpoint and at least one primary/auxiliary hand has registered. Authors can use this to drop redundant inline hand chrome (labels, framing) that the tray already provides, instead of guessing the breakpoint with a CSS media query. Returns `false` outside `<UI.Root>`.
 
+### useOverlayInsets
+
+```ts
+function useOverlayInsets(): { bottom: number };
+```
+
+_No JSDoc summary is available yet._
+
 ### UsePanZoomOptions
 
 ```ts
@@ -11878,6 +12013,14 @@ interface UsePanZoomReturn { ... }
 
 _No JSDoc summary is available yet._
 
+### useRegisterBottomOverlayInset
+
+```ts
+function useRegisterBottomOverlayInset(id: string, height: number): void;
+```
+
+_No JSDoc summary is available yet._
+
 ### useRegisterMobileHand
 
 ```ts
@@ -12240,6 +12383,7 @@ function CardDropTargetView({
   style,
   order,
   role,
+  browserInteractionAttributes,
 }: CardDropTargetViewProps): react_jsx_runtime.JSX.Element;
 ```
 
@@ -13851,6 +13995,149 @@ interface NetworkPiece {
 
 _No JSDoc summary is available yet._
 
+### Panel
+
+```ts
+const Panel: {
+  Root: typeof PanelRoot;
+  Header: typeof PanelHeader;
+  Title: typeof PanelTitle;
+  Description: typeof PanelDescription;
+  Body: typeof PanelBody;
+  Actions: typeof PanelActions;
+};
+```
+
+_No JSDoc summary is available yet._
+
+### PanelActions
+
+```ts
+function PanelActions({
+  className,
+  style,
+  children,
+  ...props
+}: PanelPartProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelBody
+
+```ts
+function PanelBody({
+  className,
+  style,
+  children,
+  ...props
+}: PanelPartProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelDescription
+
+```ts
+function PanelDescription({
+  className,
+  style,
+  children,
+  ...props
+}: PanelDescriptionProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelDescriptionProps
+
+```ts
+interface PanelDescriptionProps extends HTMLAttributes<HTMLParagraphElement> {
+  children?: ReactNode;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PanelHeader
+
+```ts
+function PanelHeader({
+  className,
+  style,
+  children,
+  ...props
+}: PanelPartProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelPartProps
+
+```ts
+interface PanelPartProps extends HTMLAttributes<HTMLDivElement> {
+  children?: ReactNode;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PanelRoot
+
+```ts
+function PanelRoot({
+  tone,
+  className,
+  children,
+  style,
+  ...props
+}: PanelRootProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelRootProps
+
+```ts
+interface PanelRootProps extends HTMLAttributes<HTMLDivElement> {
+  tone?: PanelTone;
+  children: ReactNode;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PanelTitle
+
+```ts
+function PanelTitle({
+  className,
+  style,
+  children,
+  ...props
+}: PanelTitleProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PanelTitleProps
+
+```ts
+interface PanelTitleProps extends HTMLAttributes<HTMLHeadingElement> {
+  children?: ReactNode;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PanelTone
+
+```ts
+type PanelTone = "card" | "hud" | "inset";
+```
+
+_No JSDoc summary is available yet._
+
 ### PhaseIndicator
 
 ```ts
@@ -14631,6 +14918,22 @@ function useMobileHandTrayActive(): boolean;
 
 Whether the mobile hand tray is currently presenting hands — i.e. the viewport is below the mobile breakpoint and at least one primary/auxiliary hand has registered. Authors can use this to drop redundant inline hand chrome (labels, framing) that the tray already provides, instead of guessing the breakpoint with a CSS media query. Returns `false` outside `<UI.Root>`.
 
+### useOverlayInsets
+
+```ts
+function useOverlayInsets(): { bottom: number };
+```
+
+_No JSDoc summary is available yet._
+
+### useRegisterBottomOverlayInset
+
+```ts
+function useRegisterBottomOverlayInset(id: string, height: number): void;
+```
+
+_No JSDoc summary is available yet._
+
 ### useRegisterMobileHand
 
 ```ts
@@ -15324,23 +15627,43 @@ type ClientParamSchemaMap = Readonly<
 
 _No JSDoc summary is available yet._
 
-### createWorkspaceUIContract
+### createPluginRuntimeClient
 
 ```ts
-function createWorkspaceUIContract<
-  WorkspaceUI,
-  Contract extends UIContract,
-  Resource extends string,
-  Card,
-  HexBoards extends Record<string, unknown>,
->(
-  options: WorkspaceContractOptions<Contract, Resource, Card, HexBoards>,
-): WorkspaceUI;
+function createPluginRuntimeClient(
+  options: PluginRuntimeClientOptions,
+): PluginRuntimeClient;
 ```
 
 _No JSDoc summary is available yet._
 
-### DreamboardUI
+### createPostMessagePluginTransport
+
+```ts
+function createPostMessagePluginTransport(
+  options?: PostMessagePluginTransportOptions,
+): PluginTransport;
+```
+
+_No JSDoc summary is available yet._
+
+### createWorkspaceUIContract
+
+```ts
+function createWorkspaceUIContract<
+  WorkspaceUI,
+  Contract extends UIContract,
+  Resource extends string,
+  Card,
+  HexBoards extends Record<string, unknown>,
+>(
+  options: WorkspaceContractOptions<Contract, Resource, Card, HexBoards>,
+): WorkspaceUI;
+```
+
+_No JSDoc summary is available yet._
+
+### DreamboardUI
 
 ```ts
 type DreamboardUI<Contract extends UIContract = RegisteredUI> =
@@ -15365,7 +15688,6 @@ _No JSDoc summary is available yet._
 interface GameMeState<PlayerIdValue extends string = PlayerId> {
   playerId: PlayerIdValue | null;
   player: GamePlayer<PlayerIdValue> | null;
-  controllablePlayerIds: readonly PlayerIdValue[];
   canAct: boolean;
 }
 ```
@@ -15448,6 +15770,49 @@ function PluginRuntime({
 
 PluginRuntime provides the RuntimeContext for plugin components.
 
+### PluginRuntimeBoundary
+
+```ts
+function PluginRuntimeBoundary({
+  runtime,
+  children,
+}: {
+  runtime: PluginRuntimeClient;
+  children: react__default.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### PluginRuntimeClient
+
+```ts
+interface PluginRuntimeClient {
+  getSession(): v | null;
+  subscribeSession(listener: () => void): () => void;
+  getFrame(): o | null;
+  subscribeFrame(listener: () => void): () => void;
+  validateInteraction(interactionId: string, params: unknown): Promise<G>;
+  submitInteraction(interactionId: string, params: unknown): Promise<void>;
+  disconnect(): void;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PluginRuntimeClientOptions
+
+```ts
+interface PluginRuntimeClientOptions {
+  transport: PluginTransport;
+  idFactory?: RuntimeIdFactory;
+  clock?: RuntimeClock;
+  requestTimeoutMs?: number;
+}
+```
+
+_No JSDoc summary is available yet._
+
 ### PluginRuntimeProps
 
 ```ts
@@ -15456,6 +15821,29 @@ interface PluginRuntimeProps { ... }
 
 _No JSDoc summary is available yet._
 
+### PluginTransport
+
+```ts
+interface PluginTransport {
+  start(onMessage: (message: H) => void): () => void;
+  send(message: x): void;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### PostMessagePluginTransportOptions
+
+```ts
+interface PostMessagePluginTransportOptions {
+  readonly targetWindow?: Window;
+  readonly parentWindow?: Window;
+  readonly onInvalidMessage?: (reason: string, value: unknown) => void;
+}
+```
+
+_No JSDoc summary is available yet._
+
 ### RegisteredUI
 
 ```ts
@@ -15478,6 +15866,26 @@ interface ResourceCounterComponents<Resource extends string = ResourceId> {
 
 _No JSDoc summary is available yet._
 
+### RuntimeClock
+
+```ts
+interface RuntimeClock {
+  now(): number;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### RuntimeIdFactory
+
+```ts
+interface RuntimeIdFactory {
+  nextId(prefix: string): string;
+}
+```
+
+_No JSDoc summary is available yet._
+
 ### TypedGame
 
 ```ts
@@ -15581,14 +15989,7 @@ _No JSDoc summary is available yet._
 ### WorkspaceHandSurface
 
 ```ts
-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 WorkspaceHandSurface { ... }
 ```
 
 _No JSDoc summary is available yet._
@@ -16046,7 +16447,9 @@ Translate a raw SDK `CardIntent` into the author-facing `AuthoredCardIntent` sha
 ### descriptorsHaveDestinationInput
 
 ```ts
-function descriptorsHaveDestinationInput(state: PluginStateSnapshot): boolean;
+function descriptorsHaveDestinationInput(
+  availableInteractions: readonly InteractionDescriptor[],
+): boolean;
 ```
 
 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.
@@ -16149,6 +16552,7 @@ Convenience helper for builders of generated hand surfaces. Encodes a typed targ
 const Game: {
   Root: typeof GameRoot;
   Chrome: typeof GameChrome;
+  Viewport: typeof GameViewport;
 };
 ```
 
@@ -16222,7 +16626,6 @@ _No JSDoc summary is available yet._
 interface GameMeState<PlayerIdValue extends string = PlayerId> {
   playerId: PlayerIdValue | null;
   player: GamePlayer<PlayerIdValue> | null;
-  controllablePlayerIds: readonly PlayerIdValue[];
   canAct: boolean;
 }
 ```
@@ -16263,7 +16666,6 @@ type GamePlayerEntry<PlayerIdValue extends string = PlayerId> =
     index: number;
     isActive: boolean;
     isCurrentPlayer: boolean;
-    isControllable: boolean;
   };
 ```
 
@@ -16357,6 +16759,28 @@ interface GameTurnState<
 
 _No JSDoc summary is available yet._
 
+### GameViewport
+
+```ts
+function GameViewport({
+  children,
+  style,
+  ...props
+}: GameViewportProps): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
+### GameViewportProps
+
+```ts
+interface GameViewportProps extends HTMLAttributes<HTMLDivElement> {
+  children?: ReactNode;
+}
+```
+
+_No JSDoc summary is available yet._
+
 ### HandSurfaceView
 
 ```ts
@@ -16980,8 +17404,6 @@ interface PlayerRosterEntry {
   index: number;
   isActive: boolean;
   isCurrentPlayer: boolean;
-  isControllable: boolean;
-  canSwitchToPlayer: boolean;
   score?: number;
   scoreLabel?: string;
   badges: readonly PlayerRosterBadge[];
@@ -17081,34 +17503,6 @@ function PlayerRosterScore({
 
 _No JSDoc summary is available yet._
 
-### PlayerRosterSwitchButton
-
-```ts
-function PlayerRosterSwitchButton({
-  player,
-  disabled,
-  onClick,
-  ...props
-}: PlayerRosterSwitchButtonProps): ReactElement<
-  unknown,
-  string | react.JSXElementConstructor<any>
->;
-```
-
-_No JSDoc summary is available yet._
-
-### PlayerRosterSwitchButtonProps
-
-```ts
-type PlayerRosterSwitchButtonProps = Omit<PrimitiveCommonProps, "children"> &
-  ButtonHTMLAttributes<HTMLButtonElement> & {
-    player: PlayerRosterEntry;
-    children?: ReactNode;
-  };
-```
-
-_No JSDoc summary is available yet._
-
 ### PrimitiveCommonProps
 
 ```ts
@@ -18015,7 +18409,6 @@ _No JSDoc summary is available yet._
 interface GameMeState<PlayerIdValue extends string = PlayerId> {
   playerId: PlayerIdValue | null;
   player: GamePlayer<PlayerIdValue> | null;
-  controllablePlayerIds: readonly PlayerIdValue[];
   canAct: boolean;
 }
 ```
@@ -18206,14 +18599,7 @@ _No JSDoc summary is available yet._
 ### WorkspaceHandSurface
 
 ```ts
-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 WorkspaceHandSurface { ... }
 ```
 
 _No JSDoc summary is available yet._
@@ -18355,26 +18741,53 @@ _No JSDoc summary is available yet._
 ### PluginSessionState
 
 ```ts
-interface PluginSessionState { ... }
+interface PluginSessionState {
+  /** Session initialization status */
+  status: "loading" | "ready";
+  /** Current session ID (null if not initialized) */
+  sessionId: string | null;
+  /** The player perspective represented by the current gameplay frame */
+  controllingPlayerId: PlayerId | null;
+}
 ```
 
 Plugin session state
 
-### PluginStateSnapshot
+### RuntimeAPI
+
+```ts
+interface RuntimeAPI { ... }
+```
+
+RuntimeAPI provides the interface between plugin code and the game runtime. This API is exposed to plugin iframes for subscribing to game events and submitting actions.
+
+### RuntimeDiagnosticEvent
 
 ```ts
-interface PluginStateSnapshot { ... }
+type RuntimeDiagnosticEvent =
+  | {
+      type: "runtimeLog";
+      level: "log" | "warn" | "error";
+      message: string;
+      details?: readonly unknown[];
+    }
+  | {
+      type: "internalError";
+      code: string;
+      message: string;
+      stack?: string;
+    };
 ```
 
-The complete state snapshot sent to the plugin via state-sync. This is the single source of truth for all reducer-native plugin state.
+_No JSDoc summary is available yet._
 
-### RuntimeAPI
+### RuntimeDiagnosticHandler
 
 ```ts
-interface RuntimeAPI { ... }
+type RuntimeDiagnosticHandler = (event: RuntimeDiagnosticEvent) => void;
 ```
 
-RuntimeAPI provides the interface between plugin code and the game runtime. This API is exposed to plugin iframes for subscribing to game events and submitting actions.
+_No JSDoc summary is available yet._
 
 ### SubmissionError
 
@@ -18589,6 +19002,181 @@ const WORKSPACE_CODEGEN_OWNERSHIP: ScaffoldingOwnership;
 
 _No JSDoc summary is available yet._
 
+## @dreamboard-games/sdk/authoring
+
+### AuthoringManifestConformanceCaseV1
+
+```ts
+type AuthoringManifestConformanceCaseV1 = {
+  id: string;
+  manifest: JsonValue;
+  expected:
+    | {
+        valid: true;
+        transportValid: true;
+        materializedSha256: string;
+      }
+    | {
+        valid: false;
+        transportValid: boolean;
+        diagnosticCodes: readonly string[];
+      };
+};
+```
+
+_No JSDoc summary is available yet._
+
+### AuthoringValidationResultV1
+
+```ts
+type AuthoringValidationResultV1 = {
+  valid: boolean;
+  errors: readonly string[];
+  warnings: readonly string[];
+};
+```
+
+_No JSDoc summary is available yet._
+
+### diagnosticCodesForValidationErrors
+
+```ts
+function diagnosticCodesForValidationErrors(
+  errors: readonly string[],
+): readonly string[];
+```
+
+_No JSDoc summary is available yet._
+
+### GENERATED_WORKSPACE_PATH_PATTERNS
+
+```ts
+const GENERATED_WORKSPACE_PATH_PATTERNS: {
+  prefix: string;
+  suffix: string;
+}[];
+```
+
+_No JSDoc summary is available yet._
+
+### GENERATED_WORKSPACE_PATHS
+
+```ts
+const GENERATED_WORKSPACE_PATHS: readonly [
+  ...string[],
+  "test/generated/base-state.json",
+];
+```
+
+_No JSDoc summary is available yet._
+
+### GeneratedArtifactV1
+
+```ts
+type GeneratedArtifactV1 = {
+  path: string;
+  ownership: "authoritative" | "seed" | "derived-test";
+  content: string;
+  contentSha256: string;
+};
+```
+
+_No JSDoc summary is available yet._
+
+### GeneratedAuthoringMetadataV1
+
+```ts
+type GeneratedAuthoringMetadataV1 = {
+  sdkVersion: string;
+  codegenVersion: string;
+  manifestSchemaVersion: number;
+  generatedArtifactSchemaVersion: number;
+};
+```
+
+_No JSDoc summary is available yet._
+
+### GeneratedPathPatternV1
+
+```ts
+type GeneratedPathPatternV1 = {
+  prefix: string;
+  suffix: string;
+};
+```
+
+_No JSDoc summary is available yet._
+
+### generateTestArtifacts
+
+```ts
+function generateTestArtifacts(
+  input: GenerateTestArtifactsInputV1,
+): readonly GeneratedArtifactV1[];
+```
+
+_No JSDoc summary is available yet._
+
+### GenerateTestArtifactsInputV1
+
+```ts
+type GenerateTestArtifactsInputV1 = {
+  manifest: GameTopologyManifest;
+};
+```
+
+_No JSDoc summary is available yet._
+
+### generateWorkspaceArtifacts
+
+```ts
+function generateWorkspaceArtifacts(
+  manifest: unknown,
+): readonly GeneratedArtifactV1[];
+```
+
+_No JSDoc summary is available yet._
+
+### MANIFEST_CONFORMANCE_CASES
+
+```ts
+const MANIFEST_CONFORMANCE_CASES: readonly AuthoringManifestConformanceCaseV1[];
+```
+
+_No JSDoc summary is available yet._
+
+### materializeManifest
+
+```ts
+function materializeManifest(manifest: unknown): JsonValue;
+```
+
+_No JSDoc summary is available yet._
+
+### projectAuthoringAdapter
+
+```ts
+const projectAuthoringAdapter: ProjectAuthoringAdapterV1;
+```
+
+_No JSDoc summary is available yet._
+
+### ProjectAuthoringAdapterV1
+
+```ts
+type ProjectAuthoringAdapterV1 = ...;
+```
+
+_No JSDoc summary is available yet._
+
+### validateManifest
+
+```ts
+function validateManifest(manifest: unknown): AuthoringValidationResultV1;
+```
+
+_No JSDoc summary is available yet._
+
 ## @dreamboard-games/sdk/reducer-contract
 
 ### materializeManifestTable
@@ -18750,10 +19338,42 @@ function canonicalUIFixtureJson(value: unknown): string;
 
 _No JSDoc summary is available yet._
 
-### compileUIScenarioFixture
+### compareUIParityObservations
 
 ```ts
-function compileUIScenarioFixture(
+function compareUIParityObservations(
+  expected: UIParityObservationV1,
+  actual: UIParityObservationV1,
+): UIParityComparisonResult;
+```
+
+_No JSDoc summary is available yet._
+
+### compilePluginProtocolTape
+
+```ts
+function compilePluginProtocolTape(
+  options: CompilePluginProtocolTapeOptions,
+): PluginProtocolTape;
+```
+
+_No JSDoc summary is available yet._
+
+### CompilePluginProtocolTapeOptions
+
+```ts
+interface CompilePluginProtocolTapeOptions {
+  readonly trace: ReducerScenarioTrace;
+  readonly session: v;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### compileUIScenarioFixture
+
+```ts
+function compileUIScenarioFixture(
   options: CompileUIScenarioFixtureOptions,
 ): UIScenarioFixture;
 ```
@@ -18768,6 +19388,14 @@ interface CompileUIScenarioFixtureOptions { ... }
 
 _No JSDoc summary is available yet._
 
+### createDeterministicIdFactory
+
+```ts
+function createDeterministicIdFactory(seed: string): DeterministicIdFactory;
+```
+
+_No JSDoc summary is available yet._
+
 ### CreatedTestRuntime
 
 ```ts
@@ -18784,6 +19412,57 @@ function createExpectApi(options?: CreateExpectApiOptions): ExpectFn;
 
 _No JSDoc summary is available yet._
 
+### createFixtureHostHarness
+
+```ts
+function createFixtureHostHarness(
+  options: CreateFixtureHostHarnessOptions,
+): FixtureHostHarness;
+```
+
+_No JSDoc summary is available yet._
+
+### CreateFixtureHostHarnessOptions
+
+```ts
+interface CreateFixtureHostHarnessOptions {
+  readonly tape: u;
+  readonly strict?: boolean;
+  readonly latencyMs?: number;
+  readonly channelId?: string;
+  readonly onEvent?: (event: FixtureHostEvent) => void;
+  readonly nowMs?: () => number;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### createReducerScenarioRunner
+
+```ts
+function createReducerScenarioRunner(
+  options: CreateReducerScenarioRunnerOptions,
+): ReducerScenarioRunner;
+```
+
+_No JSDoc summary is available yet._
+
+### CreateReducerScenarioRunnerOptions
+
+```ts
+interface CreateReducerScenarioRunnerOptions {
+  readonly scenarioId: string;
+  readonly gameId: string;
+  readonly initialState: wire.ReducerSessionState;
+  readonly bundle: ReducerScenarioBundle;
+  readonly viewer: ReducerScenarioViewer;
+  readonly playerIds: readonly string[];
+  readonly initialGameVersion?: number;
+}
+```
+
+_No JSDoc summary is available yet._
+
 ### createTestRuntime
 
 ```ts
@@ -18814,6 +19493,29 @@ type CreateTestRuntimeOptions = {
 
 _No JSDoc summary is available yet._
 
+### createUIParityObservationFromFixture
+
+```ts
+function createUIParityObservationFromFixture({
+  fixture,
+  sdkCandidateDigest,
+  environment,
+  fixtureDigest,
+  screenshotsByStepId,
+  diagnostics,
+}: CreateUIParityObservationFromFixtureOptions): UIParityObservationV1;
+```
+
+_No JSDoc summary is available yet._
+
+### defaultFixtureEnvironmentInit
+
+```ts
+const defaultFixtureEnvironmentInit: FixtureEnvironmentInit;
+```
+
+_No JSDoc summary is available yet._
+
 ### defineBase
 
 ```ts
@@ -18838,6 +19540,22 @@ function defineScenario<
 
 _No JSDoc summary is available yet._
 
+### DeterministicIdFactory
+
+```ts
+type DeterministicIdFactory = () => string;
+```
+
+_No JSDoc summary is available yet._
+
+### digestPluginProtocolTape
+
+```ts
+function digestPluginProtocolTape(tape: PluginProtocolTape): string;
+```
+
+_No JSDoc summary is available yet._
+
 ### digestUIFixtureJson
 
 ```ts
@@ -18854,6 +19572,23 @@ function digestUIFixtureRequest(request: UIReplayRequest): string;
 
 _No JSDoc summary is available yet._
 
+### digestUIFixtureTransportRequest
+
+```ts
+function digestUIFixtureTransportRequest(request: {
+  readonly operation: "validate" | "submit";
+  readonly basis?: {
+    readonly gameVersion: number;
+    readonly actionSetVersion: string;
+    readonly perspectivePlayerId: string | null;
+  };
+  readonly interactionId?: string;
+  readonly payload?: unknown;
+}): string;
+```
+
+_No JSDoc summary is available yet._
+
 ### digestUIScenarioFixture
 
 ```ts
@@ -18878,6 +19613,87 @@ type ExpectMatchers = ...;
 
 _No JSDoc summary is available yet._
 
+### FixtureEnvironmentInit
+
+```ts
+interface FixtureEnvironmentInit {
+  readonly clockIso: string;
+  readonly randomSeed: string;
+  readonly locale: "en-US";
+  readonly timezone: "UTC";
+  readonly reducedMotion: true;
+  readonly network: "blocked";
+}
+```
+
+_No JSDoc summary is available yet._
+
+### fixtureEnvironmentInitFor
+
+```ts
+function fixtureEnvironmentInitFor(options: {
+  readonly clockIso: string;
+  readonly randomSeed: string;
+}): FixtureEnvironmentInit;
+```
+
+_No JSDoc summary is available yet._
+
+### FixtureHostEvent
+
+```ts
+interface FixtureHostEvent {
+  readonly sequence: number;
+  readonly atMs: number;
+  readonly kind:
+    | "frame-sent"
+    | "validate-received"
+    | "submit-received"
+    | "ack-received"
+    | "ready-received"
+    | "diagnostic";
+  readonly requestDigest?: string;
+  readonly frameId?: string;
+  readonly projectionDigest?: string;
+  readonly result?: "accepted" | "rejected";
+}
+```
+
+_No JSDoc summary is available yet._
+
+### FixtureHostHarness
+
+```ts
+interface FixtureHostHarness {
+  readonly transport: PluginTransport;
+  readonly tape: u;
+  reset(): void;
+  flush(): Promise<void>;
+  advanceHost(): Promise<void>;
+  getCurrentFrameId(): string;
+  getEvents(): readonly FixtureHostEvent[];
+  assertConsumed(): void;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### FixturePluginRuntime
+
+```ts
+function FixturePluginRuntime({
+  harness,
+  runtime,
+  children,
+}: {
+  harness: FixtureHostHarness;
+  runtime?: PluginRuntimeClient;
+  children: react__default.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+```
+
+_No JSDoc summary is available yet._
+
 ### InteractionAvailabilityLike
 
 ```ts
@@ -18944,6 +19760,14 @@ function isStaleContractArtifactError(
 
 _No JSDoc summary is available yet._
 
+### parseUIParityObservationV1
+
+```ts
+function parseUIParityObservationV1(value: unknown): UIParityObservationV1;
+```
+
+_No JSDoc summary is available yet._
+
 ### parseUIScenarioFixture
 
 ```ts
@@ -18962,6 +19786,26 @@ function parseUIScenarioFixtureBundleIndex(
 
 _No JSDoc summary is available yet._
 
+### PluginProtocolTape
+
+```ts
+type PluginProtocolTape = u;
+```
+
+_No JSDoc summary is available yet._
+
+### pluginProtocolTapeSchema
+
+```ts
+const pluginProtocolTapeSchema: z.ZodType<
+  u,
+  unknown,
+  z.core.$ZodTypeInternals<u, unknown>
+>;
+```
+
+_No JSDoc summary is available yet._
+
 ### PortableSemanticReplayStep
 
 ```ts
@@ -18980,6 +19824,107 @@ declare const portableSemanticReplayStepSchema: ...;
 
 _No JSDoc summary is available yet._
 
+### ReducerScenarioBundle
+
+```ts
+type ReducerScenarioBundle = Pick<
+  ReducerBundleContract,
+  "projectSeatsDynamic" | "validateInput" | "dispatch" | "projectStatic"
+>;
+```
+
+_No JSDoc summary is available yet._
+
+### ReducerScenarioDiagnostic
+
+```ts
+interface ReducerScenarioDiagnostic {
+  readonly code: string;
+  readonly message: string;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### ReducerScenarioExchange
+
+```ts
+type ReducerScenarioExchange = ...;
+```
+
+_No JSDoc summary is available yet._
+
+### ReducerScenarioFrame
+
+```ts
+interface ReducerScenarioFrame {
+  readonly id: string;
+  readonly reducerState: wire.ReducerSessionState;
+  readonly dynamicProjection: wire.SeatProjectionBundle;
+  readonly staticProjection?: wire.BoardStaticProjection | null;
+  readonly gameVersion: number;
+  readonly actionSetVersion: string;
+  readonly projectionDigest: string;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### ReducerScenarioOperation
+
+```ts
+type ReducerScenarioOperation =
+  | {
+      readonly id: string;
+      readonly operation: "validate";
+      readonly input: wire.GameInput;
+    }
+  | {
+      readonly id: string;
+      readonly operation: "submit";
+      readonly input: wire.GameInput;
+    };
+```
+
+_No JSDoc summary is available yet._
+
+### ReducerScenarioRunner
+
+```ts
+interface ReducerScenarioRunner {
+  run(
+    operations: readonly ReducerScenarioOperation[],
+  ): Promise<ReducerScenarioTrace>;
+}
+```
+
+_No JSDoc summary is available yet._
+
+### ReducerScenarioTrace
+
+```ts
+interface ReducerScenarioTrace {
+  readonly scenarioId: string;
+  readonly gameId: string;
+  readonly viewer: ReducerScenarioViewer;
+  readonly frames: readonly ReducerScenarioFrame[];
+  readonly exchanges: readonly ReducerScenarioExchange[];
+}
+```
+
+_No JSDoc summary is available yet._
+
+### ReducerScenarioViewer
+
+```ts
+interface ReducerScenarioViewer {
+  readonly seatId: string;
+  readonly playerId: string;
+}
+```
+
+_No JSDoc summary is available yet._
+
 ### RejectionExpectation
 
 ```ts
@@ -19066,67 +20011,74 @@ _No JSDoc summary is available yet._
 ### UI_SCENARIO_FIXTURE_BUNDLE_SCHEMA_VERSION
 
 ```ts
-const UI_SCENARIO_FIXTURE_BUNDLE_SCHEMA_VERSION = 1;
+const UI_SCENARIO_FIXTURE_BUNDLE_SCHEMA_VERSION = 2;
 ```
 
 _No JSDoc summary is available yet._
 
-### UI_SCENARIO_FIXTURE_SCHEMA_VERSION
+### UI_SCENARIO_FIXTURE_PLUGIN_RUNTIME_PROTOCOL
 
 ```ts
-const UI_SCENARIO_FIXTURE_SCHEMA_VERSION = 1;
+const UI_SCENARIO_FIXTURE_PLUGIN_RUNTIME_PROTOCOL: 3;
 ```
 
 _No JSDoc summary is available yet._
 
-### UI_SCENARIO_FIXTURE_SUPPORTED_BROWSER_PROTOCOL_MAJOR
+### UI_SCENARIO_FIXTURE_SCHEMA_VERSION
 
 ```ts
-const UI_SCENARIO_FIXTURE_SUPPORTED_BROWSER_PROTOCOL_MAJOR = 2;
+const UI_SCENARIO_FIXTURE_SCHEMA_VERSION = 2;
 ```
 
 _No JSDoc summary is available yet._
 
-### UIFixtureFrame
+### UI_SCENARIO_FIXTURE_SUPPORTED_BROWSER_PROTOCOL_MAJOR
 
 ```ts
-type UIFixtureFrame = Omit<z.infer<typeof uiFixtureFrameSchema>, "snapshot"> & {
-  readonly snapshot: PluginStateSnapshot$1;
-};
+const UI_SCENARIO_FIXTURE_SUPPORTED_BROWSER_PROTOCOL_MAJOR = 3;
 ```
 
 _No JSDoc summary is available yet._
 
-### uiFixtureFrameSchema
+### UIFixtureFrame
 
 ```ts
-declare const uiFixtureFrameSchema: ...;
+type UIFixtureFrame = s;
 ```
 
 _No JSDoc summary is available yet._
 
-### uiFixturePluginStateSnapshotSchema
+### uiFixtureFrameSchema
 
 ```ts
-declare const uiFixturePluginStateSnapshotSchema: ...;
+const uiFixtureFrameSchema: z.ZodObject<
+  {
+    id: z.ZodString;
+    frame: z.ZodType<
+      o<unknown, string, string, string>,
+      unknown,
+      z.core.$ZodTypeInternals<o<unknown, string, string, string>, unknown>
+    >;
+    projectionDigest: z.ZodString;
+  },
+  z.core.$strict
+>;
 ```
 
 _No JSDoc summary is available yet._
 
-### UIFixtureTransportExchange
+### UIFixtureProtocolStep
 
 ```ts
-type UIFixtureTransportExchange = z.infer<
-  typeof uiFixtureTransportExchangeSchema
->;
+type UIFixtureProtocolStep = t;
 ```
 
 _No JSDoc summary is available yet._
 
-### uiFixtureTransportExchangeSchema
+### uiFixtureProtocolStepSchema
 
 ```ts
-declare const uiFixtureTransportExchangeSchema: ...;
+declare const uiFixtureProtocolStepSchema: ...;
 ```
 
 _No JSDoc summary is available yet._
@@ -19206,9 +20158,9 @@ _No JSDoc summary is available yet._
 ```ts
 type UIScenarioFixture = Omit<
   z.infer<typeof uiScenarioFixtureSchema>,
-  "frames" | "replay"
+  "protocol" | "replay"
 > & {
-  readonly frames: readonly UIFixtureFrame[];
+  readonly protocol: PluginProtocolTape;
   readonly replay: readonly UIScenarioReplayStep[];
 };
 ```
@@ -19360,7 +20312,11 @@ _No JSDoc summary is available yet._
 ### BROWSER_INTERACTION_RECORD_ROLES
 
 ```ts
-const BROWSER_INTERACTION_RECORD_ROLES: readonly ["interaction", "actuator"];
+const BROWSER_INTERACTION_RECORD_ROLES: readonly [
+  "interaction",
+  "actuator",
+  "pointer-target",
+];
 ```
 
 _No JSDoc summary is available yet._
@@ -19473,6 +20429,7 @@ declare const browserInteractionDiagnosticSchema: z.ZodObject<
     interactionKey: z.ZodOptional<z.ZodString>;
     intent: z.ZodOptional<z.ZodString>;
     actuatorId: z.ZodOptional<z.ZodString>;
+    targetId: z.ZodOptional<z.ZodString>;
   },
   z.core.$strip
 >;
@@ -19586,31 +20543,97 @@ _No JSDoc summary is available yet._
 ### BrowserInteractionEntity
 
 ```ts
-interface BrowserInteractionEntity {
+interface BrowserInteractionEntity { ... }
+```
+
+_No JSDoc summary is available yet._
+
+### BrowserInteractionIntent
+
+```ts
+type BrowserInteractionIntent = string;
+```
+
+_No JSDoc summary is available yet._
+
+### BrowserInteractionIntentRequest
+
+```ts
+interface BrowserInteractionIntentRequest { ... }
+```
+
+_No JSDoc summary is available yet._
+
+### BrowserInteractionPointerTarget
+
+```ts
+interface BrowserInteractionPointerTarget {
+  readonly targetId: string;
+  readonly enabled: boolean;
+  readonly acceptedEffectPatterns: readonly BrowserInteractionEffectPattern[];
+  readonly descriptorDigest?: string;
+  readonly diagnostics: readonly BrowserInteractionDiagnostic[];
+}
+```
+
+_No JSDoc summary is available yet._
+
+### BrowserInteractionPointerTargetAttributesInput
+
+```ts
+interface BrowserInteractionPointerTargetAttributesInput {
+  readonly surface: string;
+  readonly scopeId: string;
   readonly interactionKey: string;
   readonly interactionId: string;
   readonly descriptorDigest?: string;
-  readonly draftDigest?: string;
-  readonly readiness: BrowserInteractionReadiness;
-  readonly actuators: readonly BrowserInteractionActuator[];
+  readonly targetId: string;
+  readonly enabled?: boolean;
+  readonly acceptedEffectPatterns: readonly BrowserInteractionEffectPattern[];
+}
+```
+
+_No JSDoc summary is available yet._
+
+### BrowserInteractionPointerTargetResolution
+
+```ts
+type BrowserInteractionPointerTargetResolution =
+  | BrowserInteractionPointerTargetResolutionSuccess
+  | BrowserInteractionPointerTargetResolutionFailure;
+```
+
+_No JSDoc summary is available yet._
+
+### BrowserInteractionPointerTargetResolutionFailure
+
+```ts
+interface BrowserInteractionPointerTargetResolutionFailure {
+  readonly ok: false;
+  readonly code:
+    | "ambiguous"
+    | "invalid-effect"
+    | "invalid-snapshot"
+    | "not-found"
+    | "unavailable";
   readonly diagnostics: readonly BrowserInteractionDiagnostic[];
 }
 ```
 
 _No JSDoc summary is available yet._
 
-### BrowserInteractionIntent
+### BrowserInteractionPointerTargetResolutionSuccess
 
 ```ts
-type BrowserInteractionIntent = string;
+interface BrowserInteractionPointerTargetResolutionSuccess { ... }
 ```
 
 _No JSDoc summary is available yet._
 
-### BrowserInteractionIntentRequest
+### browserInteractionPointerTargetSchema
 
 ```ts
-interface BrowserInteractionIntentRequest { ... }
+declare const browserInteractionPointerTargetSchema: ...;
 ```
 
 _No JSDoc summary is available yet._
@@ -19634,7 +20657,7 @@ _No JSDoc summary is available yet._
 ```ts
 interface BrowserInteractionProtocolIdentity {
   readonly name: "dreamboard-browser-interaction";
-  readonly version: "2.0.0";
+  readonly version: "3.0.0";
 }
 ```
 
@@ -19906,6 +20929,16 @@ function createBrowserInteractionActuatorKey(input: {
 
 _No JSDoc summary is available yet._
 
+### createBrowserInteractionPointerTargetAttributes
+
+```ts
+function createBrowserInteractionPointerTargetAttributes(
+  input: BrowserInteractionPointerTargetAttributesInput,
+): BrowserInteractionAttributeMap;
+```
+
+_No JSDoc summary is available yet._
+
 ### createBrowserInteractionRegistry
 
 ```ts
@@ -19946,6 +20979,16 @@ function createGameplayInteractionRootAttributes(
 
 _No JSDoc summary is available yet._
 
+### createGameplayPointerTargetAttributes
+
+```ts
+function createGameplayPointerTargetAttributes(
+  input: GameplayPointerTargetAttributesInput,
+): BrowserInteractionAttributeMap;
+```
+
+_No JSDoc summary is available yet._
+
 ### decodeBrowserInteractionEffect
 
 ```ts
@@ -20008,7 +21051,7 @@ _No JSDoc summary is available yet._
 ### DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION
 
 ```ts
-const DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION: "2.0.0";
+const DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION: "3.0.0";
 ```
 
 _No JSDoc summary is available yet._
@@ -20184,6 +21227,19 @@ function gameplayInvokeEffect(): GameplaySemanticEffect;
 
 _No JSDoc summary is available yet._
 
+### GameplayPointerTargetAttributesInput
+
+```ts
+type GameplayPointerTargetAttributesInput = Omit<
+  BrowserInteractionPointerTargetAttributesInput,
+  "surface" | "acceptedEffectPatterns"
+> & {
+  readonly acceptedEffectPatterns: readonly GameplaySemanticEffectPattern[];
+};
+```
+
+_No JSDoc summary is available yet._
+
 ### GameplaySemanticEffect
 
 ```ts
@@ -20264,6 +21320,29 @@ interface NormalizeBrowserInteractionRecordsOptions {
 
 _No JSDoc summary is available yet._
 
+### pointerTargetIdentityKey
+
+```ts
+function pointerTargetIdentityKey(input: {
+  readonly surface: string;
+  readonly scopeId: string;
+  readonly interactionKey: string;
+  readonly pointerTarget: Pick<BrowserInteractionPointerTarget, "targetId">;
+}): string;
+```
+
+_No JSDoc summary is available yet._
+
+### readBrowserInteractionSnapshot
+
+```ts
+function readBrowserInteractionSnapshot(
+  root: ParentNode,
+): BrowserInteractionSnapshot;
+```
+
+_No JSDoc summary is available yet._
+
 ### resolveBrowserInteractionEffect
 
 ```ts
@@ -20286,6 +21365,17 @@ function resolveBrowserInteractionIntent(
 
 _No JSDoc summary is available yet._
 
+### resolveBrowserPointerTarget
+
+```ts
+function resolveBrowserPointerTarget(
+  snapshot: BrowserInteractionSnapshot,
+  request: BrowserInteractionEffectRequest,
+): BrowserInteractionPointerTargetResolution;
+```
+
+_No JSDoc summary is available yet._
+
 ### targetIdentityKey
 
 ```ts