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

package/dist/runtime/workspace-contract.js

@@ -1,22 +1,27 @@
 import {
+  createGameUi,
   createGameUiContract,
   createWorkspaceUIContract
-} from "../chunk-KRJPRYEA.js";
-import "../chunk-VWTKGIYF.js";
-import "../chunk-6LMESVGT.js";
+} from "../chunk-EVCLTY4Q.js";
+import "../chunk-ANRB4XKA.js";
+import "../chunk-PN5O6GG2.js";
+import "../chunk-LR3ZTWQF.js";
 import "../chunk-T3ZKNUZ7.js";
-import "../chunk-DQS2EG5E.js";
-import "../chunk-TXELBVTG.js";
-import "../chunk-FL67RDID.js";
-import "../chunk-LMHCGCA6.js";
-import "../chunk-VRRR6QZT.js";
+import "../chunk-GDPKTBUR.js";
+import "../chunk-3SKDNDPG.js";
+import "../chunk-32PFKDV7.js";
 import "../chunk-VDXOF4FW.js";
 import "../chunk-WHR5UW3F.js";
+import "../chunk-VCDWP5VL.js";
+import "../chunk-ZZGN2ATS.js";
+import "../chunk-H6VDGFL5.js";
+import "../chunk-5YV2WHJ4.js";
 import "../chunk-PF7L4BMG.js";
-import "../chunk-XFMSLL3P.js";
-import "../chunk-2GQIALJL.js";
+import "../chunk-Z7QCREWI.js";
+import "../chunk-UGH54WZ2.js";
 import "../chunk-PZ5AY32C.js";
 export {
+  createGameUi,
   createGameUiContract,
   createWorkspaceUIContract
 };

package/dist/{runtime-C7Z2acNU.d.ts → runtime-RJ5orDJU.d.ts}

@@ -1,12 +1,11 @@
 import { z } from 'zod';
 import { CardCollection, ViewCard, ViewSlotOccupant } from './types.js';
-import { d, O, s, t, u } from './protocol-CVaSqPgX.js';
+import { d, O, s, t, u } from './protocol-dYgafTYY.js';
 
 /**
  * Opaque brand applied to a runtime player identifier.
  *
- * Generators produce a workspace-specific `PlayerId` alias (e.g.
- * `Brand<string, "PlayerId">` in `shared/manifest-contract.ts`). Authors
+ * The reducer owns the branded `PlayerId` identity. Authors
  * obtain `PlayerId` values only through:
  *   - `q.player.order()` / `q.player.current()` (reducer queries),
  *   - engine-injected callback arguments (actions, phases, prompts),
@@ -421,7 +420,7 @@ type TableOfState<State> = State extends {
 } ? Table : never;
 type TableOfManifest<Manifest> = Manifest extends {
     tableSchema: z.ZodType<infer Table extends RuntimeTableRecord>;
-} ? Table : Manifest extends GeneratedManifestContractLike<infer Table> ? Table : never;
+} ? Table : Manifest extends ReducerManifestContractLike<infer Table> ? Table : never;
 type PhaseNameOfState<State> = State extends {
     flow: {
         currentPhase: infer PhaseName;
@@ -823,9 +822,9 @@ type SetupSelectionOfManifest<Manifest> = {
     profileId: SetupProfileIdOfManifest<Manifest>;
     optionValues: Record<SetupOptionIdOfManifest<Manifest>, string | null>;
 };
-type RuntimeSetupSelectionInput<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = SetupSelectionInputOfManifest<Manifest>;
-type RuntimeSetupSelection<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = SetupSelectionOfManifest<Manifest>;
-type RuntimeSetupSelectionOverride<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = SetupSelectionInputOfManifest<Manifest>;
+type RuntimeSetupSelectionInput<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = SetupSelectionInputOfManifest<Manifest>;
+type RuntimeSetupSelection<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = SetupSelectionOfManifest<Manifest>;
+type RuntimeSetupSelectionOverride<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = SetupSelectionInputOfManifest<Manifest>;
 type StateDefinitionOfContract<Contract> = Contract extends {
     state: infer StateDefinitionValue;
 } ? StateDefinitionValue : never;
@@ -840,7 +839,7 @@ type PrivateSchemaOfContract<Contract> = StateDefinitionOfContract<Contract> ext
 type HiddenSchemaOfContract<Contract> = StateDefinitionOfContract<Contract> extends StateDefinition<SchemaLike<object>, SchemaLike<object>, infer HiddenSchema> ? HiddenSchema : never;
 type PhaseNameOfContract<Contract> = keyof PhaseSchemasOfContract<Contract> extends string ? keyof PhaseSchemasOfContract<Contract> & string : PhaseNameOfManifest<ManifestOf<Contract>>;
 type ManifestContractOf<Contract> = ManifestContract<TableOfManifest<ManifestOf<Contract>>>;
-type ExactManifestContractOf<Contract> = ManifestOf<Contract> & GeneratedManifestContractLike<TableOfManifest<ManifestOf<Contract>>>;
+type ExactManifestContractOf<Contract> = ManifestOf<Contract> & ReducerManifestContractLike<TableOfManifest<ManifestOf<Contract>>>;
 type PhaseNameOf<Source> = Source extends {
     flow: {
         currentPhase: infer PhaseName;
@@ -1204,12 +1203,6 @@ type ManifestNormalSetup<Table extends RuntimeTableRecord> = {
     }) => Table;
 };
 type StaticBoards<Table extends RuntimeTableRecord> = Pick<Table["boards"], "byId" | "hex" | "square">;
-type StaticBoardsJsonEnvelope<Table extends RuntimeTableRecord = RuntimeTableRecord> = {
-    formatVersion: 1;
-    generatedBy: "@dreamboard-games/sdk/codegen";
-    boards: StaticBoards<Table>;
-    initialTable: Table;
-};
 type SetupOptionChoiceMetadata = {
     id: string;
     label: string;
@@ -1240,11 +1233,11 @@ type ReducerManifestContract<Table extends RuntimeTableRecord, PhaseName extends
     ids: ManifestIds<PlayerId, DeckId, HandId, CardId, PhaseName>;
     defaults: ManifestDefaults<Table>;
     /**
-     * Generic normal-session setup capability emitted by workspace codegen.
+     * Normal-session setup capability supplied by the manifest compiler.
      *
      * This remains optional on the structural contract so small handwritten
      * manifests can model focused reducer tests without recreating generated
-     * topology metadata. Generated workspace manifests always provide it.
+     * topology metadata. Compiled manifests always provide it.
      */
     normalSetup?: ManifestNormalSetup<Table>;
     staticBoards?: StaticBoards<Table>;
@@ -1261,7 +1254,7 @@ type ReducerManifestContract<Table extends RuntimeTableRecord, PhaseName extends
         phasesSchema: AnySchema;
     }) => AnySchema;
 };
-type GeneratedManifestContractLike<Table extends RuntimeTableRecord = RuntimeTableRecord, PhaseName extends string = string, PlayerId extends string = string, DeckId extends string = string, HandId extends string = string, CardId extends string = string> = ReducerManifestContract<Table, PhaseName, PlayerId, DeckId, HandId, CardId>;
+type ReducerManifestContractLike<Table extends RuntimeTableRecord = RuntimeTableRecord, PhaseName extends string = string, PlayerId extends string = string, DeckId extends string = string, HandId extends string = string, CardId extends string = string> = ReducerManifestContract<Table, PhaseName, PlayerId, DeckId, HandId, CardId>;
 type ManifestContract<Table extends RuntimeTableRecord> = ReducerManifestContract<Table, string, PlayerIdOfTable<Table>, DeckIdOfTable<Table>, HandIdOfTable<Table>, CardIdOfTable<Table>>;
 declare function markManifestScopedSchema<Schema extends z.ZodTypeAny, const Family extends ManifestIdFamily | undefined = undefined>(schema: Schema, family?: Family): Schema & ManifestIdSchema<z.infer<Schema>, Family>;
 declare function isManifestScopedSchema(schema: unknown): boolean;
@@ -1412,41 +1405,41 @@ type InitContext<Table extends RuntimeTableRecord, Manifest extends ReducerManif
         table: Table;
     }>;
 };
-type InitSetupSelectionInput<Manifest extends ReducerManifestContract<RuntimeTableRecord, string, string, string, string, string> = GeneratedManifestContractLike> = SetupSelectionInputOfManifest<Manifest>;
-type SetupBootstrapSharedZoneRef<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = {
+type InitSetupSelectionInput<Manifest extends ReducerManifestContract<RuntimeTableRecord, string, string, string, string, string> = ReducerManifestContractLike> = SetupSelectionInputOfManifest<Manifest>;
+type SetupBootstrapSharedZoneRef<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = {
     type: "sharedZone";
     zoneId: SharedZoneIdOfManifest<Manifest>;
 };
-type SetupBootstrapPerPlayerZoneRef<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = {
+type SetupBootstrapPerPlayerZoneRef<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = {
     type: "playerZone";
     zoneId: PlayerZoneIdOfManifest<Manifest>;
     playerId: PlayerIdOfManifest<Manifest>;
 };
-type SetupBootstrapSharedBoardContainerRef<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = {
+type SetupBootstrapSharedBoardContainerRef<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = {
     type: "sharedBoardContainer";
     boardId: BoardBaseIdOfManifest<Manifest>;
     containerId: BoardContainerIdOfManifest<Manifest>;
 };
-type SetupBootstrapPerPlayerBoardContainerRef<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = {
+type SetupBootstrapPerPlayerBoardContainerRef<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = {
     type: "playerBoardContainer";
     boardId: BoardBaseIdOfManifest<Manifest>;
     playerId: PlayerIdOfManifest<Manifest>;
     containerId: BoardContainerIdOfManifest<Manifest>;
 };
-type SetupBootstrapSharedBoardSpaceRef<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = {
+type SetupBootstrapSharedBoardSpaceRef<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = {
     type: "sharedBoardSpace";
     boardId: BoardBaseIdOfManifest<Manifest>;
     spaceId: SpaceIdOfManifest<Manifest>;
 };
-type SetupBootstrapPerPlayerBoardSpaceRef<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = {
+type SetupBootstrapPerPlayerBoardSpaceRef<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = {
     type: "playerBoardSpace";
     boardId: BoardBaseIdOfManifest<Manifest>;
     playerId: PlayerIdOfManifest<Manifest>;
     spaceId: SpaceIdOfManifest<Manifest>;
 };
-type SetupBootstrapContainerRef<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = SetupBootstrapSharedZoneRef<Manifest> | SetupBootstrapPerPlayerZoneRef<Manifest> | SetupBootstrapSharedBoardContainerRef<Manifest> | SetupBootstrapPerPlayerBoardContainerRef<Manifest>;
-type SetupBootstrapDestinationRef<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = SetupBootstrapContainerRef<Manifest> | SetupBootstrapSharedBoardSpaceRef<Manifest> | SetupBootstrapPerPlayerBoardSpaceRef<Manifest>;
-type SetupBootstrapPerPlayerContainerTemplateRef<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = {
+type SetupBootstrapContainerRef<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = SetupBootstrapSharedZoneRef<Manifest> | SetupBootstrapPerPlayerZoneRef<Manifest> | SetupBootstrapSharedBoardContainerRef<Manifest> | SetupBootstrapPerPlayerBoardContainerRef<Manifest>;
+type SetupBootstrapDestinationRef<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = SetupBootstrapContainerRef<Manifest> | SetupBootstrapSharedBoardSpaceRef<Manifest> | SetupBootstrapPerPlayerBoardSpaceRef<Manifest>;
+type SetupBootstrapPerPlayerContainerTemplateRef<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = {
     type: "playerZone";
     zoneId: PlayerZoneIdOfManifest<Manifest>;
 } | {
@@ -1454,7 +1447,7 @@ type SetupBootstrapPerPlayerContainerTemplateRef<Manifest extends GeneratedManif
     boardId: BoardBaseIdOfManifest<Manifest>;
     containerId: BoardContainerIdOfManifest<Manifest>;
 };
-type SetupBootstrapStep<Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = {
+type SetupBootstrapStep<Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = {
     type: "shuffle";
     container: SetupBootstrapContainerRef<Manifest>;
 } | {
@@ -1470,7 +1463,7 @@ type SetupBootstrapStep<Manifest extends GeneratedManifestContractLike = Generat
     count: number;
     playerIds?: readonly PlayerIdOfManifest<Manifest>[];
 };
-type SetupProfileDefinition<PhaseName extends string = string, Manifest extends GeneratedManifestContractLike = GeneratedManifestContractLike> = {
+type SetupProfileDefinition<PhaseName extends string = string, Manifest extends ReducerManifestContractLike = ReducerManifestContractLike> = {
     initialPhase?: PhaseName;
     bootstrap?: readonly SetupBootstrapStep<Manifest>[];
 };
@@ -1703,4 +1696,4 @@ type ReducerAccept<State> = {
 };
 type ReducerResult<State> = ReducerAccept<State> | ReducerReject;
 
-export { type HexEdgeIdOfTable as $, type AnyContinuationToken as A, type BoardBaseIdOfManifest as B, type CardIdOfDeck as C, type ContinuationResponseOf as D, type ContinuationToken as E, type DeckCardsOfTable as F, type DeckIdOfState as G, type DeckIdOfTable as H, type DieIdOfManifest as I, type EdgeTypeIdOfManifest as J, type EffectInvokeOptions as K, type EffectSpecLike as L, type EffectTypeTag as M, type ErrorCodeOfContract as N, type ExactManifestContractOf as O, type FlowState as P, type FrameworkErrorCode as Q, FrameworkErrorCodes as R, type GameEvent as S, type GameEventDetail as T, type GameOutcome as U, type GeneratedManifestContractLike as V, type HandCardsOfTable as W, type HandIdOfState as X, type HandIdOfTable as Y, type HexBoardIdOfTable as Z, type HexBoardStateOfTable as _, type AnySchema as a, type ResolvedContainerLocation as a$, type HexEdgeStateOfTable as a0, type HexEdgeTypeIdOfTable as a1, type HexSpaceIdOfTable as a2, type HexSpaceTypeIdOfTable as a3, type HexVertexIdOfTable as a4, type HexVertexStateOfTable as a5, type HexVertexTypeIdOfTable as a6, type HiddenSchemaOfContract as a7, type HiddenStateOfState as a8, type InitContext as a9, type PhaseStateMapOfContract as aA, type PhaseStateOfState as aB, type PhaseStepOfState as aC, type PieceIdOfManifest as aD, type PlayerId as aE, type PlayerIdOfManifest as aF, type PlayerIdOfState as aG, type PlayerIdOfTable as aH, type PlayerZoneIdOfManifest as aI, type PlayerZoneIdOfState as aJ, type PlayerZoneIdOfTable as aK, type PrivateSchemaOfContract as aL, type PrivateStateOfState as aM, type PublicSchemaOfContract as aN, type PublicStateOfState as aO, type ReducerAccept as aP, type ReducerAcceptOptions as aQ, type ReducerFx as aR, type ReducerGameState as aS, type ReducerManifestContract as aT, type ReducerReject as aU, type ReducerResult as aV, type ReducerRuntimeStateForState as aW, type ReducerSessionState as aX, type ReducerValidationResult as aY, type RelationTypeIdOfManifest as aZ, type RelationTypeIdOfTable as a_, type InitSetupSelectionInput as aa, type ManifestContract as ab, type ManifestContractOf as ac, type ManifestDefaults as ad, type ManifestIdFamily as ae, type ManifestIdSchema as af, type ManifestIds as ag, type ManifestLiterals as ah, type ManifestNormalSetup as ai, type ManifestOf as aj, type NonEmptyReadonlyArray as ak, type OutcomeResult as al, type OutcomeScoreComponent as am, type OutcomeStanding as an, type OutcomeTieBreak as ao, type PerPlayer as ap, type PerPlayerBoardRef as aq, type PerPlayerSchemaOptions as ar, type PhaseAccessor as as, type PhaseMapOfState as at, type PhaseNameOf as au, type PhaseNameOfContract as av, type PhaseNameOfManifest as aw, type PhaseNameOfState as ax, type PhasePayload as ay, type PhaseSchemasOfContract as az, type BoardContainerIdOfManifest as b, type RuntimeVisibilityMap as b$, type ResolvedDeckLocation as b0, type ResolvedEdgeLocation as b1, type ResolvedHandLocation as b2, type ResolvedSlotLocation as b3, type ResolvedSpaceLocation as b4, type ResolvedVertexLocation as b5, type ResolvedZoneLocation as b6, type ResourceAmountsOfTable as b7, type ResourceBalancesOfState as b8, type ResourceBalancesOfTable as b9, type RuntimePayload as bA, type RuntimePhaseState as bB, type RuntimePieceData as bC, type RuntimeRecord as bD, type RuntimeResourceMap as bE, type RuntimeRngDraw as bF, type RuntimeRngOperation as bG, type RuntimeRngOperationParameter as bH, type RuntimeRngState as bI, type RuntimeScalar as bJ, type RuntimeSetupSelection as bK, type RuntimeSetupSelectionInput as bL, type RuntimeSetupSelectionOverride as bM, type RuntimeSimultaneousState as bN, type RuntimeSimultaneousSubmission as bO, type RuntimeSlotHostRef as bP, type RuntimeSquareBoardState as bQ, type RuntimeSquareEdgeState as bR, type RuntimeSquareSpaceState as bS, type RuntimeSquareVertexState as bT, type RuntimeState as bU, type RuntimeTableRecord as bV, type RuntimeTiledBoardBaseState as bW, type RuntimeTiledBoardState as bX, type RuntimeTiledEdgeState as bY, type RuntimeTiledSpaceState as bZ, type RuntimeTiledVertexState as b_, type ResourceIdOfManifest as ba, type ResourceIdOfState as bb, type ResourceIdOfTable as bc, type RuntimeBoardBaseState as bd, type RuntimeBoardCollections as be, type RuntimeBoardCompatibilityState as bf, type RuntimeBoardContainerState as bg, type RuntimeBoardRelationState as bh, type RuntimeBoardSpaceState as bi, type RuntimeBoardState as bj, type RuntimeCardData as bk, type RuntimeCardVisibility as bl, type RuntimeComponentLocation as bm, type RuntimeComponentLocationMap as bn, type RuntimeDeckMap as bo, type RuntimeDieData as bp, type RuntimeGenericBoardState as bq, type RuntimeHandMap as br, type RuntimeHandVisibilityMode as bs, type RuntimeHexBoardState as bt, type RuntimeHexEdgeState as bu, type RuntimeHexOrientation as bv, type RuntimeHexSpaceState as bw, type RuntimeHexVertexState as bx, type RuntimeOwnerMap as by, type RuntimeParams as bz, type BoardContainerIdOfTable as c, boardRef as c$, type RuntimeZoneMap as c0, type SchemaLike as c1, type SetupBootstrapContainerRef as c2, type SetupBootstrapDestinationRef as c3, type SetupBootstrapPerPlayerBoardContainerRef as c4, type SetupBootstrapPerPlayerBoardSpaceRef as c5, type SetupBootstrapPerPlayerContainerTemplateRef as c6, type SetupBootstrapPerPlayerZoneRef as c7, type SetupBootstrapSharedBoardContainerRef as c8, type SetupBootstrapSharedBoardSpaceRef as c9, type SquareVertexStateOfTable as cA, type SquareVertexTypeIdOfTable as cB, type StateDefinition as cC, type StateDefinitionOfContract as cD, type StaticBoards as cE, type StaticBoardsJsonEnvelope as cF, type StringKeyOf as cG, type SystemActionEvent as cH, type TableOfManifest as cI, type TableOfState as cJ, type TableQueries as cK, type TableQueriesOfState as cL, type TiledBoardIdOfTable as cM, type TiledBoardStateOfTable as cN, type TiledEdgeIdOfTable as cO, type TiledEdgeMap as cP, type TiledEdgeStateOfTable as cQ, type TiledEdgeTypeIdOfTable as cR, type TiledSpaceIdOfTable as cS, type TiledSpaceMap as cT, type TiledVertexIdOfTable as cU, type TiledVertexMap as cV, type TiledVertexStateOfTable as cW, type TiledVertexTypeIdOfTable as cX, type VertexTypeIdOfManifest as cY, asPlayerId as cZ, assumeManifestSchema as c_, type SetupBootstrapSharedZoneRef as ca, type SetupBootstrapStep as cb, type SetupOptionChoiceMetadata as cc, type SetupOptionIdOfManifest as cd, type SetupOptionMetadata as ce, type SetupProfileDefinition as cf, type SetupProfileIdOfManifest as cg, type SetupProfileMetadata as ch, type SetupSelectionInputOfManifest as ci, type SetupSelectionOfManifest as cj, type SharedBoardRef as ck, type SharedZoneIdOfManifest as cl, type SharedZoneIdOfState as cm, type SharedZoneIdOfTable as cn, type SpaceIdOfManifest as co, type SpaceIdOfTable as cp, type SpaceTypeIdOfManifest as cq, type SpaceTypeIdOfTable as cr, type SquareBoardIdOfTable as cs, type SquareBoardStateOfTable as ct, type SquareEdgeIdOfTable as cu, type SquareEdgeStateOfTable as cv, type SquareEdgeTypeIdOfTable as cw, type SquareSpaceIdOfTable as cx, type SquareSpaceTypeIdOfTable as cy, type SquareVertexIdOfTable as cz, type BoardIdOfManifest as d, boardRefKey as d0, boardRefSchema as d1, cloneManifestDefault as d2, createManifestGameStateSchema as d3, createManifestRuntimeSchema as d4, createManifestStringLiteralSchema as d5, isManifestScopedSchema as d6, isPerPlayer as d7, isPerPlayerBoardRef as d8, isPlayerId as d9, isSharedBoardRef as da, manifestSchemaFamily as db, markManifestScopedSchema as dc, parseBoardRefKey as dd, perPlayer as de, perPlayerBoardRef as df, perPlayerEntries as dg, perPlayerGet as dh, perPlayerHas as di, perPlayerKeys as dj, perPlayerMap as dk, perPlayerRequire as dl, perPlayerSchema as dm, perPlayerSet as dn, perPlayerSize as dp, perPlayerValues as dq, resolveManifestPlayerIds as dr, sharedBoardRef as ds, type BoardIdOfTable as e, type BoardLayoutOfManifest as f, type BoardMapOfTable as g, type BoardRef as h, type BoardStateOfTable as i, type BoardTypeIdOfManifest as j, type BoardTypeIdOfTable as k, type Brand as l, type CardIdOfHand as m, type CardIdOfManifest as n, type CardIdOfState as o, type CardIdOfTable as p, type CardTypeOfState as q, type CardTypeOfTable as r, type ChoiceOption as s, type CompatibleCardIdForHandAndDeck as t, type CompatibleCardIdForTwoPlayerZones as u, type CompatibleHandIdForDeck as v, type ComponentDataOfTable as w, type ComponentIdOfTable as x, type ComponentLocationByTypeOfTable as y, type ComponentLocationOfTable as z };
+export { type HexEdgeStateOfTable as $, type AnyContinuationToken as A, type BoardBaseIdOfManifest as B, type CardIdOfDeck as C, type ContinuationResponseOf as D, type ContinuationToken as E, type DeckCardsOfTable as F, type DeckIdOfState as G, type DeckIdOfTable as H, type DieIdOfManifest as I, type EdgeTypeIdOfManifest as J, type EffectInvokeOptions as K, type EffectSpecLike as L, type EffectTypeTag as M, type ErrorCodeOfContract as N, type ExactManifestContractOf as O, type FlowState as P, type FrameworkErrorCode as Q, FrameworkErrorCodes as R, type GameEvent as S, type GameEventDetail as T, type GameOutcome as U, type HandCardsOfTable as V, type HandIdOfState as W, type HandIdOfTable as X, type HexBoardIdOfTable as Y, type HexBoardStateOfTable as Z, type HexEdgeIdOfTable as _, type AnySchema as a, type ResolvedContainerLocation as a$, type HexEdgeTypeIdOfTable as a0, type HexSpaceIdOfTable as a1, type HexSpaceTypeIdOfTable as a2, type HexVertexIdOfTable as a3, type HexVertexStateOfTable as a4, type HexVertexTypeIdOfTable as a5, type HiddenSchemaOfContract as a6, type HiddenStateOfState as a7, type InitContext as a8, type InitSetupSelectionInput as a9, type PhaseStateOfState as aA, type PhaseStepOfState as aB, type PieceIdOfManifest as aC, type PlayerId as aD, type PlayerIdOfManifest as aE, type PlayerIdOfState as aF, type PlayerIdOfTable as aG, type PlayerZoneIdOfManifest as aH, type PlayerZoneIdOfState as aI, type PlayerZoneIdOfTable as aJ, type PrivateSchemaOfContract as aK, type PrivateStateOfState as aL, type PublicSchemaOfContract as aM, type PublicStateOfState as aN, type ReducerAccept as aO, type ReducerAcceptOptions as aP, type ReducerFx as aQ, type ReducerGameState as aR, type ReducerManifestContract as aS, type ReducerManifestContractLike as aT, type ReducerReject as aU, type ReducerResult as aV, type ReducerRuntimeStateForState as aW, type ReducerSessionState as aX, type ReducerValidationResult as aY, type RelationTypeIdOfManifest as aZ, type RelationTypeIdOfTable as a_, type ManifestContract as aa, type ManifestContractOf as ab, type ManifestDefaults as ac, type ManifestIdFamily as ad, type ManifestIdSchema as ae, type ManifestIds as af, type ManifestLiterals as ag, type ManifestNormalSetup as ah, type ManifestOf as ai, type NonEmptyReadonlyArray as aj, type OutcomeResult as ak, type OutcomeScoreComponent as al, type OutcomeStanding as am, type OutcomeTieBreak as an, type PerPlayer as ao, type PerPlayerBoardRef as ap, type PerPlayerSchemaOptions as aq, type PhaseAccessor as ar, type PhaseMapOfState as as, type PhaseNameOf as at, type PhaseNameOfContract as au, type PhaseNameOfManifest as av, type PhaseNameOfState as aw, type PhasePayload as ax, type PhaseSchemasOfContract as ay, type PhaseStateMapOfContract as az, type BoardContainerIdOfManifest as b, type RuntimeTiledVertexState as b$, type ResolvedDeckLocation as b0, type ResolvedEdgeLocation as b1, type ResolvedHandLocation as b2, type ResolvedSlotLocation as b3, type ResolvedSpaceLocation as b4, type ResolvedVertexLocation as b5, type ResolvedZoneLocation as b6, type ResourceAmountsOfTable as b7, type ResourceBalancesOfState as b8, type ResourceBalancesOfTable as b9, type RuntimeParams as bA, type RuntimePayload as bB, type RuntimePhaseState as bC, type RuntimePieceData as bD, type RuntimeRecord as bE, type RuntimeResourceMap as bF, type RuntimeRngDraw as bG, type RuntimeRngOperation as bH, type RuntimeRngOperationParameter as bI, type RuntimeRngState as bJ, type RuntimeScalar as bK, type RuntimeSetupSelection as bL, type RuntimeSetupSelectionInput as bM, type RuntimeSetupSelectionOverride as bN, type RuntimeSimultaneousState as bO, type RuntimeSimultaneousSubmission as bP, type RuntimeSlotHostRef as bQ, type RuntimeSquareBoardState as bR, type RuntimeSquareEdgeState as bS, type RuntimeSquareSpaceState as bT, type RuntimeSquareVertexState as bU, type RuntimeState as bV, type RuntimeTableRecord as bW, type RuntimeTiledBoardBaseState as bX, type RuntimeTiledBoardState as bY, type RuntimeTiledEdgeState as bZ, type RuntimeTiledSpaceState as b_, type ResourceIdOfManifest as ba, type ResourceIdOfState as bb, type ResourceIdOfTable as bc, type RuntimeBoardBaseState as bd, type RuntimeBoardCollections as be, type RuntimeBoardCompatibilityState as bf, type RuntimeBoardContainerState as bg, type RuntimeBoardRelationState as bh, type RuntimeBoardSpaceState as bi, type RuntimeBoardState as bj, type RuntimeCardData as bk, type RuntimeCardVisibility as bl, type RuntimeComponentLocation as bm, type RuntimeComponentLocationMap as bn, type RuntimeDeckMap as bo, type RuntimeDieData as bp, type RuntimeGenericBoardState as bq, type RuntimeHandMap as br, type RuntimeHandVisibilityMode as bs, type RuntimeHexBoardState as bt, type RuntimeHexEdgeState as bu, type RuntimeHexOrientation as bv, type RuntimeHexSpaceState as bw, type RuntimeHexVertexState as bx, type RuntimeInstructionForState as by, type RuntimeOwnerMap as bz, type BoardContainerIdOfTable as c, boardRef as c$, type RuntimeVisibilityMap as c0, type RuntimeZoneMap as c1, type SchemaLike as c2, type SetupBootstrapContainerRef as c3, type SetupBootstrapDestinationRef as c4, type SetupBootstrapPerPlayerBoardContainerRef as c5, type SetupBootstrapPerPlayerBoardSpaceRef as c6, type SetupBootstrapPerPlayerContainerTemplateRef as c7, type SetupBootstrapPerPlayerZoneRef as c8, type SetupBootstrapSharedBoardContainerRef as c9, type SquareVertexIdOfTable as cA, type SquareVertexStateOfTable as cB, type SquareVertexTypeIdOfTable as cC, type StateDefinition as cD, type StateDefinitionOfContract as cE, type StaticBoards as cF, type StringKeyOf as cG, type SystemActionEvent as cH, type TableOfManifest as cI, type TableOfState as cJ, type TableQueries as cK, type TableQueriesOfState as cL, type TiledBoardIdOfTable as cM, type TiledBoardStateOfTable as cN, type TiledEdgeIdOfTable as cO, type TiledEdgeMap as cP, type TiledEdgeStateOfTable as cQ, type TiledEdgeTypeIdOfTable as cR, type TiledSpaceIdOfTable as cS, type TiledSpaceMap as cT, type TiledVertexIdOfTable as cU, type TiledVertexMap as cV, type TiledVertexStateOfTable as cW, type TiledVertexTypeIdOfTable as cX, type VertexTypeIdOfManifest as cY, asPlayerId as cZ, assumeManifestSchema as c_, type SetupBootstrapSharedBoardSpaceRef as ca, type SetupBootstrapSharedZoneRef as cb, type SetupBootstrapStep as cc, type SetupOptionChoiceMetadata as cd, type SetupOptionIdOfManifest as ce, type SetupOptionMetadata as cf, type SetupProfileDefinition as cg, type SetupProfileIdOfManifest as ch, type SetupProfileMetadata as ci, type SetupSelectionInputOfManifest as cj, type SetupSelectionOfManifest as ck, type SharedBoardRef as cl, type SharedZoneIdOfManifest as cm, type SharedZoneIdOfState as cn, type SharedZoneIdOfTable as co, type SpaceIdOfManifest as cp, type SpaceIdOfTable as cq, type SpaceTypeIdOfManifest as cr, type SpaceTypeIdOfTable as cs, type SquareBoardIdOfTable as ct, type SquareBoardStateOfTable as cu, type SquareEdgeIdOfTable as cv, type SquareEdgeStateOfTable as cw, type SquareEdgeTypeIdOfTable as cx, type SquareSpaceIdOfTable as cy, type SquareSpaceTypeIdOfTable as cz, type BoardIdOfManifest as d, boardRefKey as d0, boardRefSchema as d1, cloneManifestDefault as d2, createManifestGameStateSchema as d3, createManifestRuntimeSchema as d4, createManifestStringLiteralSchema as d5, isManifestScopedSchema as d6, isPerPlayer as d7, isPerPlayerBoardRef as d8, isPlayerId as d9, isSharedBoardRef as da, manifestSchemaFamily as db, markManifestScopedSchema as dc, parseBoardRefKey as dd, perPlayer as de, perPlayerBoardRef as df, perPlayerEntries as dg, perPlayerGet as dh, perPlayerHas as di, perPlayerKeys as dj, perPlayerMap as dk, perPlayerRequire as dl, perPlayerSchema as dm, perPlayerSet as dn, perPlayerSize as dp, perPlayerValues as dq, resolveManifestPlayerIds as dr, sharedBoardRef as ds, type BoardIdOfTable as e, type BoardLayoutOfManifest as f, type BoardMapOfTable as g, type BoardRef as h, type BoardStateOfTable as i, type BoardTypeIdOfManifest as j, type BoardTypeIdOfTable as k, type Brand as l, type CardIdOfHand as m, type CardIdOfManifest as n, type CardIdOfState as o, type CardIdOfTable as p, type CardTypeOfState as q, type CardTypeOfTable as r, type ChoiceOption as s, type CompatibleCardIdForHandAndDeck as t, type CompatibleCardIdForTwoPlayerZones as u, type CompatibleHandIdForDeck as v, type ComponentDataOfTable as w, type ComponentIdOfTable as x, type ComponentLocationByTypeOfTable as y, type ComponentLocationOfTable as z };

package/dist/{plugin-state-BRH3UiUp.d.ts → runtime-api-Bz5pwNU_.d.ts}

@@ -1,3 +1,8 @@
+import { w } from './protocol-dYgafTYY.js';
+
+/** Player identity received through the host protocol. */
+type PlayerId = w["playerId"];
+
 /** Choice option surfaced on a prompt-kind interaction's structured context. */
 interface InteractionContextOption {
     id: string;
@@ -206,9 +211,86 @@ interface SystemActionEvent {
     details?: readonly GameEventDetail[];
 }
 type GameEvent = SystemActionEvent;
-type ProjectedGameEvent = GameEvent & {
-    version: number;
-    index: number;
+
+/**
+ * Result of validating a player action
+ */
+interface ValidationResult {
+    /** Whether the action is valid */
+    valid: boolean;
+    /** Machine-readable error code if validation failed */
+    errorCode?: string;
+    /** Human-readable error message if validation failed */
+    message?: string;
+}
+/**
+ * Structured authoritative submission failure returned by runtime submit APIs.
+ */
+interface SubmissionError extends Error {
+    /** Machine-readable error code when available */
+    errorCode?: string;
+}
+type RuntimeDiagnosticEvent = {
+    type: "runtimeLog";
+    level: "log" | "warn" | "error";
+    message: string;
+    details?: readonly unknown[];
+} | {
+    type: "internalError";
+    code: string;
+    message: string;
+    stack?: string;
 };
+type RuntimeDiagnosticHandler = (event: RuntimeDiagnosticEvent) => void;
+/**
+ * Plugin session state
+ */
+interface PluginSessionState {
+    /** Session initialization status */
+    status: "loading" | "ready";
+    /** Current session ID (null if not initialized) */
+    sessionId: string | null;
+    /** The player perspective represented by the current gameplay frame */
+    controllingPlayerId: PlayerId | null;
+}
+/**
+ * RuntimeAPI provides the interface between plugin code and the game runtime.
+ * This API is exposed to plugin iframes for subscribing to game events and submitting actions.
+ */
+interface RuntimeAPI {
+    /**
+     * Submit a player interaction to the game server. `submitInteraction`
+     * is the single submission verb for every interaction kind — authors
+     * do not split between "action" and "prompt response" calls.
+     *
+     * @param interactionId - Identifier of the interaction
+     * @param params - Interaction-specific runtime JSON payload; prompt
+     *   collectors may submit scalars while ordinary collectors submit objects.
+     * @throws SubmissionError if submission is rejected by the authority.
+     */
+    submitInteraction: (interactionId: string, params: unknown) => Promise<void>;
+    emitDiagnostic?: (event: RuntimeDiagnosticEvent) => void;
+    setDiagnosticHandler?: (handler: RuntimeDiagnosticHandler | undefined) => void;
+    /**
+     * Get the current plugin session state.
+     * Returns initialization status and session/player IDs.
+     *
+     * @returns Current plugin session state
+     *
+     * @example
+     * ```typescript
+     * const { status, sessionId, playerId } = runtime.getSessionState();
+     * if (status === "ready") {
+     *   console.log('Connected to session:', sessionId);
+     * }
+     * ```
+     */
+    getSessionState: () => PluginSessionState;
+    /**
+     * Disconnect from the runtime and clean up all listeners.
+     * Should be called when the plugin is unmounting.
+     */
+    disconnect: () => void;
+}
 
-export type { GameEvent as G, InputDomain as I, ProjectedGameEvent as P, SystemActionEvent as S, ZoneHandlesSnapshot as Z, GameEventDetail as a, InteractionDescriptor as b, InteractionInputDescriptor as c };
+export type { GameEvent as G, InputDomain as I, PlayerId as P, RuntimeAPI as R, SubmissionError as S, ValidationResult as V, ZoneHandlesSnapshot as Z, GameEventDetail as a, InteractionDescriptor as b, InteractionInputDescriptor as c, PluginSessionState as d, RuntimeDiagnosticEvent as e, RuntimeDiagnosticHandler as f, SystemActionEvent as g };

package/dist/runtime.d.ts

@@ -1,12 +1,12 @@
-import { b5 as UIContract$1, G as DreamboardUI$1, b3 as TypedGame$1 } from './ui-contract-BC4JpysE.js';
-export { c as BoardGridInteractionFilter, g as BoardHexGridProps, i as BoardHexViewProps, m as BoardSpaceTargetProps, o as BoardSquareGridInteractionFilter, p as BoardSquareGridProps, M as GameMeState, Q as GamePlayersState, R as GameRenderState, U as GameTurnState, b7 as UIRootProps, bh as ZoneCardRenderItem, bl as ZoneListProps } from './ui-contract-BC4JpysE.js';
-export { a as ClientParamSchemaMap, W as WorkspaceBoardSurface, b as WorkspaceBoardSurfaceDescriptor, c as WorkspaceBoardTargetInputSlot, d as WorkspaceCardCollectionSurface, e as WorkspaceCardCollectionSurfaceDescriptor, f as WorkspaceCardInputSlot, g as WorkspaceFormInputSlot, h as WorkspaceHandSurface, i as WorkspaceHandSurfaceDescriptor, j as WorkspaceInteractionFormDescriptor, k as WorkspaceInteractionFormsDescriptor, l as WorkspaceInteractionSlotComponent, m as WorkspacePileSurface, n as WorkspacePileSurfaceDescriptor, o as WorkspacePilesSurfaceDescriptor, p as WorkspaceSurfaceSpec, q as createWorkspaceUIContract } from './index-CR69MyWr.js';
+import { b5 as UIContract$1, G as DreamboardUI$1, b3 as TypedGame$1 } from './ui-contract-GTUPkf8z.js';
+export { c as BoardGridInteractionFilter, g as BoardHexGridProps, i as BoardHexViewProps, m as BoardSpaceTargetProps, o as BoardSquareGridInteractionFilter, p as BoardSquareGridProps, M as GameMeState, Q as GamePlayersState, R as GameRenderState, U as GameTurnState, b7 as UIRootProps, bh as ZoneCardRenderItem, bl as ZoneListProps } from './ui-contract-GTUPkf8z.js';
+export { a as ClientParamSchemaMap, W as WorkspaceBoardSurface, b as WorkspaceBoardSurfaceDescriptor, c as WorkspaceBoardTargetInputSlot, d as WorkspaceCardCollectionSurface, e as WorkspaceCardCollectionSurfaceDescriptor, f as WorkspaceCardInputSlot, g as WorkspaceFormInputSlot, h as WorkspaceHandSurface, i as WorkspaceHandSurfaceDescriptor, j as WorkspaceInteractionFormDescriptor, k as WorkspaceInteractionFormsDescriptor, l as WorkspaceInteractionSlotComponent, m as WorkspacePileSurface, n as WorkspacePileSurfaceDescriptor, o as WorkspacePilesSurfaceDescriptor, p as WorkspaceSurfaceSpec, q as createWorkspaceUIContract } from './index-CcT9Q7N7.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
-import { c as RuntimeDiagnosticHandler } from './runtime-api-CgPuEVeF.js';
-import { P as PluginRuntimeClient, a as PluginRuntimeClientOptions, b as PluginTransport } from './types-q1Guidm5.js';
-export { R as RuntimeClock, c as RuntimeIdFactory } from './types-q1Guidm5.js';
-export { G as GameEvent, a as GameEventDetail, b as InteractionDescriptor, P as ProjectedGameEvent, S as SystemActionEvent } from './plugin-state-BRH3UiUp.js';
+import { f as RuntimeDiagnosticHandler } from './runtime-api-Bz5pwNU_.js';
+export { G as GameEvent, a as GameEventDetail, b as InteractionDescriptor, g as SystemActionEvent } from './runtime-api-Bz5pwNU_.js';
+import { P as PluginRuntimeClient, a as PluginRuntimeClientOptions, b as PluginTransport } from './types-DR7DoB1x.js';
+export { R as RuntimeClock, c as RuntimeIdFactory } from './types-DR7DoB1x.js';
 export { b as ResourceCounterComponents } from './ResourceCounter-BFxJknqp.js';
 import './hex-board-view-aKkblDp6.js';
 import './player-state-Cqpyeql0.js';
@@ -15,7 +15,7 @@ import './ThemeProvider-CElaL2ik.js';
 import './primitive-props-BNHDkgd7.js';
 import './attributes-DbvyMbXw.js';
 import './types-DJj5MJkl.js';
-import './protocol-CVaSqPgX.js';
+import './protocol-dYgafTYY.js';
 
 interface PluginRuntimeProps {
     /** Child components to render after gameplay frame has started */

package/dist/runtime.js

@@ -1,33 +1,35 @@
-import {
-  createWorkspaceUIContract
-} from "./chunk-KRJPRYEA.js";
-import "./chunk-VWTKGIYF.js";
-import "./chunk-6LMESVGT.js";
-import "./chunk-T3ZKNUZ7.js";
 import {
   PluginRuntimeBoundary,
   createPluginRuntimeClient
-} from "./chunk-N33CGX2F.js";
-import "./chunk-DQS2EG5E.js";
-import "./chunk-TXELBVTG.js";
-import "./chunk-FL67RDID.js";
-import "./chunk-LMHCGCA6.js";
+} from "./chunk-3BAD4VC2.js";
+import {
+  createWorkspaceUIContract
+} from "./chunk-EVCLTY4Q.js";
+import "./chunk-ANRB4XKA.js";
+import "./chunk-PN5O6GG2.js";
+import "./chunk-LR3ZTWQF.js";
+import "./chunk-T3ZKNUZ7.js";
+import "./chunk-GDPKTBUR.js";
+import "./chunk-3SKDNDPG.js";
 import {
   GameSkeleton
-} from "./chunk-VRRR6QZT.js";
+} from "./chunk-32PFKDV7.js";
 import "./chunk-VDXOF4FW.js";
 import "./chunk-WHR5UW3F.js";
-import "./chunk-PF7L4BMG.js";
 import {
   DREAMBOARD_SDK_VERSION
-} from "./chunk-ZSTCUJKZ.js";
-import "./chunk-KWHOFBDM.js";
+} from "./chunk-Y75CFE77.js";
 import {
   DREAMBOARD_PLUGIN_PROTOCOL,
   DREAMBOARD_PLUGIN_PROTOCOL_VERSION,
   HostToPluginEnvelopeSchema
-} from "./chunk-XFMSLL3P.js";
-import "./chunk-2GQIALJL.js";
+} from "./chunk-VCDWP5VL.js";
+import "./chunk-ZZGN2ATS.js";
+import "./chunk-H6VDGFL5.js";
+import "./chunk-5YV2WHJ4.js";
+import "./chunk-PF7L4BMG.js";
+import "./chunk-Z7QCREWI.js";
+import "./chunk-UGH54WZ2.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/runtime/hooks/usePluginRuntime.ts

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime/hooks/usePluginRuntime.ts","../src/runtime/browser/post-message-transport.ts","../src/runtime/components/PluginRuntime.tsx"],"sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport { DREAMBOARD_SDK_VERSION } from \"../../package-set.js\";\nimport { createPostMessagePluginTransport } from \"../browser/post-message-transport.js\";\nimport { createPluginRuntimeClient } from \"../core/create-plugin-runtime-client.js\";\nimport type { PluginRuntimeClient } from \"../core/types.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\n\nconst BUNDLED_SDK_VERSION = DREAMBOARD_SDK_VERSION;\n\nexport interface UsePluginRuntimeOptions {\n  /**\n   * Timeout in milliseconds to wait for the first gameplay frame.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\nexport interface UsePluginRuntimeResult {\n  /** The transport-agnostic plugin runtime client. */\n  runtime: PluginRuntimeClient;\n  /** Whether the initial reducer-native snapshot is available and ready */\n  isReady: boolean;\n  /**\n   * True when the plugin was ready before but the current snapshot has no\n   * projected view — e.g. you've acted and are waiting on the rest of the\n   * table in a simultaneous phase. Lets the loading affordance read as a\n   * mid-game wait rather than a cold \"still loading\" stall.\n   */\n  waiting: boolean;\n  /** Error message if initialization failed */\n  error: string | null;\n}\n\nfunction hasProjectedView(runtime: PluginRuntimeClient): boolean {\n  const frame = runtime.getFrame();\n  return (\n    frame !== null && frame.view !== null && typeof frame.view !== \"undefined\"\n  );\n}\n\n/**\n * Hook that creates and manages a PluginRuntimeClient instance.\n *\n * This hook handles:\n * 1. Creating the runtime client\n * 2. Waiting for the first gameplay frame before setting isReady\n *\n * In the new architecture, the host only renders the plugin when a reducer-native\n * snapshot is available, so isReady should become true quickly after init.\n *\n * @example\n * ```tsx\n * function PluginRuntime({ children }: { children: React.ReactNode }) {\n *   const { runtime, isReady, error } = usePluginRuntime();\n *\n *   if (error) {\n *     return <div>Error: {error}</div>;\n *   }\n *\n *   if (!isReady) {\n *     return <GameSkeleton message=\"Waiting for game state...\" />;\n *   }\n *\n *   return <RuntimeProvider runtime={runtime}>{children}</RuntimeProvider>;\n * }\n * ```\n */\nexport function usePluginRuntime(\n  options: UsePluginRuntimeOptions = {},\n): UsePluginRuntimeResult {\n  const { timeout = 10000, onDiagnostic } = options;\n  const [error, setError] = useState<string | null>(null);\n\n  // Create runtime once and keep stable reference\n  const [runtime] = useState<PluginRuntimeClient>(() =>\n    createPluginRuntimeClient({\n      transport: createPostMessagePluginTransport({\n        bundledSdkVersion: BUNDLED_SDK_VERSION,\n        onInvalidMessage: (reason, value) => {\n          const message =\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${BUNDLED_SDK_VERSION}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\";\n          setError(message);\n          onDiagnostic?.({\n            type: \"runtimeLog\",\n            level: \"warn\",\n            message,\n            details: [value],\n          });\n        },\n      }),\n    }),\n  );\n  const [isReady, setIsReady] = useState(() => hasProjectedView(runtime));\n  // Latches once we've shown a view, so a later view-less snapshot reads as a\n  // mid-game wait rather than a fresh load. (A ref, so it never re-triggers a\n  // render on its own.)\n  const hasBeenReadyRef = useRef(false);\n  if (isReady) hasBeenReadyRef.current = true;\n\n  useEffect(() => {\n    void onDiagnostic;\n  }, [onDiagnostic]);\n\n  // Subscribe to gameplay frames and set isReady when the first projected view arrives.\n  useEffect(() => {\n    const markReadyFromFrame = () => {\n      if (!hasProjectedView(runtime)) {\n        return false;\n      }\n      setError(null);\n      setIsReady(true);\n      return true;\n    };\n\n    if (markReadyFromFrame()) {\n      return;\n    }\n\n    // Set up timeout\n    const timeoutId = setTimeout(() => {\n      if (!markReadyFromFrame()) {\n        setError(\n          `Timed out waiting for the initial projected view after ${timeout}ms. ` +\n            \"Ensure the host sends a gameplay frame with a seat view.\",\n        );\n      }\n    }, timeout);\n\n    // Fallback poll for dev/HMR flows where the runtime frame may already\n    // exist but the first subscribe callback is missed.\n    const pollId = setInterval(() => {\n      if (markReadyFromFrame()) {\n        clearInterval(pollId);\n        clearTimeout(timeoutId);\n      }\n    }, 100);\n\n    const unsubscribe = runtime.subscribeFrame(() => {\n      if (!hasProjectedView(runtime)) {\n        setIsReady(false);\n        return;\n      }\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      setError(null);\n      setIsReady(true);\n    });\n\n    return () => {\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      unsubscribe?.();\n    };\n  }, [runtime, timeout]);\n\n  return {\n    runtime,\n    isReady,\n    waiting: hasBeenReadyRef.current && !isReady,\n    error,\n  };\n}\n","import {\n  DREAMBOARD_PLUGIN_PROTOCOL,\n  DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n  HostToPluginEnvelopeSchema,\n  type HostToPluginEnvelope,\n  type PluginToHostPayload,\n} from \"@dreamboard-games/plugin-runtime-contract\";\nimport type { PluginTransport } from \"../core/types.js\";\n\nexport interface PostMessagePluginTransportOptions {\n  readonly targetWindow?: Window;\n  readonly parentWindow?: Window;\n  readonly bundledSdkVersion?: string;\n  readonly onInvalidMessage?: (reason: string, value: unknown) => void;\n}\n\nexport function createPostMessagePluginTransport(\n  options: PostMessagePluginTransportOptions = {},\n): PluginTransport {\n  const targetWindow = options.targetWindow ?? window;\n  const parentWindow = options.parentWindow ?? targetWindow.parent;\n  const bundledSdkVersion = options.bundledSdkVersion?.trim() || \"unknown\";\n  let channel: {\n    readonly channelId: string;\n    readonly hostOrigin: string;\n    readonly hostWindow: Window;\n  } | null = null;\n  let outboundSequence = 0;\n  let invalidEnvelopeReported = false;\n\n  const reportInvalidEnvelope = (reason: string, value: unknown) => {\n    options.onInvalidMessage?.(reason, value);\n\n    if (!channel || invalidEnvelopeReported) {\n      return;\n    }\n\n    invalidEnvelopeReported = true;\n    channel.hostWindow.postMessage(\n      {\n        protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n        version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n        channelId: channel.channelId,\n        sequence: ++outboundSequence,\n        payload: {\n          type: \"runtime.error\",\n          code: \"host-runtime-protocol-mismatch\",\n          message:\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${bundledSdkVersion}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\",\n        },\n      },\n      channel.hostOrigin,\n    );\n  };\n\n  return {\n    start(onMessage) {\n      const handleMessage = (event: MessageEvent) => {\n        if (event.source !== parentWindow) {\n          return;\n        }\n        const parseResult = HostToPluginEnvelopeSchema.safeParse(event.data);\n        if (!parseResult.success) {\n          reportInvalidEnvelope(\"invalid-envelope\", event.data);\n          return;\n        }\n        const envelope = parseResult.data;\n        if (!channel) {\n          if (envelope.payload.type !== \"runtime.init\") {\n            return;\n          }\n          channel = {\n            channelId: envelope.channelId,\n            hostOrigin: event.origin,\n            hostWindow: event.source as Window,\n          };\n        }\n        if (\n          envelope.channelId !== channel.channelId ||\n          event.origin !== channel.hostOrigin ||\n          event.source !== channel.hostWindow\n        ) {\n          reportInvalidEnvelope(\"channel-mismatch\", event.data);\n          return;\n        }\n        onMessage(envelope as HostToPluginEnvelope);\n      };\n\n      targetWindow.addEventListener(\"message\", handleMessage);\n      return () => {\n        targetWindow.removeEventListener(\"message\", handleMessage);\n        channel = null;\n      };\n    },\n    send(payload: PluginToHostPayload) {\n      if (!channel) {\n        throw new Error(\"Plugin transport is not initialized.\");\n      }\n      channel.hostWindow.postMessage(\n        {\n          protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n          version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n          channelId: channel.channelId,\n          sequence: ++outboundSequence,\n          payload,\n        },\n        channel.hostOrigin,\n      );\n    },\n  };\n}\n","import React from \"react\";\nimport { usePluginRuntime } from \"../hooks/usePluginRuntime.js\";\nimport { GameSkeleton } from \"../../ui.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\nimport { PluginRuntimeBoundary } from \"./PluginRuntimeBoundary.js\";\n\nexport interface PluginRuntimeProps {\n  /** Child components to render after gameplay frame has started */\n  children: React.ReactNode;\n  /**\n   * Timeout in milliseconds to wait for the first gameplay-frame snapshot.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  /** Custom loading component to show while waiting for gameplay frame */\n  loadingComponent?: React.ReactNode;\n  /** Custom error component to show when initialization fails */\n  errorComponent?: (error: string) => React.ReactNode;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\n/**\n * PluginRuntime provides the RuntimeContext for plugin components.\n *\n * This component:\n * - Creates a transport-backed runtime client\n * - Waits for the first projected gameplay frame before rendering children\n * - Provides runtime commands plus session/frame state to all child components\n *\n * @example\n * ```tsx\n * // In your plugin's index.tsx\n * import { PluginRuntime } from \"./components/dreamboard\";\n * import App from './App';\n *\n * ReactDOM.createRoot(document.getElementById('root')!).render(\n *   <PluginRuntime>\n *     <App />\n *   </PluginRuntime>\n * );\n * ```\n */\nexport function PluginRuntime({\n  children,\n  timeout = 10000,\n  loadingComponent,\n  errorComponent,\n  onDiagnostic,\n}: PluginRuntimeProps) {\n  const { runtime, isReady, waiting, error } = usePluginRuntime({\n    timeout,\n    onDiagnostic,\n  });\n\n  if (error) {\n    if (errorComponent) {\n      return <>{errorComponent(error)}</>;\n    }\n    return (\n      <div className=\"flex h-full w-full items-center justify-center bg-gray-50\">\n        <div className=\"text-center p-6\">\n          <p className=\"text-red-600 font-medium mb-2\">Failed to load game</p>\n          <p className=\"text-gray-600 text-sm\">{error}</p>\n        </div>\n      </div>\n    );\n  }\n\n  if (!isReady) {\n    if (loadingComponent) {\n      return <>{loadingComponent}</>;\n    }\n    // Once the game has rendered, a view-less snapshot is a mid-game wait (you\n    // acted and are waiting on the table), not a cold load — say so rather than\n    // reading as a stalled \"Waiting for game state\".\n    return (\n      <GameSkeleton\n        message={\n          waiting\n            ? \"Waiting for the other players…\"\n            : \"Waiting for game state...\"\n        }\n      />\n    );\n  }\n\n  return (\n    <PluginRuntimeBoundary runtime={runtime}>{children}</PluginRuntimeBoundary>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/runtime/hooks/usePluginRuntime.ts","../src/runtime/browser/post-message-transport.ts","../src/runtime/components/PluginRuntime.tsx"],"sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport { DREAMBOARD_SDK_VERSION } from \"../../package-set.js\";\nimport { createPostMessagePluginTransport } from \"../browser/post-message-transport.js\";\nimport { createPluginRuntimeClient } from \"../core/create-plugin-runtime-client.js\";\nimport type { PluginRuntimeClient } from \"../core/types.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\n\nconst BUNDLED_SDK_VERSION = DREAMBOARD_SDK_VERSION;\n\nexport interface UsePluginRuntimeOptions {\n  /**\n   * Timeout in milliseconds to wait for the first gameplay frame.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\nexport interface UsePluginRuntimeResult {\n  /** The transport-agnostic plugin runtime client. */\n  runtime: PluginRuntimeClient;\n  /** Whether the initial reducer-native snapshot is available and ready */\n  isReady: boolean;\n  /**\n   * True when the plugin was ready before but the current snapshot has no\n   * projected view — e.g. you've acted and are waiting on the rest of the\n   * table in a simultaneous phase. Lets the loading affordance read as a\n   * mid-game wait rather than a cold \"still loading\" stall.\n   */\n  waiting: boolean;\n  /** Error message if initialization failed */\n  error: string | null;\n}\n\nfunction hasProjectedView(runtime: PluginRuntimeClient): boolean {\n  const frame = runtime.getFrame();\n  return (\n    frame !== null && frame.view !== null && typeof frame.view !== \"undefined\"\n  );\n}\n\n/**\n * Hook that creates and manages a PluginRuntimeClient instance.\n *\n * This hook handles:\n * 1. Creating the runtime client\n * 2. Waiting for the first gameplay frame before setting isReady\n *\n * In the new architecture, the host only renders the plugin when a reducer-native\n * snapshot is available, so isReady should become true quickly after init.\n *\n * @example\n * ```tsx\n * function PluginRuntime({ children }: { children: React.ReactNode }) {\n *   const { runtime, isReady, error } = usePluginRuntime();\n *\n *   if (error) {\n *     return <div>Error: {error}</div>;\n *   }\n *\n *   if (!isReady) {\n *     return <GameSkeleton message=\"Waiting for game state...\" />;\n *   }\n *\n *   return <RuntimeProvider runtime={runtime}>{children}</RuntimeProvider>;\n * }\n * ```\n */\nexport function usePluginRuntime(\n  options: UsePluginRuntimeOptions = {},\n): UsePluginRuntimeResult {\n  const { timeout = 10000, onDiagnostic } = options;\n  const [error, setError] = useState<string | null>(null);\n\n  // Create runtime once and keep stable reference\n  const [runtime] = useState<PluginRuntimeClient>(() =>\n    createPluginRuntimeClient({\n      transport: createPostMessagePluginTransport({\n        bundledSdkVersion: BUNDLED_SDK_VERSION,\n        onInvalidMessage: (reason, value) => {\n          const message =\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${BUNDLED_SDK_VERSION}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\";\n          setError(message);\n          onDiagnostic?.({\n            type: \"runtimeLog\",\n            level: \"warn\",\n            message,\n            details: [value],\n          });\n        },\n      }),\n    }),\n  );\n  const [isReady, setIsReady] = useState(() => hasProjectedView(runtime));\n  // Latches once we've shown a view, so a later view-less snapshot reads as a\n  // mid-game wait rather than a fresh load. (A ref, so it never re-triggers a\n  // render on its own.)\n  const hasBeenReadyRef = useRef(false);\n  if (isReady) hasBeenReadyRef.current = true;\n\n  useEffect(() => {\n    void onDiagnostic;\n  }, [onDiagnostic]);\n\n  // Subscribe to gameplay frames and set isReady when the first projected view arrives.\n  useEffect(() => {\n    const markReadyFromFrame = () => {\n      if (!hasProjectedView(runtime)) {\n        return false;\n      }\n      setError(null);\n      setIsReady(true);\n      return true;\n    };\n\n    if (markReadyFromFrame()) {\n      return;\n    }\n\n    // Set up timeout\n    const timeoutId = setTimeout(() => {\n      if (!markReadyFromFrame()) {\n        setError(\n          `Timed out waiting for the initial projected view after ${timeout}ms. ` +\n            \"Ensure the host sends a gameplay frame with a seat view.\",\n        );\n      }\n    }, timeout);\n\n    // Fallback poll for dev/HMR flows where the runtime frame may already\n    // exist but the first subscribe callback is missed.\n    const pollId = setInterval(() => {\n      if (markReadyFromFrame()) {\n        clearInterval(pollId);\n        clearTimeout(timeoutId);\n      }\n    }, 100);\n\n    const unsubscribe = runtime.subscribeFrame(() => {\n      if (!hasProjectedView(runtime)) {\n        setIsReady(false);\n        return;\n      }\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      setError(null);\n      setIsReady(true);\n    });\n\n    return () => {\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      unsubscribe?.();\n    };\n  }, [runtime, timeout]);\n\n  return {\n    runtime,\n    isReady,\n    waiting: hasBeenReadyRef.current && !isReady,\n    error,\n  };\n}\n","import {\n  DREAMBOARD_PLUGIN_PROTOCOL,\n  DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n  HostToPluginEnvelopeSchema,\n  type HostToPluginEnvelope,\n  type PluginToHostPayload,\n} from \"@dreamboard-games/plugin-runtime-contract\";\nimport type { PluginTransport } from \"../core/types.js\";\n\nexport interface PostMessagePluginTransportOptions {\n  readonly targetWindow?: Window;\n  readonly parentWindow?: Window;\n  readonly bundledSdkVersion?: string;\n  readonly onInvalidMessage?: (reason: string, value: unknown) => void;\n}\n\nexport function createPostMessagePluginTransport(\n  options: PostMessagePluginTransportOptions = {},\n): PluginTransport {\n  const targetWindow = options.targetWindow ?? window;\n  const parentWindow = options.parentWindow ?? targetWindow.parent;\n  const bundledSdkVersion = options.bundledSdkVersion?.trim() || \"unknown\";\n  let channel: {\n    readonly channelId: string;\n    readonly hostOrigin: string;\n    readonly hostWindow: Window;\n  } | null = null;\n  let outboundSequence = 0;\n  let invalidEnvelopeReported = false;\n\n  const reportInvalidEnvelope = (reason: string, value: unknown) => {\n    options.onInvalidMessage?.(reason, value);\n\n    if (!channel || invalidEnvelopeReported) {\n      return;\n    }\n\n    invalidEnvelopeReported = true;\n    channel.hostWindow.postMessage(\n      {\n        protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n        version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n        channelId: channel.channelId,\n        sequence: ++outboundSequence,\n        payload: {\n          type: \"runtime.error\",\n          code: \"host-runtime-protocol-mismatch\",\n          message:\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${bundledSdkVersion}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\",\n        },\n      },\n      channel.hostOrigin,\n    );\n  };\n\n  return {\n    start(onMessage) {\n      const handleMessage = (event: MessageEvent) => {\n        if (event.source !== parentWindow) {\n          return;\n        }\n        const parseResult = HostToPluginEnvelopeSchema.safeParse(event.data);\n        if (!parseResult.success) {\n          reportInvalidEnvelope(\"invalid-envelope\", event.data);\n          return;\n        }\n        const envelope = parseResult.data;\n        if (!channel) {\n          if (envelope.payload.type !== \"runtime.init\") {\n            return;\n          }\n          channel = {\n            channelId: envelope.channelId,\n            hostOrigin: event.origin,\n            hostWindow: event.source as Window,\n          };\n        }\n        if (\n          envelope.channelId !== channel.channelId ||\n          event.origin !== channel.hostOrigin ||\n          event.source !== channel.hostWindow\n        ) {\n          reportInvalidEnvelope(\"channel-mismatch\", event.data);\n          return;\n        }\n        onMessage(envelope as HostToPluginEnvelope);\n      };\n\n      targetWindow.addEventListener(\"message\", handleMessage);\n      return () => {\n        targetWindow.removeEventListener(\"message\", handleMessage);\n        channel = null;\n      };\n    },\n    send(payload: PluginToHostPayload) {\n      if (!channel) {\n        throw new Error(\"Plugin transport is not initialized.\");\n      }\n      channel.hostWindow.postMessage(\n        {\n          protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n          version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n          channelId: channel.channelId,\n          sequence: ++outboundSequence,\n          payload,\n        },\n        channel.hostOrigin,\n      );\n    },\n  };\n}\n","import React from \"react\";\nimport { usePluginRuntime } from \"../hooks/usePluginRuntime.js\";\nimport { GameSkeleton } from \"../../ui.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\nimport { PluginRuntimeBoundary } from \"./PluginRuntimeBoundary.js\";\n\nexport interface PluginRuntimeProps {\n  /** Child components to render after gameplay frame has started */\n  children: React.ReactNode;\n  /**\n   * Timeout in milliseconds to wait for the first gameplay-frame snapshot.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  /** Custom loading component to show while waiting for gameplay frame */\n  loadingComponent?: React.ReactNode;\n  /** Custom error component to show when initialization fails */\n  errorComponent?: (error: string) => React.ReactNode;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\n/**\n * PluginRuntime provides the RuntimeContext for plugin components.\n *\n * This component:\n * - Creates a transport-backed runtime client\n * - Waits for the first projected gameplay frame before rendering children\n * - Provides runtime commands plus session/frame state to all child components\n *\n * @example\n * ```tsx\n * // In your plugin's index.tsx\n * import { PluginRuntime } from \"./components/dreamboard\";\n * import App from './App';\n *\n * ReactDOM.createRoot(document.getElementById('root')!).render(\n *   <PluginRuntime>\n *     <App />\n *   </PluginRuntime>\n * );\n * ```\n */\nexport function PluginRuntime({\n  children,\n  timeout = 10000,\n  loadingComponent,\n  errorComponent,\n  onDiagnostic,\n}: PluginRuntimeProps) {\n  const { runtime, isReady, waiting, error } = usePluginRuntime({\n    timeout,\n    onDiagnostic,\n  });\n\n  if (error) {\n    if (errorComponent) {\n      return <>{errorComponent(error)}</>;\n    }\n    return (\n      <div className=\"flex h-full w-full items-center justify-center bg-gray-50\">\n        <div className=\"text-center p-6\">\n          <p className=\"text-red-600 font-medium mb-2\">Failed to load game</p>\n          <p className=\"text-gray-600 text-sm\">{error}</p>\n        </div>\n      </div>\n    );\n  }\n\n  if (!isReady) {\n    if (loadingComponent) {\n      return <>{loadingComponent}</>;\n    }\n    // Once the game has rendered, a view-less snapshot is a mid-game wait (you\n    // acted and are waiting on the table), not a cold load — say so rather than\n    // reading as a stalled \"Waiting for game state\".\n    return (\n      <GameSkeleton\n        message={\n          waiting\n            ? \"Waiting for the other players…\"\n            : \"Waiting for game state...\"\n        }\n      />\n    );\n  }\n\n  return (\n    <PluginRuntimeBoundary runtime={runtime}>{children}</PluginRuntimeBoundary>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/schema.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { N as RuntimeJson, x as PluginProtocolEnvelope, f as HostToPluginPayload, o as InteractionDescriptor, v as PluginGameplayFrame, B as PluginProtocolTape, Z as ZoneHandlesSnapshot, E as PluginSessionDescriptor, J as PluginToHostPayload } from './protocol-CVaSqPgX.js';
+import { M as RuntimeJson, x as PluginProtocolEnvelope, f as HostToPluginPayload, o as InteractionDescriptor, v as PluginGameplayFrame, B as PluginProtocolTape, Z as ZoneHandlesSnapshot, E as PluginSessionDescriptor, J as PluginToHostPayload } from './protocol-dYgafTYY.js';
 
 declare const RuntimeJsonSchema: z.ZodType<RuntimeJson>;
 declare const BoardStaticProjectionSchema: z.ZodObject<{
@@ -54,19 +54,6 @@ declare const GameEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
     }, z.core.$strict>>>;
 }, z.core.$strict>], "kind">;
-declare const ProjectedGameEventSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
-    kind: z.ZodLiteral<"systemAction">;
-    procedureId: z.ZodString;
-    title: z.ZodString;
-    summary: z.ZodOptional<z.ZodString>;
-    details: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
-    }, z.core.$strict>>>;
-}, z.core.$strict>], "kind">, z.ZodObject<{
-    version: z.ZodNumber;
-    index: z.ZodNumber;
-}, z.core.$strict>>;
 declare const SeatProjectionBundleSchema: z.ZodObject<{
     currentStage: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     stageSeats: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -98,19 +85,6 @@ declare const SeatProjectionBundleSchema: z.ZodObject<{
             }, z.core.$strict>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>>;
-    recentEvents: z.ZodOptional<z.ZodArray<z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"systemAction">;
-        procedureId: z.ZodString;
-        title: z.ZodString;
-        summary: z.ZodOptional<z.ZodString>;
-        details: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            label: z.ZodString;
-            value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
-        }, z.core.$strict>>>;
-    }, z.core.$strict>], "kind">, z.ZodObject<{
-        version: z.ZodNumber;
-        index: z.ZodNumber;
-    }, z.core.$strict>>>>;
     sharedView: z.ZodOptional<z.ZodUnknown>;
     interactionsByRef: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     seats: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -402,4 +376,4 @@ declare function parsePluginGameplayFrame(value: unknown): PluginGameplayFrame;
 declare function parseHostToPluginEnvelope(value: unknown): PluginProtocolEnvelope<HostToPluginPayload>;
 declare function parsePluginToHostEnvelope(value: unknown): PluginProtocolEnvelope<PluginToHostPayload>;
 
-export { BoardStaticProjectionSchema, GameEventDetailSchema, GameEventSchema, GameGuidanceProjectionSchema, GameOutcomeSchema, GameplayBasisSchema, HostToPluginEnvelopeSchema, HostToPluginPayloadSchema, InputDomainDependenciesSchema, InputDomainSchema, InputSelectionSchema, InteractionAvailabilitySchema, InteractionChoiceOptionSchema, InteractionCommitPolicySchema, InteractionContextSchema, InteractionDescriptorSchema, InteractionInputDescriptorSchema, InteractionResultSchema, PlayerIdSchema, PluginGameplayFrameSchema, PluginPlayerSummarySchema, PluginProtocolFrameSchema, PluginProtocolStepSchema, PluginProtocolTapeSchema, PluginSessionDescriptorSchema, PluginToHostEnvelopeSchema, PluginToHostPayloadSchema, ProjectedGameEventSchema, RuntimeJsonSchema, SeatProjectionBundleSchema, SetupGuidanceStepSchema, SimultaneousPhaseSnapshotSchema, SubmitInteractionCommandSchema, SystemActionEventSchema, ZoneHandlesSnapshotSchema, createPluginProtocolEnvelopeSchema, parseHostToPluginEnvelope, parsePluginGameplayFrame, parsePluginSessionDescriptor, parsePluginToHostEnvelope };
+export { BoardStaticProjectionSchema, GameEventDetailSchema, GameEventSchema, GameGuidanceProjectionSchema, GameOutcomeSchema, GameplayBasisSchema, HostToPluginEnvelopeSchema, HostToPluginPayloadSchema, InputDomainDependenciesSchema, InputDomainSchema, InputSelectionSchema, InteractionAvailabilitySchema, InteractionChoiceOptionSchema, InteractionCommitPolicySchema, InteractionContextSchema, InteractionDescriptorSchema, InteractionInputDescriptorSchema, InteractionResultSchema, PlayerIdSchema, PluginGameplayFrameSchema, PluginPlayerSummarySchema, PluginProtocolFrameSchema, PluginProtocolStepSchema, PluginProtocolTapeSchema, PluginSessionDescriptorSchema, PluginToHostEnvelopeSchema, PluginToHostPayloadSchema, RuntimeJsonSchema, SeatProjectionBundleSchema, SetupGuidanceStepSchema, SimultaneousPhaseSnapshotSchema, SubmitInteractionCommandSchema, SystemActionEventSchema, ZoneHandlesSnapshotSchema, createPluginProtocolEnvelopeSchema, parseHostToPluginEnvelope, parsePluginGameplayFrame, parsePluginSessionDescriptor, parsePluginToHostEnvelope };

package/dist/testing-compiler.d.ts

@@ -1,9 +1,9 @@
-import { j as ScenarioCheckpointSelector, o as ScenarioDefinitionGameLike, x as ScenarioReplayDefinition, h as ScenarioCheckpoint } from './definitions-bZSBaPjj.js';
+import { j as ScenarioCheckpointSelector, o as ScenarioDefinitionGameLike, x as ScenarioReplayDefinition, h as ScenarioCheckpoint } from './definitions-BgmV_GhC.js';
 import 'zod';
-import './views-D2Cfzr3h.js';
-import './runtime-C7Z2acNU.js';
+import './views-BpuWcOyN.js';
+import './runtime-RJ5orDJU.js';
 import './types.js';
-import './protocol-CVaSqPgX.js';
+import './protocol-dYgafTYY.js';
 import './diagnostics-DIi3ina7.js';
 
 type CompiledScenarioReplay<Game extends ScenarioDefinitionGameLike = ScenarioDefinitionGameLike> = {

package/dist/testing-runtime.d.ts

@@ -1,13 +1,13 @@
 import { D as DispatchTraceSummaryEntry } from './diagnostics-DIi3ina7.js';
-import { o as ScenarioDefinitionGameLike, n as ScenarioDefinition } from './definitions-bZSBaPjj.js';
-import { i as Sha256Digest, d as InspectNode } from './types-DN4O7kH_.js';
-export { h as ScenarioRuntimeCheckpointMaterialization, m as materializeScenarioRuntimeCheckpoint } from './types-DN4O7kH_.js';
+import { o as ScenarioDefinitionGameLike, n as ScenarioDefinition } from './definitions-BgmV_GhC.js';
+import { i as Sha256Digest, d as InspectNode } from './types-JWCYHmu7.js';
+export { h as ScenarioRuntimeCheckpointMaterialization, m as materializeScenarioRuntimeCheckpoint } from './types-JWCYHmu7.js';
 import 'zod';
-import './views-D2Cfzr3h.js';
-import './runtime-C7Z2acNU.js';
+import './views-BpuWcOyN.js';
+import './runtime-RJ5orDJU.js';
 import './types.js';
-import './protocol-CVaSqPgX.js';
-import './index.d-Bw8AOcgp.js';
+import './protocol-dYgafTYY.js';
+import './index.d-DjzoK7zn.js';
 
 type GameLike = {
     readonly phases: Readonly<Record<string, unknown>>;

package/dist/testing-runtime.js

@@ -5,15 +5,15 @@ import {
   materializeScenarioRuntimeCheckpoint,
   replayScenario,
   resolveScenarioCommandParams
-} from "./chunk-EOEA3I64.js";
+} from "./chunk-BI4G3PM2.js";
 import {
   interactionDomainEligibleCount
-} from "./chunk-533O7C4L.js";
-import "./chunk-TXELBVTG.js";
-import "./chunk-FL67RDID.js";
+} from "./chunk-S2JEDVWH.js";
+import "./chunk-PN5O6GG2.js";
+import "./chunk-VCDWP5VL.js";
+import "./chunk-H6VDGFL5.js";
 import "./chunk-PF7L4BMG.js";
-import "./chunk-XFMSLL3P.js";
-import "./chunk-2GQIALJL.js";
+import "./chunk-UGH54WZ2.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/testing/scenario-projection-digest.ts