@dreamboard-games/sdk 0.2.0

package/package.json

@@ -0,0 +1,199 @@
+{
+  "name": "@dreamboard-games/sdk",
+  "version": "0.2.0",
+  "description": "Dreamboard SDK package set metadata and public facade",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package-set": {
+      "bun": "./src/package-set.ts",
+      "types": "./dist/package-set.d.ts",
+      "import": "./dist/package-set.js",
+      "default": "./dist/package-set.js"
+    },
+    "./types": {
+      "bun": "./src/types.ts",
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
+    "./reducer": {
+      "bun": "./src/reducer.ts",
+      "types": "./dist/reducer.d.ts",
+      "import": "./dist/reducer.js",
+      "default": "./dist/reducer.js"
+    },
+    "./ui": {
+      "bun": "./src/ui.ts",
+      "types": "./dist/ui.d.ts",
+      "import": "./dist/ui.js",
+      "default": "./dist/ui.js"
+    },
+    "./ui/components": {
+      "bun": "./src/ui/components.ts",
+      "types": "./dist/ui/components.d.ts",
+      "import": "./dist/ui/components.js",
+      "default": "./dist/ui/components.js"
+    },
+    "./ui/defaults": {
+      "bun": "./src/ui/defaults.ts",
+      "types": "./dist/ui/defaults.d.ts",
+      "import": "./dist/ui/defaults.js",
+      "default": "./dist/ui/defaults.js"
+    },
+    "./ui/types/player-state": {
+      "bun": "./src/ui/types/player-state.ts",
+      "types": "./dist/ui/types/player-state.d.ts",
+      "import": "./dist/ui/types/player-state.js",
+      "default": "./dist/ui/types/player-state.js"
+    },
+    "./ui/plugin-styles.css": {
+      "default": "./dist/ui/plugin-styles.css"
+    },
+    "./runtime": {
+      "bun": "./src/runtime.ts",
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js",
+      "default": "./dist/runtime.js"
+    },
+    "./runtime/primitives": {
+      "bun": "./src/runtime/primitives.ts",
+      "types": "./dist/runtime/primitives.d.ts",
+      "import": "./dist/runtime/primitives.js",
+      "default": "./dist/runtime/primitives.js"
+    },
+    "./runtime/workspace-contract": {
+      "bun": "./src/runtime/workspace-contract.ts",
+      "types": "./dist/runtime/workspace-contract.d.ts",
+      "import": "./dist/runtime/workspace-contract.js",
+      "default": "./dist/runtime/workspace-contract.js"
+    },
+    "./runtime/types/runtime-api": {
+      "bun": "./src/runtime/types/runtime-api.ts",
+      "types": "./dist/runtime/types/runtime-api.d.ts",
+      "import": "./dist/runtime/types/runtime-api.js",
+      "default": "./dist/runtime/types/runtime-api.js"
+    },
+    "./generated/runtime": {
+      "bun": "./src/generated/runtime.ts",
+      "types": "./dist/generated/runtime.d.ts",
+      "import": "./dist/generated/runtime.js",
+      "default": "./dist/generated/runtime.js"
+    },
+    "./generated/runtime-api": {
+      "bun": "./src/generated/runtime-api.ts",
+      "types": "./dist/generated/runtime-api.d.ts",
+      "import": "./dist/generated/runtime-api.js",
+      "default": "./dist/generated/runtime-api.js"
+    },
+    "./generated/runtime/primitives": {
+      "bun": "./src/generated/runtime/primitives.ts",
+      "types": "./dist/generated/runtime/primitives.d.ts",
+      "import": "./dist/generated/runtime/primitives.js",
+      "default": "./dist/generated/runtime/primitives.js"
+    },
+    "./generated/workspace-contract": {
+      "bun": "./src/generated/workspace-contract.ts",
+      "types": "./dist/generated/workspace-contract.d.ts",
+      "import": "./dist/generated/workspace-contract.js",
+      "default": "./dist/generated/workspace-contract.js"
+    },
+    "./infrastructure/reducer-bundle-abi": {
+      "bun": "./src/infrastructure/reducer-bundle-abi.ts",
+      "types": "./dist/infrastructure/reducer-bundle-abi.d.ts",
+      "import": "./dist/infrastructure/reducer-bundle-abi.js",
+      "default": "./dist/infrastructure/reducer-bundle-abi.js"
+    },
+    "./infrastructure/workspace-codegen": {
+      "bun": "./src/infrastructure/workspace-codegen.ts",
+      "types": "./dist/infrastructure/workspace-codegen.d.ts",
+      "import": "./dist/infrastructure/workspace-codegen.js",
+      "default": "./dist/infrastructure/workspace-codegen.js"
+    },
+    "./testing": {
+      "bun": "./src/testing.ts",
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "default": "./dist/testing.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "LICENSE.md",
+    "dist",
+    "src",
+    "README.md",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__fixtures__/**",
+    "!src/**/*.stories.ts",
+    "!src/**/*.stories.tsx",
+    "!src/stories/**",
+    "!visual/**",
+    "!.turbo/**",
+    "!tsconfig.tsbuildinfo"
+  ],
+  "scripts": {
+    "build": "tsup && mkdir -p dist/ui && cp src/ui/plugin-styles.css dist/ui/plugin-styles.css",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint 'src/**/*.ts'",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@radix-ui/react-dialog": "^1.1.14",
+    "@radix-ui/react-accordion": "^1.2.12",
+    "@radix-ui/react-label": "^2.1.6",
+    "@radix-ui/react-select": "^2.2.5",
+    "@radix-ui/react-slot": "^1.1.2",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@use-gesture/react": "^10.3.1",
+    "clsx": "^2.1.1",
+    "framer-motion": "^11.15.0",
+    "lucide-react": "^0.562.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tailwindcss": "^4.1.5",
+    "vaul": "^1.1.2",
+    "zod": "4.4.3",
+    "zustand": "^5.0.4"
+  },
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^20.9.0",
+    "@types/node": "^24.5.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "eslint": "^9.39.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "framer-motion": "^11.0.0 || ^12.0.0",
+    "react": "^19.0.0",
+    "zod": "4.4.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dreamboard-games/dreamboard-sdk.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/dreamboard-games/dreamboard-sdk/issues"
+  },
+  "homepage": "https://github.com/dreamboard-games/dreamboard-sdk#readme",
+  "keywords": [
+    "dreamboard",
+    "sdk",
+    "package-set"
+  ],
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/src/generated/reducer-contract/builders.ts

@@ -0,0 +1,90 @@
+// @generated by packages/reducer-contract/scripts/generate-ts.mjs
+// DO NOT EDIT BY HAND. Edit schema/reducer-runtime.schema.json and rerun `pnpm generate`.
+
+/* eslint-disable */
+import type * as Wire from "./wire";
+
+/**
+ * Typed effect constructors. Authors MUST go through these; hand-constructing
+ * Wire.Effect objects is banned by convention because it's how wire drift
+ * re-enters the codebase.
+ *
+ * The `effectId` is minted by the runtime (see createEffectIdMinter below),
+ * not by the author. Each builder returns a `PendingEffect` that carries
+ * the optional continuation; the reducer bundle's accept materializer splits
+ * pending effects into the wire's `effects[]` + `continuations` map.
+ */
+
+export type PendingEffect = Wire.Effect & {
+  readonly __continuation?: Wire.ContinuationToken;
+};
+
+export type EffectIdMinter = () => Wire.EffectId;
+
+/**
+ * Produces sequential, deterministic effect ids scoped to a single accept
+ * payload: "ef0", "ef1", ... . Uniqueness only needs to be local to the
+ * payload because the host consumes and discards them per dispatch.
+ */
+export function createEffectIdMinter(): EffectIdMinter {
+  let i = 0;
+  return () => `ef${i++}` as Wire.EffectId;
+}
+
+export type EffectBuilders = {
+  transition(args: { to: string }, continuation?: Wire.ContinuationToken): PendingEffect;
+  rollDie(args: { dieId: string }, continuation?: Wire.ContinuationToken): PendingEffect;
+  shuffleSharedZone(args: { zoneId: string }, continuation?: Wire.ContinuationToken): PendingEffect;
+  shufflePlayerZone(args: { zoneId: string; playerId: string }, continuation?: Wire.ContinuationToken): PendingEffect;
+};
+
+export function createEffectBuilders(mint: EffectIdMinter): EffectBuilders {
+  return {
+    transition(args, continuation) {
+      const effect = { effectId: mint(), type: "transition" as const, to: args.to };
+      return continuation === undefined
+        ? (effect as PendingEffect)
+        : Object.assign(effect, { __continuation: continuation });
+    },
+    rollDie(args, continuation) {
+      const effect = { effectId: mint(), type: "rollDie" as const, dieId: args.dieId };
+      return continuation === undefined
+        ? (effect as PendingEffect)
+        : Object.assign(effect, { __continuation: continuation });
+    },
+    shuffleSharedZone(args, continuation) {
+      const effect = { effectId: mint(), type: "shuffleSharedZone" as const, zoneId: args.zoneId };
+      return continuation === undefined
+        ? (effect as PendingEffect)
+        : Object.assign(effect, { __continuation: continuation });
+    },
+    shufflePlayerZone(args, continuation) {
+      const effect = { effectId: mint(), type: "shufflePlayerZone" as const, zoneId: args.zoneId, playerId: args.playerId };
+      return continuation === undefined
+        ? (effect as PendingEffect)
+        : Object.assign(effect, { __continuation: continuation });
+    },
+  };
+}
+
+/**
+ * Takes a list of PendingEffects and splits them into the canonical wire
+ * shape: `effects[]` (stripped of `__continuation`) + `continuations` map
+ * keyed by effectId. Use at the boundary where reduce/dispatch results leave
+ * author code and enter the wire.
+ */
+export function materializeAccept(pending: ReadonlyArray<PendingEffect>): {
+  effects: Wire.Effect[];
+  continuations: Wire.ContinuationMap;
+} {
+  const effects: Wire.Effect[] = [];
+  const continuations: Wire.ContinuationMap = {};
+  for (const pe of pending) {
+    const { __continuation, ...effect } = pe as PendingEffect & { __continuation?: Wire.ContinuationToken };
+    effects.push(effect as Wire.Effect);
+    if (__continuation !== undefined) {
+      continuations[(effect as Wire.Effect).effectId] = __continuation;
+    }
+  }
+  return { effects, continuations };
+}

package/src/generated/reducer-contract/version.ts

@@ -0,0 +1,9 @@
+// @generated by packages/reducer-contract/scripts/generate-ts.mjs
+// DO NOT EDIT BY HAND. Edit schema/reducer-runtime.schema.json and rerun `pnpm generate`.
+
+/**
+ * The wire-protocol version this package implements. Bumped in lockstep with
+ * any breaking change to schema/reducer-runtime.schema.json. At bundle load
+ * time hosts refuse bundles whose major version differs.
+ */
+export const REDUCER_CONTRACT_VERSION = "0.2.0" as const;

package/src/generated/reducer-contract/wire.ts

@@ -0,0 +1,100 @@
+// @generated by packages/reducer-contract/scripts/generate-ts.mjs
+// DO NOT EDIT BY HAND. Edit schema/reducer-runtime.schema.json and rerun `pnpm generate`.
+
+/* eslint-disable */
+
+export type ReducerContractVersion = string;
+
+export type EffectId = string;
+
+export type ContinuationToken = { "id": string; "data": JsonValue };
+
+export type ContinuationMap = Record<string, ContinuationToken>;
+
+export type JsonValue = Record<string, unknown> | Array<unknown> | string | number | boolean | null;
+
+export type ReducerSetupSelection = { "profileId": string; "optionValues": Record<string, string | null> };
+
+export type RngState = { "seed": number | null; "cursor": number; "trace": Array<string> };
+
+export type ReducerFlowState = { "currentPhase": string; "turn": number; "round": number; "activePlayers": Array<string> };
+
+export type RuntimeSimultaneousSubmission = { "interactionId": string; "params": JsonValue };
+
+export type RuntimeSimultaneousCurrent = { "phaseName": string; "actors": Array<string>; "submissions": Record<string, RuntimeSimultaneousSubmission> };
+
+export type RuntimeSimultaneousState = { "current": RuntimeSimultaneousCurrent | null };
+
+export type TransitionRecord = { "from": string; "to": string };
+
+export type ReducerRuntimeState = { "rng": RngState; "setup": ReducerSetupSelection | null; "simultaneous": RuntimeSimultaneousState; "lastTransition": TransitionRecord | null };
+
+export type ReducerDomainState = { "table": JsonValue; "publicState": JsonValue; "privateState": Record<string, JsonValue>; "hiddenState": JsonValue; "flow": ReducerFlowState; "phase": JsonValue };
+
+export type ReducerSessionState = { "domain": ReducerDomainState; "runtime": ReducerRuntimeState };
+
+export type GameInput = GameInputInteraction;
+
+export type GameInputInteraction = { "kind": "interaction"; "playerId": string; "interactionId": string; "params": JsonValue };
+
+export type Effect = EffectTransition | EffectRollDie | EffectShuffleSharedZone | EffectShufflePlayerZone;
+
+export type EffectTransition = { "effectId": EffectId; "type": "transition"; "to": string };
+
+export type EffectRollDie = { "effectId": EffectId; "type": "rollDie"; "dieId": string };
+
+export type EffectShuffleSharedZone = { "effectId": EffectId; "type": "shuffleSharedZone"; "zoneId": string };
+
+export type EffectShufflePlayerZone = { "effectId": EffectId; "type": "shufflePlayerZone"; "zoneId": string; "playerId": string };
+
+export type ReducerInputValidationResult = { "valid": boolean; "errorCode"?: string; "message"?: string };
+
+export type InitializeRequest = { "table": JsonValue; "playerIds": Array<string>; "rngSeed"?: number | null; "setup"?: ReducerSetupSelection | null };
+
+export type InitializePhaseRequest = { "state": ReducerSessionState; "to": string };
+
+export type ValidateInputRequest = { "state": ReducerSessionState; "input": GameInput };
+
+export type ReduceRequest = { "state": ReducerSessionState; "input": GameInput };
+
+export type DispatchRequest = { "state": ReducerSessionState; "input": GameInput };
+
+export type ReduceResult = ReduceResultReject | ReduceResultAccept;
+
+export type ReduceResultReject = { "kind": "reject"; "errorCode": string; "message"?: string };
+
+export type ReduceResultAccept = { "kind": "accept"; "state": ReducerSessionState; "effects": Array<Effect>; "continuations": ContinuationMap };
+
+export type DispatchTrace = DispatchTraceAcceptedClientInput | DispatchTraceAppliedEffect | DispatchTraceRngConsumption;
+
+export type DispatchTraceAcceptedClientInput = { "kind": "acceptedClientInput"; "input": GameInput };
+
+export type DispatchTraceAppliedEffect = { "kind": "appliedEffect"; "effect": Effect; "continuation"?: ContinuationToken };
+
+export type DispatchTraceRngConsumption = { "kind": "rngConsumption"; "operation": string; "traceEntry": string };
+
+export type DispatchResult = DispatchResultReject | DispatchResultAccept;
+
+export type DispatchResultReject = { "kind": "reject"; "errorCode": string; "message"?: string };
+
+export type DispatchResultAccept = { "kind": "accept"; "state": ReducerSessionState; "trace": Array<DispatchTrace> };
+
+export type ReducerRuntimeLogEntry = ReducerRuntimeLogEntryAcceptedClientInput | ReducerRuntimeLogEntryAppliedEffect | ReducerRuntimeLogEntryRngConsumption | ReducerRuntimeLogEntryStateCommit;
+
+export type ReducerRuntimeLogEntryAcceptedClientInput = { "kind": "acceptedClientInput"; "version": number; "input": GameInput };
+
+export type ReducerRuntimeLogEntryAppliedEffect = { "kind": "appliedEffect"; "version": number; "effect": Effect; "continuation": ContinuationToken | null };
+
+export type ReducerRuntimeLogEntryRngConsumption = { "kind": "rngConsumption"; "version": number; "operation": string; "traceEntry": string };
+
+export type ReducerRuntimeLogEntryStateCommit = { "kind": "stateCommit"; "version": number; "state": ReducerSessionState };
+
+export type SeatProjection = { "view"?: JsonValue; "availableInteractionRefs"?: JsonValue; "zones"?: JsonValue };
+
+export type SimultaneousPhaseProjection = { "phaseName": string; "interactionId": string; "actorIds": Array<string>; "sealedPlayerIds": Array<string>; "pendingPlayerIds": Array<string> };
+
+export type SeatProjectionBundle = { "currentStage"?: string | null; "stageSeats"?: Array<string>; "simultaneousPhase"?: SimultaneousPhaseProjection | null; "interactionsByRef"?: JsonValue; "seats": Record<string, SeatProjection> };
+
+export type ProjectSeatsDynamicRequest = { "state": ReducerSessionState; "playerIds": Array<string>; "viewId"?: string; "projectionMode"?: "full" | "actionsOnly" | null };
+
+export type BoardStaticProjection = { "view": JsonValue; "hash": string; "manifestVersion": string };

package/src/generated/reducer-contract/zod.ts

@@ -0,0 +1,101 @@
+// @generated by packages/reducer-contract/scripts/generate-ts.mjs
+// DO NOT EDIT BY HAND. Edit schema/reducer-runtime.schema.json and rerun `pnpm generate`.
+
+/* eslint-disable */
+import { z } from "zod";
+
+export const ReducerContractVersionSchema = z.string().regex(new RegExp("^[0-9]+\\.[0-9]+\\.[0-9]+$"));
+
+export const EffectIdSchema = z.string().min(1);
+
+export const JsonValueSchema = z.union([z.record(z.string(), z.unknown()), z.array(z.unknown()), z.string(), z.number(), z.boolean(), z.null()]);
+
+export const ContinuationTokenSchema = z.object({ "id": z.string().min(1), "data": JsonValueSchema }).strict();
+
+export const ContinuationMapSchema = z.record(z.string(), ContinuationTokenSchema);
+
+export const ReducerSetupSelectionSchema = z.object({ "profileId": z.string().min(1), "optionValues": z.record(z.string(), z.union([z.string(), z.null()])) }).strict();
+
+export const RngStateSchema = z.object({ "seed": z.union([z.number().refine(Number.isInteger, { message: "Expected integer" }), z.null()]), "cursor": z.number().int(), "trace": z.array(z.string()) }).strict();
+
+export const ReducerFlowStateSchema = z.object({ "currentPhase": z.string().min(1), "turn": z.number().int(), "round": z.number().int(), "activePlayers": z.array(z.string().min(1)) }).strict();
+
+export const RuntimeSimultaneousSubmissionSchema = z.object({ "interactionId": z.string().min(1), "params": JsonValueSchema }).strict();
+
+export const RuntimeSimultaneousCurrentSchema = z.object({ "phaseName": z.string().min(1), "actors": z.array(z.string().min(1)), "submissions": z.record(z.string(), RuntimeSimultaneousSubmissionSchema) }).strict();
+
+export const RuntimeSimultaneousStateSchema = z.object({ "current": z.union([RuntimeSimultaneousCurrentSchema, z.null()]) }).strict();
+
+export const TransitionRecordSchema = z.object({ "from": z.string().min(1), "to": z.string().min(1) }).strict();
+
+export const ReducerRuntimeStateSchema = z.object({ "rng": RngStateSchema, "setup": z.union([ReducerSetupSelectionSchema, z.null()]), "simultaneous": RuntimeSimultaneousStateSchema, "lastTransition": z.union([TransitionRecordSchema, z.null()]) }).strict();
+
+export const ReducerDomainStateSchema = z.object({ "table": JsonValueSchema, "publicState": JsonValueSchema, "privateState": z.record(z.string(), JsonValueSchema), "hiddenState": JsonValueSchema, "flow": ReducerFlowStateSchema, "phase": JsonValueSchema }).strict();
+
+export const ReducerSessionStateSchema = z.object({ "domain": ReducerDomainStateSchema, "runtime": ReducerRuntimeStateSchema }).strict();
+
+export const GameInputInteractionSchema = z.object({ "kind": z.literal("interaction"), "playerId": z.string().min(1), "interactionId": z.string().min(1), "params": JsonValueSchema }).strict();
+
+export const GameInputSchema = z.discriminatedUnion("kind", [GameInputInteractionSchema]);
+
+export const EffectTransitionSchema = z.object({ "effectId": EffectIdSchema, "type": z.literal("transition"), "to": z.string().min(1) }).strict();
+
+export const EffectRollDieSchema = z.object({ "effectId": EffectIdSchema, "type": z.literal("rollDie"), "dieId": z.string().min(1) }).strict();
+
+export const EffectShuffleSharedZoneSchema = z.object({ "effectId": EffectIdSchema, "type": z.literal("shuffleSharedZone"), "zoneId": z.string().min(1) }).strict();
+
+export const EffectShufflePlayerZoneSchema = z.object({ "effectId": EffectIdSchema, "type": z.literal("shufflePlayerZone"), "zoneId": z.string().min(1), "playerId": z.string().min(1) }).strict();
+
+export const EffectSchema = z.discriminatedUnion("type", [EffectTransitionSchema, EffectRollDieSchema, EffectShuffleSharedZoneSchema, EffectShufflePlayerZoneSchema]);
+
+export const ReducerInputValidationResultSchema = z.object({ "valid": z.boolean(), "errorCode": z.string().optional(), "message": z.string().optional() }).strict();
+
+export const InitializeRequestSchema = z.object({ "table": JsonValueSchema, "playerIds": z.array(z.string().min(1)), "rngSeed": z.union([z.number().refine(Number.isInteger, { message: "Expected integer" }), z.null()]).optional(), "setup": z.union([ReducerSetupSelectionSchema, z.null()]).optional() }).strict();
+
+export const InitializePhaseRequestSchema = z.object({ "state": ReducerSessionStateSchema, "to": z.string().min(1) }).strict();
+
+export const ValidateInputRequestSchema = z.object({ "state": ReducerSessionStateSchema, "input": GameInputSchema }).strict();
+
+export const ReduceRequestSchema = z.object({ "state": ReducerSessionStateSchema, "input": GameInputSchema }).strict();
+
+export const DispatchRequestSchema = z.object({ "state": ReducerSessionStateSchema, "input": GameInputSchema }).strict();
+
+export const ReduceResultRejectSchema = z.object({ "kind": z.literal("reject"), "errorCode": z.string().min(1), "message": z.string().optional() }).strict();
+
+export const ReduceResultAcceptSchema = z.object({ "kind": z.literal("accept"), "state": ReducerSessionStateSchema, "effects": z.array(EffectSchema), "continuations": ContinuationMapSchema }).strict();
+
+export const ReduceResultSchema = z.discriminatedUnion("kind", [ReduceResultRejectSchema, ReduceResultAcceptSchema]);
+
+export const DispatchTraceAcceptedClientInputSchema = z.object({ "kind": z.literal("acceptedClientInput"), "input": GameInputSchema }).strict();
+
+export const DispatchTraceAppliedEffectSchema = z.object({ "kind": z.literal("appliedEffect"), "effect": EffectSchema, "continuation": ContinuationTokenSchema.optional() }).strict();
+
+export const DispatchTraceRngConsumptionSchema = z.object({ "kind": z.literal("rngConsumption"), "operation": z.string().min(1), "traceEntry": z.string() }).strict();
+
+export const DispatchTraceSchema = z.discriminatedUnion("kind", [DispatchTraceAcceptedClientInputSchema, DispatchTraceAppliedEffectSchema, DispatchTraceRngConsumptionSchema]);
+
+export const DispatchResultRejectSchema = z.object({ "kind": z.literal("reject"), "errorCode": z.string().min(1), "message": z.string().optional() }).strict();
+
+export const DispatchResultAcceptSchema = z.object({ "kind": z.literal("accept"), "state": ReducerSessionStateSchema, "trace": z.array(DispatchTraceSchema) }).strict();
+
+export const DispatchResultSchema = z.discriminatedUnion("kind", [DispatchResultRejectSchema, DispatchResultAcceptSchema]);
+
+export const ReducerRuntimeLogEntryAcceptedClientInputSchema = z.object({ "kind": z.literal("acceptedClientInput"), "version": z.number().int(), "input": GameInputSchema }).strict();
+
+export const ReducerRuntimeLogEntryAppliedEffectSchema = z.object({ "kind": z.literal("appliedEffect"), "version": z.number().int(), "effect": EffectSchema, "continuation": z.union([ContinuationTokenSchema, z.null()]) }).strict();
+
+export const ReducerRuntimeLogEntryRngConsumptionSchema = z.object({ "kind": z.literal("rngConsumption"), "version": z.number().int(), "operation": z.string().min(1), "traceEntry": z.string() }).strict();
+
+export const ReducerRuntimeLogEntryStateCommitSchema = z.object({ "kind": z.literal("stateCommit"), "version": z.number().int(), "state": ReducerSessionStateSchema }).strict();
+
+export const ReducerRuntimeLogEntrySchema = z.discriminatedUnion("kind", [ReducerRuntimeLogEntryAcceptedClientInputSchema, ReducerRuntimeLogEntryAppliedEffectSchema, ReducerRuntimeLogEntryRngConsumptionSchema, ReducerRuntimeLogEntryStateCommitSchema]);
+
+export const SeatProjectionSchema = z.object({ "view": JsonValueSchema.optional(), "availableInteractionRefs": JsonValueSchema.optional(), "zones": JsonValueSchema.optional() }).strict();
+
+export const SimultaneousPhaseProjectionSchema = z.object({ "phaseName": z.string().min(1), "interactionId": z.string().min(1), "actorIds": z.array(z.string().min(1)), "sealedPlayerIds": z.array(z.string().min(1)), "pendingPlayerIds": z.array(z.string().min(1)) }).strict();
+
+export const SeatProjectionBundleSchema = z.object({ "currentStage": z.union([z.string().min(1), z.null()]).optional(), "stageSeats": z.array(z.string().min(1)).optional(), "simultaneousPhase": z.union([SimultaneousPhaseProjectionSchema, z.null()]).optional(), "interactionsByRef": JsonValueSchema.optional(), "seats": z.record(z.string(), SeatProjectionSchema) }).strict();
+
+export const ProjectSeatsDynamicRequestSchema = z.object({ "state": ReducerSessionStateSchema, "playerIds": z.array(z.string().min(1)), "viewId": z.string().min(1).optional(), "projectionMode": z.union([z.enum(["full", "actionsOnly"]), z.null()]).optional() }).strict();
+
+export const BoardStaticProjectionSchema = z.object({ "view": JsonValueSchema, "hash": z.string().min(1), "manifestVersion": z.string() }).strict();

package/src/generated/runtime/primitives.ts

@@ -0,0 +1,2 @@
+export * from "../../runtime/primitives.js";
+

package/src/generated/runtime-api.ts

@@ -0,0 +1,5 @@
+export * from "../runtime/types/runtime-api.js";
+export type {
+  PluginStateSnapshot,
+  ZoneHandlesSnapshot,
+} from "../runtime-internal/types/plugin-state.js";

package/src/generated/runtime.ts

@@ -0,0 +1,35 @@
+export * from "../runtime.js";
+export { createWorkspaceUIContract } from "../runtime/workspace-contract.js";
+export type {
+  BoardHexGridProps,
+  BoardHexViewProps,
+  BoardSpaceTargetProps,
+  ClientParamSchemaMap,
+  DreamboardUI,
+  GameMeState,
+  GamePlayersState,
+  GameRenderState,
+  GameTurnState,
+  ResourceCounterComponents,
+  TypedGame,
+  UIContract,
+  UIRootProps,
+  WorkspaceBoardSurface,
+  WorkspaceBoardSurfaceDescriptor,
+  WorkspaceBoardTargetInputSlot,
+  WorkspaceCardCollectionSurface,
+  WorkspaceCardCollectionSurfaceDescriptor,
+  WorkspaceCardInputSlot,
+  WorkspaceFormInputSlot,
+  WorkspaceHandSurface,
+  WorkspaceHandSurfaceDescriptor,
+  WorkspaceInteractionFormDescriptor,
+  WorkspaceInteractionFormsDescriptor,
+  WorkspaceInteractionSlotComponent,
+  WorkspacePileSurface,
+  WorkspacePileSurfaceDescriptor,
+  WorkspacePilesSurfaceDescriptor,
+  WorkspaceSurfaceSpec,
+  ZoneCardRenderItem,
+  ZoneListProps,
+} from "../runtime/workspace-contract.js";

package/src/generated/workspace-contract.ts

@@ -0,0 +1,2 @@
+export * from "../runtime/workspace-contract.js";
+

package/src/index.ts

@@ -0,0 +1,7 @@
+export {
+  DREAMBOARD_SDK_PACKAGE_SET,
+  DREAMBOARD_SDK_PACKAGES,
+  DREAMBOARD_SDK_VERSION,
+  type DreamboardSdkPackageName,
+  type DreamboardSdkPackageSet,
+} from "./package-set.js";

package/src/infrastructure/reducer-bundle-abi.ts

@@ -0,0 +1,8 @@
+export { REDUCER_CONTRACT_VERSION } from "../generated/reducer-contract/version.js";
+export type {
+  MaybePromise,
+  ReducerBundleContract,
+} from "./reducer-contract/bundle.js";
+export { materializeManifestTable } from "./workspace-codegen/index.js";
+export type * as ReducerWire from "../generated/reducer-contract/wire.js";
+export * as ReducerWireZod from "../generated/reducer-contract/zod.js";

package/src/infrastructure/reducer-contract/bundle.ts

@@ -0,0 +1,37 @@
+// @generated by packages/reducer-contract/scripts/generate-ts.mjs
+// DO NOT EDIT BY HAND. Edit schema/reducer-runtime.operations.json and rerun `pnpm generate`.
+
+/* eslint-disable */
+import type * as Wire from "../../generated/reducer-contract/wire";
+
+export type MaybePromise<T> = T | Promise<T>;
+
+/**
+ * Canonical erased reducer boundary for `createReducerBundle(...)`.
+ *
+ * The callable method list is generated from
+ * `schema/reducer-runtime.operations.json`; payload DTOs come from
+ * `schema/reducer-runtime.schema.json`.
+ *
+ * This interface models the host/guest surface only. The concrete
+ * authored bundle stays strongly typed in `@dreamboard-games/sdk/reducer`, but every
+ * cross-runtime caller should agree on this shape.
+ */
+export interface ReducerBundleContract {
+  readonly reducerContractVersion: Wire.ReducerContractVersion;
+  initialize(
+    input: Wire.InitializeRequest,
+  ): MaybePromise<Wire.ReducerSessionState>;
+  initializePhase(
+    input: Wire.InitializePhaseRequest,
+  ): MaybePromise<Wire.ReducerSessionState>;
+  validateInput(
+    input: Wire.ValidateInputRequest,
+  ): MaybePromise<Wire.ReducerInputValidationResult>;
+  reduce(input: Wire.ReduceRequest): MaybePromise<Wire.ReduceResult>;
+  dispatch(input: Wire.DispatchRequest): MaybePromise<Wire.DispatchResult>;
+  projectStatic(): Wire.BoardStaticProjection | null;
+  projectSeatsDynamic(
+    input: Wire.ProjectSeatsDynamicRequest,
+  ): Wire.SeatProjectionBundle;
+}