@dreamboard-games/sdk 0.5.0-alpha.7 → 0.5.0-alpha.9

package/README.md

@@ -234,7 +234,7 @@ To migrate an older manifest, replace each card's `type` with `id` and set
 
 `createReducerBundle(game)` returns exactly the contract version and four
 operations: `boardStatic()`, `initialize(input)`, `dispatch({ state, input })`,
-and `project({ state, playerIds })`. The runner contract is `0.8.0`; hosts must
+and `project({ state, playerIds })`. The runner contract is `0.9.0`; hosts must
 require that exact version. Dispatch includes validation, direct transaction mutations, and phase entry.
 Initialization returns
 `{ state, terminal?, events? }`, preserving outcomes and events from initial
@@ -325,6 +325,15 @@ and gameplay websocket schemas plus `materializePluginGameplayFrame` live at the
 root. Materialize the seat projection with static board data before publishing it;
 sources publish the canonical seat view and keep command bases private.
 
+Visible cards share one complete `ViewCard` shape: `id`, `cardType`, and JSON
+`properties`, plus optional `name`, `text`, `frontImage`, and `backImage`.
+`ViewCardSchema` validates this shape. Reducer and gameplay `cardViewsById` maps
+contain these objects directly. Headless `card.view` preserves the manifest's
+card identity, category, and property inference and is deeply readonly; table-only
+`cardSetId` and `componentType` are absent. Concealed cards have a positional
+`hidden:<zone>:<index>` identity, no view, and an optional separate `cardBacksById` entry.
+This wire format requires plugin protocol version 8 and reducer contract `0.9.0`.
+
 Card sets contain their authored `cards`, `cardSchema`, and `defaultHome` directly.
 Standard playing cards are game-owned definitions with ordinary suit/rank
 properties; the SDK does not synthesize inventories or assign built-in rules.

package/dist/{chunk-3JXUL4VN.js → chunk-DPRHGA2C.js}

@@ -11,7 +11,7 @@ function requireLookup(value, kind, id) {
 }
 
 // src/shared/board-target.ts
-import { z } from "zod";
+import * as z from "zod";
 var PlayerBoardSpaceTargetSchema = z.strictObject({
   boardId: z.string(),
   playerId: z.string(),
@@ -136,4 +136,4 @@ export {
   inputTargetInDomain,
   inputValueKey
 };
-//# sourceMappingURL=chunk-3JXUL4VN.js.map
+//# sourceMappingURL=chunk-DPRHGA2C.js.map

package/dist/chunk-DPRHGA2C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/lookup.ts","../src/shared/board-target.ts","../src/shared/input-domain.ts"],"sourcesContent":["/** Assert presence at a mutable table or projected-snapshot lookup boundary. */\nexport function requireLookup<T>(\n  value: T | undefined,\n  kind: string,\n  id: string,\n): T {\n  if (value === undefined) throw new Error(`${kind} \"${id}\" is not present.`);\n  return value;\n}\n","import * as z from \"zod\";\n\n/** A space on one player's board; boardId is the base manifest board ID. */\nexport type PlayerBoardSpaceTarget<\n  BoardId extends string = string,\n  SpaceId extends string = string,\n  PlayerId extends string = string,\n> = {\n  readonly boardId: BoardId;\n  readonly playerId: PlayerId;\n  readonly spaceId: SpaceId;\n};\n\nexport const PlayerBoardSpaceTargetSchema = z.strictObject({\n  boardId: z.string(),\n  playerId: z.string(),\n  spaceId: z.string(),\n});\n\nexport function isPlayerBoardSpaceTarget(\n  value: unknown,\n): value is PlayerBoardSpaceTarget {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    Object.keys(value).length === 3 &&\n    \"boardId\" in value &&\n    typeof value.boardId === \"string\" &&\n    \"playerId\" in value &&\n    typeof value.playerId === \"string\" &&\n    \"spaceId\" in value &&\n    typeof value.spaceId === \"string\"\n  );\n}\n\nexport function samePlayerBoardSpaceTarget(\n  left: PlayerBoardSpaceTarget,\n  right: PlayerBoardSpaceTarget,\n): boolean {\n  return (\n    left.boardId === right.boardId &&\n    left.playerId === right.playerId &&\n    left.spaceId === right.spaceId\n  );\n}\n","import {\n  isPlayerBoardSpaceTarget,\n  samePlayerBoardSpaceTarget,\n} from \"./board-target\";\nimport type {\n  InputDomainDescriptor,\n  InputSelectionDescriptor,\n} from \"../reducer/model/spec/inputs\";\n\n/** Projected domain rules only; schemas and authored target checks remain server-owned. */\nexport function inputDomainErrors(\n  domain: InputDomainDescriptor,\n  value: unknown,\n  selection?: InputSelectionDescriptor,\n  options: { ignoreMinimum?: boolean } = {},\n): string[] {\n  if (selection?.mode === \"many\") {\n    if (!Array.isArray(value)) return [\"Expected a list of values.\"];\n    const errors = cardinalityErrors(\n      value,\n      selection.min,\n      selection.max,\n      \"value\",\n      options.ignoreMinimum,\n    );\n    if (\n      selection.distinct &&\n      new Set(value.map(inputValueKey)).size !== value.length\n    )\n      errors.push(\"Choose each value only once.\");\n    if (\n      value.some(\n        (item) =>\n          inputDomainErrors(domain, item, undefined, options).length > 0,\n      )\n    )\n      errors.push(ineligibleMessage(domain));\n    return errors;\n  }\n  switch (domain.type) {\n    case \"choice\":\n      return inputTargetInDomain(domain, value)\n        ? []\n        : [ineligibleMessage(domain)];\n    case \"choiceList\": {\n      if (!Array.isArray(value)) return [\"Expected a list of choices.\"];\n      const errors = cardinalityErrors(\n        value,\n        domain.min ?? 0,\n        domain.max ?? domain.choices.length,\n        \"option\",\n        options.ignoreMinimum,\n      );\n      if (value.some((item) => !inputTargetInDomain(domain, item)))\n        errors.push(ineligibleMessage(domain));\n      return errors;\n    }\n    case \"cardTarget\":\n    case \"boardTarget\":\n      return inputTargetInDomain(domain, value)\n        ? []\n        : [ineligibleMessage(domain)];\n    case \"boundedNumber\":\n      return typeof value === \"number\" &&\n        value >= domain.min &&\n        value <= domain.max &&\n        Math.abs(\n          (value - domain.min) / (domain.step ?? 1) -\n            Math.round((value - domain.min) / (domain.step ?? 1)),\n        ) < 1e-9\n        ? []\n        : [\"Value is outside the current input domain.\"];\n    case \"resourceMap\":\n      return typeof value === \"object\" &&\n        value !== null &&\n        !Array.isArray(value) &&\n        Object.keys(value).every((key) =>\n          domain.resources.some((entry) => entry.resourceId === key),\n        ) &&\n        domain.resources.every((entry) => {\n          const amount =\n            (value as Record<string, unknown>)[entry.resourceId] ?? 0;\n          return (\n            typeof amount === \"number\" &&\n            Number.isInteger(amount) &&\n            amount >= (entry.min ?? 0) &&\n            amount <= (entry.max ?? Infinity)\n          );\n        })\n        ? []\n        : [\"Value is outside the current input domain.\"];\n  }\n}\n\nexport function inputValueInDomain(\n  domain: InputDomainDescriptor,\n  value: unknown,\n  selection?: InputSelectionDescriptor,\n  options: { ignoreMinimum?: boolean } = {},\n): boolean {\n  return inputDomainErrors(domain, value, selection, options).length === 0;\n}\n\n/** One selectable option, including an option within a choiceList or many input. */\nexport function inputTargetInDomain(\n  domain: InputDomainDescriptor,\n  value: unknown,\n): boolean {\n  switch (domain.type) {\n    case \"choice\":\n    case \"choiceList\":\n      return domain.choices.some(\n        (choice) => !choice.disabled && Object.is(choice.value, value),\n      );\n    case \"cardTarget\":\n      return (\n        typeof value === \"string\" && domain.eligibleTargets.includes(value)\n      );\n    case \"boardTarget\":\n      return domain.valueKind === \"player-board-space\"\n        ? isPlayerBoardSpaceTarget(value) &&\n            domain.eligibleTargets.some((candidate) =>\n              samePlayerBoardSpaceTarget(candidate, value),\n            )\n        : typeof value === \"string\" && domain.eligibleTargets.includes(value);\n    default:\n      return inputValueInDomain(domain, value);\n  }\n}\n\nfunction cardinalityErrors(\n  value: readonly unknown[],\n  min: number,\n  max: number | undefined,\n  unit: string,\n  ignoreMinimum = false,\n): string[] {\n  const errors: string[] = [];\n  if (!ignoreMinimum && value.length < min)\n    errors.push(`Choose at least ${min} ${pluralize(unit, min)}.`);\n  if (max !== undefined && value.length > max)\n    errors.push(`Choose at most ${max} ${pluralize(unit, max)}.`);\n  return errors;\n}\n\nfunction ineligibleMessage(domain: InputDomainDescriptor): string {\n  return domain.type === \"choice\" || domain.type === \"choiceList\"\n    ? \"Selected choice is not eligible.\"\n    : domain.type === \"cardTarget\" || domain.type === \"boardTarget\"\n      ? \"Selected target is not eligible.\"\n      : \"Value is outside the current input domain.\";\n}\n\n/** Matches the reducer's JSON value identity for projected distinct selections. */\nexport function inputValueKey(value: unknown): string {\n  if (value === null) return \"null\";\n  if (isPlayerBoardSpaceTarget(value))\n    return `player-board-space:${JSON.stringify([value.boardId, value.playerId, value.spaceId])}`;\n  switch (typeof value) {\n    case \"string\":\n      return `string:${value}`;\n    case \"number\":\n    case \"boolean\":\n    case \"undefined\":\n      return `${typeof value}:${String(value)}`;\n    default:\n      return `json:${JSON.stringify(value)}`;\n  }\n}\n\nfunction pluralize(word: string, count: number): string {\n  return count === 1 ? word : `${word}s`;\n}\n"],"mappings":"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","names":[]}