@dreamboard-games/cli 0.1.30-alpha.0

package/dist/testing-KLSV6CPJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../node_modules/.pnpm/@dreamboard-games+sdk@0.4.0-alpha.0_@types+react-dom@19.2.3_@types+react@19.2.17__@type_b74cbe125b074769500a56e94fa7f664/node_modules/@dreamboard-games/sdk/src/testing/definitions.ts","../../../node_modules/.pnpm/@dreamboard-games+sdk@0.4.0-alpha.0_@types+react-dom@19.2.3_@types+react@19.2.17__@type_b74cbe125b074769500a56e94fa7f664/node_modules/@dreamboard-games/sdk/src/testing/create-expect-api.ts","../../../node_modules/.pnpm/@dreamboard-games+sdk@0.4.0-alpha.0_@types+react-dom@19.2.3_@types+react@19.2.17__@type_b74cbe125b074769500a56e94fa7f664/node_modules/@dreamboard-games/sdk/src/testing/create-test-runtime.ts"],"sourcesContent":["import type {\n  DispatchTraceSummaryEntry,\n  ReducerDiagnosticEvent,\n} from \"../reducer/diagnostics.js\";\n\nexport type TestRunner = \"reducer\" | \"remote\" | \"browser\";\n\nexport type InteractionDescriptorLike = {\n  interactionId?: string;\n  surface?: string;\n  kind?: string;\n  availability?: InteractionAvailabilityLike;\n  context?: {\n    to?: string;\n  };\n} & Record<string, unknown>;\n\nexport type InteractionAvailabilityLike =\n  | { status: \"available\" }\n  | { status: \"notYourTurn\"; reason: string }\n  | {\n      status: \"insufficientResources\";\n      reason: string;\n      missingResources?: Record<string, unknown>;\n    }\n  | { status: \"blocked\"; reason: string };\n\nexport type InteractionExplanationLike = {\n  interactionId: string;\n  phase: string;\n  step: string | null;\n  availability:\n    | \"available\"\n    | \"notYourTurn\"\n    | \"wrongPhase\"\n    | \"wrongStep\"\n    | \"blocked\";\n  rules: ReadonlyArray<{\n    ruleId: string;\n    outcome: \"passed\" | \"failed\" | \"notEvaluated\";\n    errorCode?: string;\n    message?: string;\n  }>;\n  actor: { required: readonly string[]; playerIsActor: boolean };\n  inputs: ReadonlyArray<{\n    key: string;\n    kind: string;\n    eligibleCount: number | \"lazy\";\n  }>;\n};\n\nexport type SnapshotMatcherHandler = (\n  name: string | undefined,\n  actual: unknown,\n) => void;\n\nexport type RejectionExpectation = {\n  errorCode?: string;\n  message?: string | RegExp;\n};\n\nexport type ExpectMatchers = {\n  toBe: (expected: unknown) => void;\n  toEqual: (expected: unknown) => void;\n  toMatchObject: (expected: Record<string, unknown>) => void;\n  toBeDefined: () => void;\n  toBeUndefined: () => void;\n  toBeNull: () => void;\n  toContain: (expected: unknown) => void;\n  toContainEqual: (expected: unknown) => void;\n  toHaveLength: (expected: number) => void;\n  toBeGreaterThan: (expected: number) => void;\n  toBeGreaterThanOrEqual: (expected: number) => void;\n  toThrow: (predicate?: string | RegExp | ((error: Error) => boolean)) => void;\n  toMatchSnapshot: (filename?: string) => void;\n  toRejectWith: (expected: RejectionExpectation) => Promise<void>;\n  toHaveInteraction: (\n    interactionId: string,\n    opts?: Partial<InteractionDescriptorLike>,\n  ) => void;\n  toBeGatedBy: (reason: string, opts?: { interactionId?: string }) => void;\n  toBeAvailable: (explanation?: InteractionExplanationLike) => void;\n  toBeActiveFor: (playerId: string, opts?: { interactionId?: string }) => void;\n  not: {\n    toHaveInteraction: (interactionId: string) => void;\n  };\n};\n\nexport type ExpectFn = (actual: unknown) => ExpectMatchers;\n\nexport interface BaseContext<PlayerId extends string = string> {\n  game: {\n    start(): Promise<void>;\n    patchState?(\n      mutator: (state: Record<string, unknown>) => void,\n    ): Promise<void>;\n    submit(\n      playerId: PlayerId,\n      interactionId: string,\n      params?: unknown,\n    ): Promise<void>;\n  };\n  players(): readonly PlayerId[];\n  seat(index: number): PlayerId;\n}\n\nexport interface SharedScenarioContext<\n  PlayerId extends string = string,\n  StateName extends string = string,\n  View = unknown,\n  Descriptor extends InteractionDescriptorLike = InteractionDescriptorLike,\n> extends BaseContext<PlayerId> {\n  state(): StateName;\n  view(playerId: PlayerId): View;\n  interactions(playerId: PlayerId): readonly Descriptor[];\n  explain(\n    playerId: PlayerId,\n    interactionId: string,\n  ): InteractionExplanationLike;\n  diagnostics: {\n    readonly events: readonly ReducerDiagnosticEvent[];\n    readonly lastDispatch: {\n      submissionId: string;\n      trace: readonly DispatchTraceSummaryEntry[];\n    } | null;\n    clear(): void;\n  };\n  expect: ExpectFn;\n}\n\nexport interface BaseDefinition {\n  id: string;\n  seed?: number;\n  players?: number;\n  setupProfileId?: string | null;\n  extends?: string;\n  setup: (ctx: BaseContext) => void | Promise<void>;\n}\n\nexport interface ScenarioDefinition<\n  Runners extends readonly TestRunner[] = readonly [\"reducer\"],\n  PhaseName extends string = string,\n  StageName extends string = string,\n> {\n  id: string;\n  description?: string;\n  from: string;\n  runners?: Runners;\n  phase?: PhaseName;\n  stage?: StageName;\n  when: (ctx: SharedScenarioContext) => void | Promise<void>;\n  then: (ctx: SharedScenarioContext) => void | Promise<void>;\n}\n\nexport function defineBase<const Definition extends BaseDefinition>(\n  definition: Definition,\n): Definition {\n  return definition;\n}\n\nexport function defineScenario<\n  const Runners extends readonly TestRunner[] = readonly [\"reducer\"],\n  const PhaseName extends string = string,\n  const StageName extends string = string,\n>(\n  definition: ScenarioDefinition<Runners, PhaseName, StageName>,\n): ScenarioDefinition<Runners, PhaseName, StageName> {\n  return definition;\n}\n","import { isDeepStrictEqual } from \"node:util\";\nimport type {\n  ExpectFn,\n  ExpectMatchers,\n  InteractionDescriptorLike,\n  RejectionExpectation,\n  InteractionExplanationLike,\n  SnapshotMatcherHandler,\n} from \"./definitions.js\";\nimport type { ReducerDiagnosticEvent } from \"../reducer/diagnostics.js\";\n\ntype CreateExpectApiOptions = {\n  matchSnapshot?: SnapshotMatcherHandler;\n  lastDiagnosticRejection?: () =>\n    | Extract<ReducerDiagnosticEvent, { type: \"submitRejected\" }>\n    | null\n    | undefined;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction matchPartial(\n  actual: unknown,\n  expected: unknown,\n  path: string = \"value\",\n): string | null {\n  if (!isRecord(expected)) {\n    return isDeepStrictEqual(actual, expected)\n      ? null\n      : `${path} does not match`;\n  }\n  if (!isRecord(actual)) {\n    return `${path} is not an object`;\n  }\n  for (const [key, expectedValue] of Object.entries(expected)) {\n    const actualValue = actual[key];\n    if (!(key in actual)) {\n      return `${path}.${key} is missing`;\n    }\n    const mismatch = matchPartial(actualValue, expectedValue, `${path}.${key}`);\n    if (mismatch) {\n      return mismatch;\n    }\n  }\n  return null;\n}\n\nfunction asDescriptorList(actual: unknown): InteractionDescriptorLike[] {\n  if (!Array.isArray(actual)) {\n    throw new Error(\"Expected interaction descriptor array.\");\n  }\n  return actual as InteractionDescriptorLike[];\n}\n\nfunction findInteraction(\n  descriptors: readonly InteractionDescriptorLike[],\n  interactionId: string,\n): InteractionDescriptorLike | null {\n  return (\n    descriptors.find(\n      (descriptor) => descriptor.interactionId === interactionId,\n    ) ?? null\n  );\n}\n\nfunction assertDescriptorMatches(\n  descriptor: InteractionDescriptorLike,\n  opts: Partial<InteractionDescriptorLike> | undefined,\n): void {\n  if (!opts) {\n    return;\n  }\n  const mismatch = matchPartial(descriptor, opts, \"interaction\");\n  if (mismatch) {\n    throw new Error(mismatch);\n  }\n}\n\nfunction createSubmissionErrorMatcher(\n  actual: unknown,\n  expected: RejectionExpectation,\n  options: CreateExpectApiOptions,\n): Promise<void> {\n  const resolvePromise = (): Promise<unknown> => {\n    if (typeof actual === \"function\") {\n      return Promise.resolve().then(() => (actual as () => unknown)());\n    }\n    return Promise.resolve(actual);\n  };\n\n  return resolvePromise()\n    .then(() => {\n      throw new Error(\"Expected promise to reject.\");\n    })\n    .catch((error: unknown) => {\n      if (!(error instanceof Error)) {\n        throw new Error(\"Expected rejection to be an Error.\");\n      }\n      if (\n        expected.errorCode !== undefined &&\n        (error as Error & { errorCode?: string }).errorCode !==\n          expected.errorCode\n      ) {\n        throw new Error(\n          `Expected rejection errorCode '${expected.errorCode}', received '${\n            (error as Error & { errorCode?: string }).errorCode ?? \"undefined\"\n          }'.${formatLastDiagnosticRejection(options)}`,\n        );\n      }\n      if (\n        typeof expected.message === \"string\" &&\n        error.message !== expected.message\n      ) {\n        throw new Error(\n          `Expected rejection message '${expected.message}', received '${error.message}'.${formatLastDiagnosticRejection(\n            options,\n          )}`,\n        );\n      }\n      if (\n        expected.message instanceof RegExp &&\n        !expected.message.test(error.message)\n      ) {\n        throw new Error(\n          `Expected rejection message '${error.message}' to match ${String(\n            expected.message,\n          )}.${formatLastDiagnosticRejection(options)}`,\n        );\n      }\n    });\n}\n\nfunction formatLastDiagnosticRejection(\n  options: CreateExpectApiOptions,\n): string {\n  const rejection = options.lastDiagnosticRejection?.();\n  if (!rejection) return \"\";\n  const rule = rejection.ruleId ? ` ruleId=${rejection.ruleId}` : \"\";\n  const message = rejection.message ? ` message=${rejection.message}` : \"\";\n  return `\\nlast rejection: errorCode=${rejection.errorCode}${rule}${message}`;\n}\n\nfunction assertLength(actual: unknown, expected: number): void {\n  if (\n    actual === null ||\n    actual === undefined ||\n    typeof (actual as { length?: unknown }).length !== \"number\"\n  ) {\n    throw new Error(\"toHaveLength expects a value with a numeric length.\");\n  }\n  const length = (actual as { length: number }).length;\n  if (length !== expected) {\n    throw new Error(`Expected length ${expected}, received ${length}.`);\n  }\n}\n\nfunction formatInteractionExplanation(\n  explanation: InteractionExplanationLike | undefined,\n): string {\n  if (!explanation) {\n    return \"\";\n  }\n  const lines = [\n    `availability: ${explanation.availability}`,\n    ...explanation.rules.map((rule) => {\n      const code = rule.errorCode ? ` (${rule.errorCode})` : \"\";\n      const message = rule.message ? `: ${rule.message}` : \"\";\n      return `rule ${rule.ruleId} ${rule.outcome}${code}${message}`;\n    }),\n    ...explanation.inputs.map(\n      (input) => `input ${input.key} eligibleCount=${input.eligibleCount}`,\n    ),\n  ];\n  return `\\n${lines.join(\"\\n\")}`;\n}\n\nfunction assertThrown(\n  actual: unknown,\n  predicate?: string | RegExp | ((error: Error) => boolean),\n): void {\n  if (typeof actual !== \"function\") {\n    throw new Error(\"toThrow expects a function.\");\n  }\n  try {\n    (actual as () => unknown)();\n  } catch (error) {\n    if (!(error instanceof Error)) {\n      throw new Error(\"Thrown value is not an Error.\");\n    }\n    if (predicate === undefined) {\n      return;\n    }\n    if (typeof predicate === \"string\" && error.message !== predicate) {\n      throw new Error(\n        `Expected thrown message '${predicate}', received '${error.message}'.`,\n      );\n    }\n    if (predicate instanceof RegExp && !predicate.test(error.message)) {\n      throw new Error(\n        `Expected thrown message '${error.message}' to match ${String(predicate)}.`,\n      );\n    }\n    if (typeof predicate === \"function\" && !predicate(error)) {\n      throw new Error(\"Thrown error did not satisfy predicate.\");\n    }\n    return;\n  }\n  throw new Error(\"Expected function to throw.\");\n}\n\nexport function createExpectApi(\n  options: CreateExpectApiOptions = {},\n): ExpectFn {\n  const buildMatchers = (actual: unknown): ExpectMatchers => ({\n    toBe: (expected: unknown) => {\n      if (actual !== expected) {\n        throw new Error(\n          `Expected '${String(actual)}' to be '${String(expected)}'.`,\n        );\n      }\n    },\n    toEqual: (expected: unknown) => {\n      if (!isDeepStrictEqual(actual, expected)) {\n        throw new Error(\"Expected values to be deeply equal.\");\n      }\n    },\n    toMatchObject: (expected: Record<string, unknown>) => {\n      const mismatch = matchPartial(actual, expected);\n      if (mismatch) {\n        throw new Error(mismatch);\n      }\n    },\n    toBeDefined: () => {\n      if (actual === undefined) {\n        throw new Error(\"Expected value to be defined.\");\n      }\n    },\n    toBeUndefined: () => {\n      if (actual !== undefined) {\n        throw new Error(\n          `Expected value to be undefined, but received '${String(actual)}'.`,\n        );\n      }\n    },\n    toBeNull: () => {\n      if (actual !== null) {\n        throw new Error(\n          `Expected value to be null, but received '${String(actual)}'.`,\n        );\n      }\n    },\n    toContain: (expected: unknown) => {\n      if (Array.isArray(actual)) {\n        if (!actual.includes(expected)) {\n          throw new Error(\"Expected array to contain value.\");\n        }\n        return;\n      }\n      if (typeof actual === \"string\") {\n        if (!actual.includes(String(expected))) {\n          throw new Error(\"Expected string to contain value.\");\n        }\n        return;\n      }\n      throw new Error(\"toContain expects an array or string actual value.\");\n    },\n    toContainEqual: (expected: unknown) => {\n      if (!Array.isArray(actual)) {\n        throw new Error(\"toContainEqual expects an array actual value.\");\n      }\n      if (!actual.some((value) => isDeepStrictEqual(value, expected))) {\n        throw new Error(\"Expected array to contain an equal value.\");\n      }\n    },\n    toHaveLength: (expected: number) => {\n      assertLength(actual, expected);\n    },\n    toBeGreaterThan: (expected: number) => {\n      if (typeof actual !== \"number\") {\n        throw new Error(\"toBeGreaterThan expects a number actual value.\");\n      }\n      if (actual <= expected) {\n        throw new Error(`Expected ${actual} to be > ${expected}.`);\n      }\n    },\n    toBeGreaterThanOrEqual: (expected: number) => {\n      if (typeof actual !== \"number\") {\n        throw new Error(\n          \"toBeGreaterThanOrEqual expects a number actual value.\",\n        );\n      }\n      if (actual < expected) {\n        throw new Error(`Expected ${actual} to be >= ${expected}.`);\n      }\n    },\n    toThrow: (predicate) => {\n      assertThrown(actual, predicate);\n    },\n    toMatchSnapshot: (filename) => {\n      if (!options.matchSnapshot) {\n        throw new Error(\n          \"Snapshot matching is not configured for this expect API.\",\n        );\n      }\n      options.matchSnapshot(filename, actual);\n    },\n    toRejectWith: (expected) =>\n      createSubmissionErrorMatcher(actual, expected, options),\n    toHaveInteraction: (interactionId, opts) => {\n      const descriptors = asDescriptorList(actual);\n      const descriptor = findInteraction(descriptors, interactionId);\n      if (!descriptor) {\n        throw new Error(`Expected interaction '${interactionId}' to exist.`);\n      }\n      assertDescriptorMatches(descriptor, opts);\n    },\n    toBeGatedBy: (reason, opts) => {\n      const descriptor = Array.isArray(actual)\n        ? (() => {\n            if (!opts?.interactionId) {\n              throw new Error(\n                \"toBeGatedBy on a descriptor array requires opts.interactionId.\",\n              );\n            }\n            return findInteraction(\n              asDescriptorList(actual),\n              opts.interactionId,\n            );\n          })()\n        : (actual as InteractionDescriptorLike | null);\n      if (!descriptor) {\n        throw new Error(\"Expected interaction descriptor to exist.\");\n      }\n      if (descriptor.availability?.status === \"available\") {\n        throw new Error(\"Expected interaction to be unavailable.\");\n      }\n      const actualReason =\n        descriptor.availability?.status === \"notYourTurn\" ||\n        descriptor.availability?.status === \"insufficientResources\" ||\n        descriptor.availability?.status === \"blocked\"\n          ? descriptor.availability.reason\n          : undefined;\n      if (actualReason !== reason) {\n        throw new Error(\n          `Expected unavailable reason '${reason}', received '${\n            actualReason ?? \"undefined\"\n          }'.`,\n        );\n      }\n    },\n    toBeAvailable: (explanation) => {\n      const descriptor = Array.isArray(actual)\n        ? (() => {\n            if (!explanation?.interactionId) {\n              throw new Error(\n                \"toBeAvailable on a descriptor array requires an explanation.\",\n              );\n            }\n            return findInteraction(\n              asDescriptorList(actual),\n              explanation.interactionId,\n            );\n          })()\n        : (actual as InteractionDescriptorLike | null);\n      if (!descriptor) {\n        throw new Error(\n          `Expected interaction descriptor to exist.${formatInteractionExplanation(\n            explanation,\n          )}`,\n        );\n      }\n      if (descriptor.availability?.status !== \"available\") {\n        throw new Error(\n          `Expected interaction '${descriptor.interactionId ?? \"unknown\"}' to be available.${formatInteractionExplanation(\n            explanation,\n          )}`,\n        );\n      }\n    },\n    toBeActiveFor: (playerId, opts) => {\n      const descriptor = Array.isArray(actual)\n        ? (() => {\n            if (!opts?.interactionId) {\n              throw new Error(\n                \"toBeActiveFor on a descriptor array requires opts.interactionId.\",\n              );\n            }\n            return findInteraction(\n              asDescriptorList(actual),\n              opts.interactionId,\n            );\n          })()\n        : (actual as InteractionDescriptorLike | null);\n      if (!descriptor) {\n        throw new Error(\"Expected interaction descriptor to exist.\");\n      }\n      if (descriptor.context?.to !== playerId) {\n        throw new Error(\n          `Expected interaction to target '${playerId}', received '${\n            descriptor.context?.to ?? \"undefined\"\n          }'.`,\n        );\n      }\n      if (descriptor.availability?.status !== \"available\") {\n        throw new Error(\"Expected interaction to be available.\");\n      }\n    },\n    not: {\n      toHaveInteraction: (interactionId) => {\n        const descriptors = asDescriptorList(actual);\n        if (findInteraction(descriptors, interactionId)) {\n          throw new Error(\n            `Expected interaction '${interactionId}' to be absent.`,\n          );\n        }\n      },\n    },\n  });\n\n  return (actual: unknown) => buildMatchers(actual);\n}\n","import type {\n  ReducerBundleContract,\n  Wire,\n} from \"@dreamboard-games/reducer-contract\";\nimport type {\n  InteractionDescriptor,\n  PluginStateSnapshot,\n  ZoneHandlesSnapshot,\n} from \"../runtime/reducer.js\";\nimport type {\n  RuntimeAPI,\n  SubmissionError,\n  ValidationResult,\n} from \"../runtime/types/runtime-api.js\";\nimport type { PluginSessionState as RuntimePluginSessionState } from \"../runtime/types/runtime-api.js\";\nimport type {\n  DispatchTraceSummaryEntry,\n  ReducerDiagnosticEvent,\n} from \"../reducer/diagnostics.js\";\nimport { StaleContractArtifactError } from \"../reducer/stale-contract-artifact-error.js\";\nimport type { InteractionExplanationLike } from \"./definitions.js\";\n\ntype ReducerBundleLike = Pick<\n  ReducerBundleContract,\n  \"projectSeatsDynamic\" | \"validateInput\" | \"dispatch\"\n> & {\n  explainInteraction?: (input: {\n    state: Wire.ReducerSessionState;\n    playerId: string;\n    interactionId: string;\n  }) => InteractionExplanationLike;\n};\n\ntype DeepReadonly<T> = T extends (...args: readonly unknown[]) => unknown\n  ? T\n  : T extends readonly (infer Item)[]\n    ? readonly DeepReadonly<Item>[]\n    : T extends object\n      ? { readonly [Key in keyof T]: DeepReadonly<T[Key]> }\n      : T;\n\ntype DeepMutable<T> = T extends (...args: readonly unknown[]) => unknown\n  ? T\n  : T extends readonly (infer Item)[]\n    ? DeepMutable<Item>[]\n    : T extends object\n      ? { -readonly [Key in keyof T]: DeepMutable<T[Key]> }\n      : T;\n\ntype BaseStateArtifact = {\n  snapshot: DeepReadonly<Wire.ReducerSessionState>;\n  fingerprint: {\n    players: number;\n    contractFingerprint?: string;\n  };\n};\n\ntype WireZoneHandles = {\n  cardIds?: readonly string[];\n  cardViewsById?: Readonly<Record<string, string>>;\n  playableByCardId?: Readonly<Record<string, readonly string[]>>;\n};\n\nexport type CreateTestRuntimeOptions = {\n  baseId: string;\n  baseStates: Record<string, BaseStateArtifact>;\n  bundle: ReducerBundleLike;\n  phase?: string;\n  playerIds?: readonly string[];\n  sessionId?: string;\n  userId?: string | null;\n  gameId?: string;\n  displayNameByPlayerId?: Record<string, string>;\n  contractFingerprint?: string;\n  expectedBaseStateFingerprint?: string;\n};\n\nexport type CreatedTestRuntime = {\n  runtime: RuntimeAPI & {\n    getSnapshot(): PluginStateSnapshot;\n    subscribeToState(\n      listener: (state: PluginStateSnapshot) => void,\n    ): () => void;\n    _subscribeToSessionState(\n      listener: (state: RuntimePluginSessionState) => void,\n    ): () => void;\n  };\n  getSnapshot(): PluginStateSnapshot;\n  players(): readonly string[];\n  seat(index: number): string;\n  submit(\n    playerId: string,\n    interactionId: string,\n    params?: unknown,\n  ): Promise<void>;\n  validate(\n    playerId: string,\n    interactionId: string,\n    params?: unknown,\n  ): Promise<ValidationResult>;\n  explain(playerId: string, interactionId: string): InteractionExplanationLike;\n  diagnostics: {\n    readonly events: readonly ReducerDiagnosticEvent[];\n    readonly lastDispatch: {\n      submissionId: string;\n      trace: readonly DispatchTraceSummaryEntry[];\n    } | null;\n    clear(): void;\n  };\n  setControllingPlayer(playerId: string): void;\n};\n\nfunction cloneState<T>(value: T): DeepMutable<T> {\n  return structuredClone(value) as DeepMutable<T>;\n}\n\nfunction createSubmissionError(\n  errorCode: string | undefined,\n  message: string | undefined,\n): SubmissionError {\n  const error = new Error(message ?? \"Interaction rejected\") as SubmissionError;\n  error.name = \"SubmissionError\";\n  error.errorCode = errorCode;\n  return error;\n}\n\nfunction summarizeWireTrace(\n  trace: readonly unknown[] | undefined,\n): DispatchTraceSummaryEntry[] {\n  return (trace ?? []).flatMap((entry): DispatchTraceSummaryEntry[] => {\n    if (typeof entry !== \"object\" || entry === null) return [];\n    const record = entry as Record<string, unknown>;\n    switch (record.kind) {\n      case \"acceptedClientInput\": {\n        const input =\n          typeof record.input === \"object\" && record.input !== null\n            ? (record.input as Record<string, unknown>)\n            : {};\n        return [\n          {\n            kind: \"acceptedClientInput\",\n            interactionId: String(input.interactionId ?? \"\"),\n            playerId: String(input.playerId ?? \"\"),\n          },\n        ];\n      }\n      case \"appliedEffect\": {\n        const effect =\n          typeof record.effect === \"object\" && record.effect !== null\n            ? (record.effect as Record<string, unknown>)\n            : {};\n        return [\n          {\n            kind: \"appliedInstruction\",\n            instruction: String(effect.kind ?? effect.type ?? \"effect\"),\n          },\n        ];\n      }\n      case \"rngConsumption\":\n        return [\n          {\n            kind: \"rngConsumption\",\n            operation: String(record.operation ?? \"\"),\n            traceEntry: String(record.traceEntry ?? \"\"),\n          },\n        ];\n      default:\n        return [];\n    }\n  });\n}\n\nfunction readFlowState(state: Wire.ReducerSessionState): {\n  currentPhase: string | null;\n  activePlayers: string[];\n} {\n  const flow = ((\n    state.domain as\n      | { flow?: { currentPhase?: string; activePlayers?: string[] } }\n      | undefined\n  )?.flow ?? {}) as {\n    currentPhase?: string;\n    activePlayers?: string[];\n  };\n  return {\n    currentPhase: flow.currentPhase ?? null,\n    activePlayers: Array.isArray(flow.activePlayers) ? flow.activePlayers : [],\n  };\n}\n\nfunction resolvePlayerIds(options: {\n  baseState: BaseStateArtifact;\n  explicitPlayerIds?: readonly string[];\n}): string[] {\n  if (options.explicitPlayerIds && options.explicitPlayerIds.length > 0) {\n    return [...options.explicitPlayerIds];\n  }\n  return Array.from(\n    { length: options.baseState.fingerprint.players },\n    (_, index) => `player-${index + 1}`,\n  );\n}\n\nfunction isWireZoneHandles(value: unknown): value is WireZoneHandles {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction buildPluginSnapshot(options: {\n  state: Wire.ReducerSessionState;\n  bundle: ReducerBundleLike;\n  playerId: string;\n  playerIds: readonly string[];\n  userId: string | null;\n  sessionId: string;\n  version: number;\n  expectedPhase: string | undefined;\n  baseId: string;\n}): PluginStateSnapshot {\n  const projection = options.bundle.projectSeatsDynamic({\n    state: options.state,\n    playerIds: [options.playerId],\n  });\n\n  const flow = readFlowState(options.state);\n  if (options.expectedPhase && flow.currentPhase !== options.expectedPhase) {\n    throw new Error(\n      `Expected base '${options.baseId}' to be in phase '${options.expectedPhase}', received '${\n        flow.currentPhase ?? \"null\"\n      }'.`,\n    );\n  }\n\n  const interactionsByRef =\n    (projection.interactionsByRef as\n      | Record<string, InteractionDescriptor>\n      | undefined) ?? {};\n  const hydrateRefs = (\n    refs: readonly string[] | undefined,\n  ): InteractionDescriptor[] =>\n    (refs ?? [])\n      .map((ref) => interactionsByRef[ref])\n      .filter((descriptor): descriptor is InteractionDescriptor =>\n        Boolean(descriptor),\n      );\n\n  const seat = projection.seats?.[options.playerId];\n  const zones = Object.fromEntries(\n    Object.entries(\n      (seat?.zones as Record<string, unknown> | undefined) ?? {},\n    ).map(([zoneId, zoneValue]) => {\n      const zone = isWireZoneHandles(zoneValue) ? zoneValue : {};\n      return [\n        zoneId,\n        {\n          cardIds: [...(zone.cardIds ?? [])],\n          cardViewsById: { ...(zone.cardViewsById ?? {}) },\n          playableByCardId: Object.fromEntries(\n            Object.entries(zone.playableByCardId ?? {}).map(\n              ([cardId, refs]) => [cardId, hydrateRefs(refs)],\n            ),\n          ),\n        } satisfies ZoneHandlesSnapshot,\n      ];\n    }),\n  );\n\n  return {\n    view: (seat?.view ?? null) as PluginStateSnapshot[\"view\"],\n    gameplay: {\n      currentPhase: flow.currentPhase,\n      currentStage: projection.currentStage ?? null,\n      activePlayers: flow.activePlayers,\n      simultaneousPhase: projection.simultaneousPhase ?? null,\n      availableInteractions: hydrateRefs(\n        seat?.availableInteractionRefs as readonly string[] | undefined,\n      ),\n      zones,\n    },\n    lobby: null,\n    notifications: [],\n    session: {\n      sessionId: options.sessionId,\n      controllablePlayerIds: [...options.playerIds],\n      controllingPlayerId: options.playerId || null,\n      userId: options.userId,\n    },\n    history: null,\n    syncId: options.version,\n  };\n}\n\nexport function createTestRuntime(\n  options: CreateTestRuntimeOptions,\n): CreatedTestRuntime {\n  const baseState = options.baseStates[options.baseId];\n  if (!baseState) {\n    throw new Error(`Unknown test base '${options.baseId}'.`);\n  }\n  const expectedBaseStateFingerprint =\n    options.expectedBaseStateFingerprint ??\n    baseState.fingerprint.contractFingerprint;\n  if (\n    options.contractFingerprint &&\n    expectedBaseStateFingerprint &&\n    options.contractFingerprint !== expectedBaseStateFingerprint\n  ) {\n    throw new StaleContractArtifactError({\n      artifact: \"base-states\",\n      expected: options.contractFingerprint,\n      found: expectedBaseStateFingerprint,\n    });\n  }\n\n  let currentState = cloneState(baseState.snapshot);\n  const playerIds = resolvePlayerIds({\n    baseState,\n    explicitPlayerIds: options.playerIds,\n  });\n  const userId = options.userId ?? \"test-user\";\n  const sessionId = options.sessionId ?? \"test-session\";\n\n  let version = 0;\n  let submissionCounter = 0;\n  let currentPlayerId = playerIds[0] ?? \"\";\n  const diagnosticEvents: ReducerDiagnosticEvent[] = [];\n  let lastDispatch: {\n    submissionId: string;\n    trace: readonly DispatchTraceSummaryEntry[];\n  } | null = null;\n  const stateListeners = new Set<(state: PluginStateSnapshot) => void>();\n  const sessionListeners = new Set<\n    (state: RuntimePluginSessionState) => void\n  >();\n\n  const toReadySessionState = (\n    snapshot: PluginStateSnapshot,\n  ): RuntimePluginSessionState => ({\n    ...snapshot.session,\n    status: \"ready\",\n  });\n\n  let lastPluginSnapshot: PluginStateSnapshot;\n  let lastSessionState: RuntimePluginSessionState;\n\n  const applyCurrentState = (): void => {\n    const previousSession = lastSessionState;\n    version += 1;\n    lastPluginSnapshot = buildPluginSnapshot({\n      state: currentState,\n      bundle: options.bundle,\n      playerId: currentPlayerId,\n      playerIds,\n      userId,\n      sessionId,\n      version,\n      expectedPhase: version === 1 ? options.phase : undefined,\n      baseId: options.baseId,\n    });\n    lastSessionState = toReadySessionState(lastPluginSnapshot);\n\n    for (const listener of stateListeners) {\n      listener(lastPluginSnapshot);\n    }\n\n    if (\n      !previousSession ||\n      previousSession.controllingPlayerId !==\n        lastSessionState.controllingPlayerId ||\n      previousSession.controllablePlayerIds.join(\"\\0\") !==\n        lastSessionState.controllablePlayerIds.join(\"\\0\")\n    ) {\n      for (const listener of sessionListeners) {\n        listener(lastSessionState);\n      }\n    }\n  };\n\n  applyCurrentState();\n\n  const validate = async (\n    playerId: string,\n    interactionId: string,\n    params: unknown = {},\n  ): Promise<ValidationResult> => {\n    const result = await options.bundle.validateInput({\n      state: currentState,\n      input: {\n        kind: \"interaction\",\n        playerId,\n        interactionId,\n        params: params as Wire.JsonValue,\n      },\n    });\n    return {\n      valid: result.valid,\n      errorCode: result.errorCode,\n      message: result.message,\n    };\n  };\n\n  const submit = async (\n    playerId: string,\n    interactionId: string,\n    params: unknown = {},\n  ): Promise<void> => {\n    submissionCounter += 1;\n    const submissionId = `sub-${submissionCounter}`;\n    diagnosticEvents.push({\n      type: \"submitReceived\",\n      submissionId,\n      playerId,\n      interactionId,\n      phase: readFlowState(currentState).currentPhase ?? \"\",\n    });\n    const validation = await validate(playerId, interactionId, params);\n    if (!validation.valid) {\n      diagnosticEvents.push({\n        type: \"submitRejected\",\n        submissionId,\n        errorCode: validation.errorCode ?? \"invalid-action\",\n        ...(validation.message ? { message: validation.message } : {}),\n      });\n      throw createSubmissionError(validation.errorCode, validation.message);\n    }\n    const result = await options.bundle.dispatch({\n      state: currentState,\n      input: {\n        kind: \"interaction\",\n        playerId,\n        interactionId,\n        params: params as Wire.JsonValue,\n      },\n    });\n    if (result.kind === \"reject\") {\n      diagnosticEvents.push({\n        type: \"submitRejected\",\n        submissionId,\n        errorCode: result.errorCode,\n        ...(result.message ? { message: result.message } : {}),\n      });\n      throw createSubmissionError(result.errorCode, result.message);\n    }\n    const trace = summarizeWireTrace(result.trace);\n    lastDispatch = { submissionId, trace };\n    diagnosticEvents.push({\n      type: \"submitAccepted\",\n      submissionId,\n      trace,\n    });\n    currentState = cloneState(result.state);\n    applyCurrentState();\n  };\n\n  const explain = (\n    playerId: string,\n    interactionId: string,\n  ): InteractionExplanationLike => {\n    if (!options.bundle.explainInteraction) {\n      throw new Error(\n        \"This reducer bundle does not expose explainInteraction().\",\n      );\n    }\n    return options.bundle.explainInteraction({\n      state: currentState,\n      playerId,\n      interactionId,\n    });\n  };\n\n  const setControllingPlayer = (playerId: string): void => {\n    if (!playerIds.includes(playerId)) {\n      throw new Error(`Unknown controlling player '${playerId}'.`);\n    }\n    currentPlayerId = playerId;\n    applyCurrentState();\n  };\n\n  const runtime = {\n    validateInteraction: validate,\n    submitInteraction: submit,\n    getSessionState: (): RuntimePluginSessionState => lastSessionState,\n    disconnect: () => undefined,\n    switchPlayer: (playerId: string) => {\n      setControllingPlayer(playerId);\n    },\n    getSnapshot: (): PluginStateSnapshot => lastPluginSnapshot,\n    subscribeToState: (listener: (state: PluginStateSnapshot) => void) => {\n      stateListeners.add(listener);\n      return () => {\n        stateListeners.delete(listener);\n      };\n    },\n    _subscribeToSessionState: (\n      listener: (state: RuntimePluginSessionState) => void,\n    ) => {\n      sessionListeners.add(listener);\n      return () => {\n        sessionListeners.delete(listener);\n      };\n    },\n  };\n\n  return {\n    runtime,\n    getSnapshot: () => lastPluginSnapshot,\n    players: () => [...playerIds],\n    seat: (index: number) => {\n      if (!Number.isInteger(index) || index < 0 || index >= playerIds.length) {\n        throw new Error(\n          `seat(${index}) is out of range; base '${options.baseId}' has ${playerIds.length} player(s).`,\n        );\n      }\n      return playerIds[index]!;\n    },\n    submit,\n    validate,\n    explain,\n    diagnostics: {\n      get events() {\n        return diagnosticEvents;\n      },\n      get lastDispatch() {\n        return lastDispatch;\n      },\n      clear() {\n        diagnosticEvents.length = 0;\n        lastDispatch = null;\n      },\n    },\n    setControllingPlayer,\n  };\n}\n"],"mappings":";;;;;;;;ACAA,SAAS,yBAAyB;AD0J3B,SAAS,WACd,YACY;AACZ,SAAO;AACT;AAEO,SAAS,eAKd,YACmD;AACnD,SAAO;AACT;ACrJA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,aACP,QACA,UACA,OAAe,SACA;AACf,MAAI,CAAC,SAAS,QAAQ,GAAG;AACvB,WAAO,kBAAkB,QAAQ,QAAQ,IACrC,OACA,GAAG,IAAI;EACb;AACA,MAAI,CAAC,SAAS,MAAM,GAAG;AACrB,WAAO,GAAG,IAAI;EAChB;AACA,aAAW,CAAC,KAAK,aAAa,KAAK,OAAO,QAAQ,QAAQ,GAAG;AAC3D,UAAM,cAAc,OAAO,GAAG;AAC9B,QAAI,EAAE,OAAO,SAAS;AACpB,aAAO,GAAG,IAAI,IAAI,GAAG;IACvB;AACA,UAAM,WAAW,aAAa,aAAa,eAAe,GAAG,IAAI,IAAI,GAAG,EAAE;AAC1E,QAAI,UAAU;AACZ,aAAO;IACT;EACF;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,QAA8C;AACtE,MAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,UAAM,IAAI,MAAM,wCAAwC;EAC1D;AACA,SAAO;AACT;AAEA,SAAS,gBACP,aACA,eACkC;AAClC,SACE,YAAY;IACV,CAAC,eAAe,WAAW,kBAAkB;EAC/C,KAAK;AAET;AAEA,SAAS,wBACP,YACA,MACM;AACN,MAAI,CAAC,MAAM;AACT;EACF;AACA,QAAM,WAAW,aAAa,YAAY,MAAM,aAAa;AAC7D,MAAI,UAAU;AACZ,UAAM,IAAI,MAAM,QAAQ;EAC1B;AACF;AAEA,SAAS,6BACP,QACA,UACA,SACe;AACf,QAAM,iBAAiB,MAAwB;AAC7C,QAAI,OAAO,WAAW,YAAY;AAChC,aAAO,QAAQ,QAAQ,EAAE,KAAK,MAAO,OAAyB,CAAC;IACjE;AACA,WAAO,QAAQ,QAAQ,MAAM;EAC/B;AAEA,SAAO,eAAe,EACnB,KAAK,MAAM;AACV,UAAM,IAAI,MAAM,6BAA6B;EAC/C,CAAC,EACA,MAAM,CAAC,UAAmB;AACzB,QAAI,EAAE,iBAAiB,QAAQ;AAC7B,YAAM,IAAI,MAAM,oCAAoC;IACtD;AACA,QACE,SAAS,cAAc,UACtB,MAAyC,cACxC,SAAS,WACX;AACA,YAAM,IAAI;QACR,iCAAiC,SAAS,SAAS,gBAChD,MAAyC,aAAa,WACzD,KAAK,8BAA8B,OAAO,CAAC;MAC7C;IACF;AACA,QACE,OAAO,SAAS,YAAY,YAC5B,MAAM,YAAY,SAAS,SAC3B;AACA,YAAM,IAAI;QACR,+BAA+B,SAAS,OAAO,gBAAgB,MAAM,OAAO,KAAK;UAC/E;QACF,CAAC;MACH;IACF;AACA,QACE,SAAS,mBAAmB,UAC5B,CAAC,SAAS,QAAQ,KAAK,MAAM,OAAO,GACpC;AACA,YAAM,IAAI;QACR,+BAA+B,MAAM,OAAO,cAAc;UACxD,SAAS;QACX,CAAC,IAAI,8BAA8B,OAAO,CAAC;MAC7C;IACF;EACF,CAAC;AACL;AAEA,SAAS,8BACP,SACQ;AACR,QAAM,YAAY,QAAQ,0BAA0B;AACpD,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,OAAO,UAAU,SAAS,WAAW,UAAU,MAAM,KAAK;AAChE,QAAM,UAAU,UAAU,UAAU,YAAY,UAAU,OAAO,KAAK;AACtE,SAAO;4BAA+B,UAAU,SAAS,GAAG,IAAI,GAAG,OAAO;AAC5E;AAEA,SAAS,aAAa,QAAiB,UAAwB;AAC7D,MACE,WAAW,QACX,WAAW,UACX,OAAQ,OAAgC,WAAW,UACnD;AACA,UAAM,IAAI,MAAM,qDAAqD;EACvE;AACA,QAAM,SAAU,OAA8B;AAC9C,MAAI,WAAW,UAAU;AACvB,UAAM,IAAI,MAAM,mBAAmB,QAAQ,cAAc,MAAM,GAAG;EACpE;AACF;AAEA,SAAS,6BACP,aACQ;AACR,MAAI,CAAC,aAAa;AAChB,WAAO;EACT;AACA,QAAM,QAAQ;IACZ,iBAAiB,YAAY,YAAY;IACzC,GAAG,YAAY,MAAM,IAAI,CAAC,SAAS;AACjC,YAAM,OAAO,KAAK,YAAY,KAAK,KAAK,SAAS,MAAM;AACvD,YAAM,UAAU,KAAK,UAAU,KAAK,KAAK,OAAO,KAAK;AACrD,aAAO,QAAQ,KAAK,MAAM,IAAI,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO;IAC7D,CAAC;IACD,GAAG,YAAY,OAAO;MACpB,CAAC,UAAU,SAAS,MAAM,GAAG,kBAAkB,MAAM,aAAa;IACpE;EACF;AACA,SAAO;EAAK,MAAM,KAAK,IAAI,CAAC;AAC9B;AAEA,SAAS,aACP,QACA,WACM;AACN,MAAI,OAAO,WAAW,YAAY;AAChC,UAAM,IAAI,MAAM,6BAA6B;EAC/C;AACA,MAAI;AACD,WAAyB;EAC5B,SAAS,OAAO;AACd,QAAI,EAAE,iBAAiB,QAAQ;AAC7B,YAAM,IAAI,MAAM,+BAA+B;IACjD;AACA,QAAI,cAAc,QAAW;AAC3B;IACF;AACA,QAAI,OAAO,cAAc,YAAY,MAAM,YAAY,WAAW;AAChE,YAAM,IAAI;QACR,4BAA4B,SAAS,gBAAgB,MAAM,OAAO;MACpE;IACF;AACA,QAAI,qBAAqB,UAAU,CAAC,UAAU,KAAK,MAAM,OAAO,GAAG;AACjE,YAAM,IAAI;QACR,4BAA4B,MAAM,OAAO,cAAc,OAAO,SAAS,CAAC;MAC1E;IACF;AACA,QAAI,OAAO,cAAc,cAAc,CAAC,UAAU,KAAK,GAAG;AACxD,YAAM,IAAI,MAAM,yCAAyC;IAC3D;AACA;EACF;AACA,QAAM,IAAI,MAAM,6BAA6B;AAC/C;AAEO,SAAS,gBACd,UAAkC,CAAC,GACzB;AACV,QAAM,gBAAgB,CAAC,YAAqC;IAC1D,MAAM,CAAC,aAAsB;AAC3B,UAAI,WAAW,UAAU;AACvB,cAAM,IAAI;UACR,aAAa,OAAO,MAAM,CAAC,YAAY,OAAO,QAAQ,CAAC;QACzD;MACF;IACF;IACA,SAAS,CAAC,aAAsB;AAC9B,UAAI,CAAC,kBAAkB,QAAQ,QAAQ,GAAG;AACxC,cAAM,IAAI,MAAM,qCAAqC;MACvD;IACF;IACA,eAAe,CAAC,aAAsC;AACpD,YAAM,WAAW,aAAa,QAAQ,QAAQ;AAC9C,UAAI,UAAU;AACZ,cAAM,IAAI,MAAM,QAAQ;MAC1B;IACF;IACA,aAAa,MAAM;AACjB,UAAI,WAAW,QAAW;AACxB,cAAM,IAAI,MAAM,+BAA+B;MACjD;IACF;IACA,eAAe,MAAM;AACnB,UAAI,WAAW,QAAW;AACxB,cAAM,IAAI;UACR,iDAAiD,OAAO,MAAM,CAAC;QACjE;MACF;IACF;IACA,UAAU,MAAM;AACd,UAAI,WAAW,MAAM;AACnB,cAAM,IAAI;UACR,4CAA4C,OAAO,MAAM,CAAC;QAC5D;MACF;IACF;IACA,WAAW,CAAC,aAAsB;AAChC,UAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,YAAI,CAAC,OAAO,SAAS,QAAQ,GAAG;AAC9B,gBAAM,IAAI,MAAM,kCAAkC;QACpD;AACA;MACF;AACA,UAAI,OAAO,WAAW,UAAU;AAC9B,YAAI,CAAC,OAAO,SAAS,OAAO,QAAQ,CAAC,GAAG;AACtC,gBAAM,IAAI,MAAM,mCAAmC;QACrD;AACA;MACF;AACA,YAAM,IAAI,MAAM,oDAAoD;IACtE;IACA,gBAAgB,CAAC,aAAsB;AACrC,UAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,cAAM,IAAI,MAAM,+CAA+C;MACjE;AACA,UAAI,CAAC,OAAO,KAAK,CAAC,UAAU,kBAAkB,OAAO,QAAQ,CAAC,GAAG;AAC/D,cAAM,IAAI,MAAM,2CAA2C;MAC7D;IACF;IACA,cAAc,CAAC,aAAqB;AAClC,mBAAa,QAAQ,QAAQ;IAC/B;IACA,iBAAiB,CAAC,aAAqB;AACrC,UAAI,OAAO,WAAW,UAAU;AAC9B,cAAM,IAAI,MAAM,gDAAgD;MAClE;AACA,UAAI,UAAU,UAAU;AACtB,cAAM,IAAI,MAAM,YAAY,MAAM,YAAY,QAAQ,GAAG;MAC3D;IACF;IACA,wBAAwB,CAAC,aAAqB;AAC5C,UAAI,OAAO,WAAW,UAAU;AAC9B,cAAM,IAAI;UACR;QACF;MACF;AACA,UAAI,SAAS,UAAU;AACrB,cAAM,IAAI,MAAM,YAAY,MAAM,aAAa,QAAQ,GAAG;MAC5D;IACF;IACA,SAAS,CAAC,cAAc;AACtB,mBAAa,QAAQ,SAAS;IAChC;IACA,iBAAiB,CAAC,aAAa;AAC7B,UAAI,CAAC,QAAQ,eAAe;AAC1B,cAAM,IAAI;UACR;QACF;MACF;AACA,cAAQ,cAAc,UAAU,MAAM;IACxC;IACA,cAAc,CAAC,aACb,6BAA6B,QAAQ,UAAU,OAAO;IACxD,mBAAmB,CAAC,eAAe,SAAS;AAC1C,YAAM,cAAc,iBAAiB,MAAM;AAC3C,YAAM,aAAa,gBAAgB,aAAa,aAAa;AAC7D,UAAI,CAAC,YAAY;AACf,cAAM,IAAI,MAAM,yBAAyB,aAAa,aAAa;MACrE;AACA,8BAAwB,YAAY,IAAI;IAC1C;IACA,aAAa,CAAC,QAAQ,SAAS;AAC7B,YAAM,aAAa,MAAM,QAAQ,MAAM,KAClC,MAAM;AACL,YAAI,CAAC,MAAM,eAAe;AACxB,gBAAM,IAAI;YACR;UACF;QACF;AACA,eAAO;UACL,iBAAiB,MAAM;UACvB,KAAK;QACP;MACF,GAAG,IACF;AACL,UAAI,CAAC,YAAY;AACf,cAAM,IAAI,MAAM,2CAA2C;MAC7D;AACA,UAAI,WAAW,cAAc,WAAW,aAAa;AACnD,cAAM,IAAI,MAAM,yCAAyC;MAC3D;AACA,YAAM,eACJ,WAAW,cAAc,WAAW,iBACpC,WAAW,cAAc,WAAW,2BACpC,WAAW,cAAc,WAAW,YAChC,WAAW,aAAa,SACxB;AACN,UAAI,iBAAiB,QAAQ;AAC3B,cAAM,IAAI;UACR,gCAAgC,MAAM,gBACpC,gBAAgB,WAClB;QACF;MACF;IACF;IACA,eAAe,CAAC,gBAAgB;AAC9B,YAAM,aAAa,MAAM,QAAQ,MAAM,KAClC,MAAM;AACL,YAAI,CAAC,aAAa,eAAe;AAC/B,gBAAM,IAAI;YACR;UACF;QACF;AACA,eAAO;UACL,iBAAiB,MAAM;UACvB,YAAY;QACd;MACF,GAAG,IACF;AACL,UAAI,CAAC,YAAY;AACf,cAAM,IAAI;UACR,4CAA4C;YAC1C;UACF,CAAC;QACH;MACF;AACA,UAAI,WAAW,cAAc,WAAW,aAAa;AACnD,cAAM,IAAI;UACR,yBAAyB,WAAW,iBAAiB,SAAS,qBAAqB;YACjF;UACF,CAAC;QACH;MACF;IACF;IACA,eAAe,CAAC,UAAU,SAAS;AACjC,YAAM,aAAa,MAAM,QAAQ,MAAM,KAClC,MAAM;AACL,YAAI,CAAC,MAAM,eAAe;AACxB,gBAAM,IAAI;YACR;UACF;QACF;AACA,eAAO;UACL,iBAAiB,MAAM;UACvB,KAAK;QACP;MACF,GAAG,IACF;AACL,UAAI,CAAC,YAAY;AACf,cAAM,IAAI,MAAM,2CAA2C;MAC7D;AACA,UAAI,WAAW,SAAS,OAAO,UAAU;AACvC,cAAM,IAAI;UACR,mCAAmC,QAAQ,gBACzC,WAAW,SAAS,MAAM,WAC5B;QACF;MACF;AACA,UAAI,WAAW,cAAc,WAAW,aAAa;AACnD,cAAM,IAAI,MAAM,uCAAuC;MACzD;IACF;IACA,KAAK;MACH,mBAAmB,CAAC,kBAAkB;AACpC,cAAM,cAAc,iBAAiB,MAAM;AAC3C,YAAI,gBAAgB,aAAa,aAAa,GAAG;AAC/C,gBAAM,IAAI;YACR,yBAAyB,aAAa;UACxC;QACF;MACF;IACF;EACF;AAEA,SAAO,CAAC,WAAoB,cAAc,MAAM;AAClD;ACtTA,SAAS,WAAc,OAA0B;AAC/C,SAAO,gBAAgB,KAAK;AAC9B;AAEA,SAAS,sBACP,WACA,SACiB;AACjB,QAAM,QAAQ,IAAI,MAAM,WAAW,sBAAsB;AACzD,QAAM,OAAO;AACb,QAAM,YAAY;AAClB,SAAO;AACT;AAEA,SAAS,mBACP,OAC6B;AAC7B,UAAQ,SAAS,CAAC,GAAG,QAAQ,CAAC,UAAuC;AACnE,QAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO,CAAC;AACzD,UAAM,SAAS;AACf,YAAQ,OAAO,MAAM;MACnB,KAAK,uBAAuB;AAC1B,cAAM,QACJ,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,OAChD,OAAO,QACR,CAAC;AACP,eAAO;UACL;YACE,MAAM;YACN,eAAe,OAAO,MAAM,iBAAiB,EAAE;YAC/C,UAAU,OAAO,MAAM,YAAY,EAAE;UACvC;QACF;MACF;MACA,KAAK,iBAAiB;AACpB,cAAM,SACJ,OAAO,OAAO,WAAW,YAAY,OAAO,WAAW,OAClD,OAAO,SACR,CAAC;AACP,eAAO;UACL;YACE,MAAM;YACN,aAAa,OAAO,OAAO,QAAQ,OAAO,QAAQ,QAAQ;UAC5D;QACF;MACF;MACA,KAAK;AACH,eAAO;UACL;YACE,MAAM;YACN,WAAW,OAAO,OAAO,aAAa,EAAE;YACxC,YAAY,OAAO,OAAO,cAAc,EAAE;UAC5C;QACF;MACF;AACE,eAAO,CAAC;IACZ;EACF,CAAC;AACH;AAEA,SAAS,cAAc,OAGrB;AACA,QAAM,OACJ,MAAM,QAGL,QAAQ,CAAC;AAIZ,SAAO;IACL,cAAc,KAAK,gBAAgB;IACnC,eAAe,MAAM,QAAQ,KAAK,aAAa,IAAI,KAAK,gBAAgB,CAAC;EAC3E;AACF;AAEA,SAAS,iBAAiB,SAGb;AACX,MAAI,QAAQ,qBAAqB,QAAQ,kBAAkB,SAAS,GAAG;AACrE,WAAO,CAAC,GAAG,QAAQ,iBAAiB;EACtC;AACA,SAAO,MAAM;IACX,EAAE,QAAQ,QAAQ,UAAU,YAAY,QAAQ;IAChD,CAAC,GAAG,UAAU,UAAU,QAAQ,CAAC;EACnC;AACF;AAEA,SAAS,kBAAkB,OAA0C;AACnE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,oBAAoB,SAUL;AACtB,QAAM,aAAa,QAAQ,OAAO,oBAAoB;IACpD,OAAO,QAAQ;IACf,WAAW,CAAC,QAAQ,QAAQ;EAC9B,CAAC;AAED,QAAM,OAAO,cAAc,QAAQ,KAAK;AACxC,MAAI,QAAQ,iBAAiB,KAAK,iBAAiB,QAAQ,eAAe;AACxE,UAAM,IAAI;MACR,kBAAkB,QAAQ,MAAM,qBAAqB,QAAQ,aAAa,gBACxE,KAAK,gBAAgB,MACvB;IACF;EACF;AAEA,QAAM,oBACH,WAAW,qBAEM,CAAC;AACrB,QAAM,cAAc,CAClB,UAEC,QAAQ,CAAC,GACP,IAAI,CAAC,QAAQ,kBAAkB,GAAG,CAAC,EACnC;IAAO,CAAC,eACP,QAAQ,UAAU;EACpB;AAEJ,QAAM,OAAO,WAAW,QAAQ,QAAQ,QAAQ;AAChD,QAAM,QAAQ,OAAO;IACnB,OAAO;MACJ,MAAM,SAAiD,CAAC;IAC3D,EAAE,IAAI,CAAC,CAAC,QAAQ,SAAS,MAAM;AAC7B,YAAM,OAAO,kBAAkB,SAAS,IAAI,YAAY,CAAC;AACzD,aAAO;QACL;QACA;UACE,SAAS,CAAC,GAAI,KAAK,WAAW,CAAC,CAAE;UACjC,eAAe,EAAE,GAAI,KAAK,iBAAiB,CAAC,EAAG;UAC/C,kBAAkB,OAAO;YACvB,OAAO,QAAQ,KAAK,oBAAoB,CAAC,CAAC,EAAE;cAC1C,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,YAAY,IAAI,CAAC;YAChD;UACF;QACF;MACF;IACF,CAAC;EACH;AAEA,SAAO;IACL,MAAO,MAAM,QAAQ;IACrB,UAAU;MACR,cAAc,KAAK;MACnB,cAAc,WAAW,gBAAgB;MACzC,eAAe,KAAK;MACpB,mBAAmB,WAAW,qBAAqB;MACnD,uBAAuB;QACrB,MAAM;MACR;MACA;IACF;IACA,OAAO;IACP,eAAe,CAAC;IAChB,SAAS;MACP,WAAW,QAAQ;MACnB,uBAAuB,CAAC,GAAG,QAAQ,SAAS;MAC5C,qBAAqB,QAAQ,YAAY;MACzC,QAAQ,QAAQ;IAClB;IACA,SAAS;IACT,QAAQ,QAAQ;EAClB;AACF;AAEO,SAAS,kBACd,SACoB;AACpB,QAAM,YAAY,QAAQ,WAAW,QAAQ,MAAM;AACnD,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,sBAAsB,QAAQ,MAAM,IAAI;EAC1D;AACA,QAAM,+BACJ,QAAQ,gCACR,UAAU,YAAY;AACxB,MACE,QAAQ,uBACR,gCACA,QAAQ,wBAAwB,8BAChC;AACA,UAAM,IAAI,2BAA2B;MACnC,UAAU;MACV,UAAU,QAAQ;MAClB,OAAO;IACT,CAAC;EACH;AAEA,MAAI,eAAe,WAAW,UAAU,QAAQ;AAChD,QAAM,YAAY,iBAAiB;IACjC;IACA,mBAAmB,QAAQ;EAC7B,CAAC;AACD,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,YAAY,QAAQ,aAAa;AAEvC,MAAI,UAAU;AACd,MAAI,oBAAoB;AACxB,MAAI,kBAAkB,UAAU,CAAC,KAAK;AACtC,QAAM,mBAA6C,CAAC;AACpD,MAAI,eAGO;AACX,QAAM,iBAAiB,oBAAI,IAA0C;AACrE,QAAM,mBAAmB,oBAAI,IAE3B;AAEF,QAAM,sBAAsB,CAC1B,cAC+B;IAC/B,GAAG,SAAS;IACZ,QAAQ;EACV;AAEA,MAAI;AACJ,MAAI;AAEJ,QAAM,oBAAoB,MAAY;AACpC,UAAM,kBAAkB;AACxB,eAAW;AACX,yBAAqB,oBAAoB;MACvC,OAAO;MACP,QAAQ,QAAQ;MAChB,UAAU;MACV;MACA;MACA;MACA;MACA,eAAe,YAAY,IAAI,QAAQ,QAAQ;MAC/C,QAAQ,QAAQ;IAClB,CAAC;AACD,uBAAmB,oBAAoB,kBAAkB;AAEzD,eAAW,YAAY,gBAAgB;AACrC,eAAS,kBAAkB;IAC7B;AAEA,QACE,CAAC,mBACD,gBAAgB,wBACd,iBAAiB,uBACnB,gBAAgB,sBAAsB,KAAK,IAAI,MAC7C,iBAAiB,sBAAsB,KAAK,IAAI,GAClD;AACA,iBAAW,YAAY,kBAAkB;AACvC,iBAAS,gBAAgB;MAC3B;IACF;EACF;AAEA,oBAAkB;AAElB,QAAM,WAAW,OACf,UACA,eACA,SAAkB,CAAC,MACW;AAC9B,UAAM,SAAS,MAAM,QAAQ,OAAO,cAAc;MAChD,OAAO;MACP,OAAO;QACL,MAAM;QACN;QACA;QACA;MACF;IACF,CAAC;AACD,WAAO;MACL,OAAO,OAAO;MACd,WAAW,OAAO;MAClB,SAAS,OAAO;IAClB;EACF;AAEA,QAAM,SAAS,OACb,UACA,eACA,SAAkB,CAAC,MACD;AAClB,yBAAqB;AACrB,UAAM,eAAe,OAAO,iBAAiB;AAC7C,qBAAiB,KAAK;MACpB,MAAM;MACN;MACA;MACA;MACA,OAAO,cAAc,YAAY,EAAE,gBAAgB;IACrD,CAAC;AACD,UAAM,aAAa,MAAM,SAAS,UAAU,eAAe,MAAM;AACjE,QAAI,CAAC,WAAW,OAAO;AACrB,uBAAiB,KAAK;QACpB,MAAM;QACN;QACA,WAAW,WAAW,aAAa;QACnC,GAAI,WAAW,UAAU,EAAE,SAAS,WAAW,QAAQ,IAAI,CAAC;MAC9D,CAAC;AACD,YAAM,sBAAsB,WAAW,WAAW,WAAW,OAAO;IACtE;AACA,UAAM,SAAS,MAAM,QAAQ,OAAO,SAAS;MAC3C,OAAO;MACP,OAAO;QACL,MAAM;QACN;QACA;QACA;MACF;IACF,CAAC;AACD,QAAI,OAAO,SAAS,UAAU;AAC5B,uBAAiB,KAAK;QACpB,MAAM;QACN;QACA,WAAW,OAAO;QAClB,GAAI,OAAO,UAAU,EAAE,SAAS,OAAO,QAAQ,IAAI,CAAC;MACtD,CAAC;AACD,YAAM,sBAAsB,OAAO,WAAW,OAAO,OAAO;IAC9D;AACA,UAAM,QAAQ,mBAAmB,OAAO,KAAK;AAC7C,mBAAe,EAAE,cAAc,MAAM;AACrC,qBAAiB,KAAK;MACpB,MAAM;MACN;MACA;IACF,CAAC;AACD,mBAAe,WAAW,OAAO,KAAK;AACtC,sBAAkB;EACpB;AAEA,QAAM,UAAU,CACd,UACA,kBAC+B;AAC/B,QAAI,CAAC,QAAQ,OAAO,oBAAoB;AACtC,YAAM,IAAI;QACR;MACF;IACF;AACA,WAAO,QAAQ,OAAO,mBAAmB;MACvC,OAAO;MACP;MACA;IACF,CAAC;EACH;AAEA,QAAM,uBAAuB,CAAC,aAA2B;AACvD,QAAI,CAAC,UAAU,SAAS,QAAQ,GAAG;AACjC,YAAM,IAAI,MAAM,+BAA+B,QAAQ,IAAI;IAC7D;AACA,sBAAkB;AAClB,sBAAkB;EACpB;AAEA,QAAM,UAAU;IACd,qBAAqB;IACrB,mBAAmB;IACnB,iBAAiB,MAAiC;IAClD,YAAY,MAAM;IAClB,cAAc,CAAC,aAAqB;AAClC,2BAAqB,QAAQ;IAC/B;IACA,aAAa,MAA2B;IACxC,kBAAkB,CAAC,aAAmD;AACpE,qBAAe,IAAI,QAAQ;AAC3B,aAAO,MAAM;AACX,uBAAe,OAAO,QAAQ;MAChC;IACF;IACA,0BAA0B,CACxB,aACG;AACH,uBAAiB,IAAI,QAAQ;AAC7B,aAAO,MAAM;AACX,yBAAiB,OAAO,QAAQ;MAClC;IACF;EACF;AAEA,SAAO;IACL;IACA,aAAa,MAAM;IACnB,SAAS,MAAM,CAAC,GAAG,SAAS;IAC5B,MAAM,CAAC,UAAkB;AACvB,UAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,SAAS,UAAU,QAAQ;AACtE,cAAM,IAAI;UACR,QAAQ,KAAK,4BAA4B,QAAQ,MAAM,SAAS,UAAU,MAAM;QAClF;MACF;AACA,aAAO,UAAU,KAAK;IACxB;IACA;IACA;IACA;IACA,aAAa;MACX,IAAI,SAAS;AACX,eAAO;MACT;MACA,IAAI,eAAe;AACjB,eAAO;MACT;MACA,QAAQ;AACN,yBAAiB,SAAS;AAC1B,uBAAe;MACjB;IACF;IACA;EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@dreamboard-games/cli",
+  "version": "0.1.30-alpha.0",
+  "description": "Design board games with AI and turn ideas into playable digital prototypes.",
+  "type": "module",
+  "bin": {
+    "dreamboard": "dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
+    },
+    "./agent-workspace-verifier": "./dist/agent-verifier/agent-workspace-verifier.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "skills"
+  ],
+  "keywords": [
+    "dreamboard",
+    "cli",
+    "game-dev",
+    "board-game",
+    "multiplayer"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tailwindcss/postcss": "^4.3.0",
+    "@vitejs/plugin-react": "^4.7.0",
+    "citty": "^0.2.2",
+    "clsx": "^2.1.1",
+    "consola": "^3.4.2",
+    "esbuild": "^0.25.12",
+    "lucide-react": "^1.17.0",
+    "picocolors": "^1.1.1",
+    "postcss": "^8.5.15",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.6.0",
+    "tailwindcss": "^4.3.0",
+    "tw-animate-css": "^1.4.0",
+    "vaul": "^1.1.2",
+    "vite": "^5.4.21",
+    "zod": "4.4.3",
+    "zustand": "^5.0.14",
+    "@dreamboard-games/api-client": "0.3.0-alpha.3",
+    "@dreamboard-games/sdk": "0.4.0-alpha.0",
+    "playwright": "^1.60.0"
+  },
+  "optionalDependencies": {
+    "@napi-rs/keyring": "^1.3.0"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dreamboard-games/dreamboard.git"
+  },
+  "homepage": "http://dreamboard.games/",
+  "bugs": {
+    "url": "https://github.com/dreamboard-games/dreamboard/issues"
+  }
+}

package/skills/dreamboard/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: dreamboard
+description: Create multiplayer, rule-enforced, turn-based game on Dreamboard.games platform.
+metadata:
+  short-description: Dreamboard Game Development Workflow
+  tags: [dreamboard, cli, game-dev, board-game, turn-based, multiplayer]
+---
+
+# Dreamboard CLI
+
+## Goal
+
+Create and iterate on a Dreamboard game locally, then sync authored changes,
+compile, run, and test against the current reducer-native scaffold.
+
+## Prereqs
+
+- Dreamboard CLI installed and available as `dreamboard`
+  Install with `npm install -g dreamboard`
+- Authenticated via `dreamboard login`
+
+## Buliding Your First Game
+See [tutorials/building-your-first-game.md](references/building-your-first-game.md)
+
+## References
+
+- Quickstart:
+  [references/quickstart.md](references/quickstart.md)
+- Tutorial:
+  [references/building-your-first-game.md](references/building-your-first-game.md)
+- CLI:
+  [references/cli.md](references/cli.md)
+- Rules:
+  [references/rule-authoring.md](references/rule-authoring.md)
+- Manifest:
+  [references/manifest-authoring.md](references/manifest-authoring.md)
+- Reducer:
+  [references/reducer.md](references/reducer.md)
+- Game interface:
+  [references/game-interface.md](references/game-interface.md)
+- Testing:
+  [references/testing.md](references/testing.md)
+
+## Current Scaffold
+
+The current scaffold centers on these files:
+
+- authored source:
+  `rule.md`, `manifest.json`
+- reducer:
+  `app/game-contract.ts`, `app/game.ts`, `app/phases/*.ts`,
+  `app/setup-profiles.ts`
+- UI:
+  `ui/App.tsx`
+- tests:
+  `test/bases/*.base.ts`, `test/scenarios/*.scenario.ts`,
+  `test/testing-types.ts`
+
+## Command Flow
+
+Use the commands for different kinds of state:
+
+- `dreamboard sync`
+  Upload local authored changes and advance the remote authored head. Run this after editing `rule.md`, `manifest.json`, or authored source files that should be part of the next remote build.
+- `dreamboard compile`
+  Compile the current remote authored head. Run this after `sync`, or re-run it after a failed compile when you have not made new authored edits.
+- `dreamboard pull`
+  Reconcile remote authored changes into the current workspace. Run this when someone else advanced the remote authored head or `dreamboard status` shows authored state `behind` or `diverged`.
+
+Quick rule:
+
+- edited files locally: `dreamboard sync` then `dreamboard compile`
+- compile failed but you have not edited files since: `dreamboard compile` again
+- remote authored head moved: `dreamboard pull` first
+
+## Workflow
+
+Use this order by default:
+
+1. Write or revise `rule.md`.
+2. Align `manifest.json` to the rules.
+3. Run `dreamboard sync`.
+4. Implement reducer state, phases, actions, and views in `app/`.
+5. Implement the playable UI in `ui/App.tsx`.
+6. Run `dreamboard compile`.
+7. Generate test artifacts with `dreamboard test generate`.
+8. Run scenarios with `dreamboard test run`.
+9. Validate the local runtime with `dreamboard run`.
+10. For agent-built games, run `dreamboard dev` and verify the browser UI before handoff. Use Playwright to open the dev host, check that the plugin iframe renders without console errors, and click a primary interaction such as selecting a playable hand card. Reducer scenarios alone are not enough when the game has an interactive UI.
+
+## Guardrails
+
+- `manifest.json` and `rule.md` are the source of truth for scaffolding.
+- Run `dreamboard sync` after authored changes to keep generated files and the remote authored head in sync.
+- `dreamboard pull` reconciles authored divergence into the current workspace.
+- `dreamboard compile` is separate from authored sync; failed compiles do not mean the workspace needs a pull or another sync unless you changed authored files again.
+- Use `dreamboard status` to distinguish authored sync from compile health before deciding whether the next command should be `sync`, `compile`, or `pull`.
+- Re-run `dreamboard test generate` after runtime-shape changes in `manifest.json` or `app/`.
+- Keep reducer-owned UI data in views; do not reintroduce the old `shared/ui-args.ts` pattern in new scaffolds.
+- When a game exposes clickable hands, markets, boards, or prompts, prove the same interaction works through `dreamboard dev` in a browser. A direct scenario submission can pass even when the rendered surface does not collect the input.
+- For interactive card hands, render generated surfaces such as `handSurface.Hand` and `handSurface.Card` consistently. Do not swap a surface card for a raw `Card` or custom tile based on `me.canAct`; the surface primitive is responsible for disabling unavailable interactions.
+
+## Editable Surface
+
+Edit:
+
+- `rule.md`
+- `manifest.json`
+- `app/game-contract.ts`
+- `app/game.ts`
+- `app/phases/*.ts`
+- `app/setup-profiles.ts`
+- `ui/App.tsx`
+- `test/bases/*.base.ts`
+- `test/scenarios/*.scenario.ts`
+
+Do not edit generated or framework-owned files such as:
+
+- `app/index.ts`
+- `shared/manifest-contract.ts`
+- `shared/generated/ui-contract.ts`
+- `ui/index.tsx`
+- `test/generated/*`
+
+## Offical Documentation
+Visit https://dreamboard.games/docs
+
+## Framework Feedback
+
+Use `feedback.md` in the game project root to record framework issues, missing features, or workflow friction. Include reproduction steps, expected behavior, and actual behavior when possible.