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

package/dist/chunk-XLHLFTLI.js

@@ -0,0 +1,399 @@
+import {
+  REFERENCE_GAME_SOURCE_MANIFEST_SCHEMA_VERSION,
+  parseReferenceGameSourceManifest
+} from "./chunk-45P5CEGH.js";
+import {
+  compareReferenceGameCanonicalStrings,
+  computeReferenceGameSourceFingerprint
+} from "./chunk-UNVCT5Z7.js";
+import {
+  WORKSPACE_CODEGEN_OWNERSHIP
+} from "./chunk-SACZWUA6.js";
+
+// src/reference-games/source-inventory-policy-core.mjs
+var CANONICAL_REFERENCE_GAME_IDS = Object.freeze([
+  "automa-river-rival",
+  "deck-building-market",
+  "hearts",
+  "hex-network-trading",
+  "multiplayer-ranking-and-ties",
+  "roll-and-write-scorecard",
+  "simultaneous-card-drafting",
+  "solo-countdown-puzzle",
+  "worker-placement-tableau"
+]);
+function createReferenceGameSourceInventoryPolicy(ownership) {
+  return Object.freeze({
+    schemaVersion: 1,
+    workspaceOwnershipVersion: ownership.version,
+    excludedGameRelativePaths: Object.freeze(
+      [...ownership.dynamic.generatedFiles].sort()
+    ),
+    excludedGameRelativePrefixes: Object.freeze(
+      [
+        ".dreamboard/",
+        ".turbo/",
+        "build/",
+        "coverage/",
+        "dist/",
+        "node_modules/",
+        "playwright-report/",
+        "test-results/",
+        "test/bases/",
+        "test/generated/",
+        "test/screenshots/"
+      ].sort()
+    )
+  });
+}
+function referenceGamePathIdentity(repositoryPath) {
+  const prefix = "examples/reference-games/";
+  if (!repositoryPath.startsWith(prefix)) return null;
+  const remainder = repositoryPath.slice(prefix.length);
+  const separator = remainder.indexOf("/");
+  if (separator < 1) return null;
+  const gameId = remainder.slice(0, separator);
+  if (!/^[a-z0-9][a-z0-9-]*$/u.test(gameId)) return null;
+  return { gameId, relativePath: remainder.slice(separator + 1) };
+}
+function classifyReferenceGameSourcePath(repositoryPath, policy) {
+  const identity = referenceGamePathIdentity(repositoryPath);
+  if (!identity) return "included";
+  if (policy.excludedGameRelativePaths.includes(identity.relativePath)) {
+    return "workspace-generated";
+  }
+  const matchedPrefix = policy.excludedGameRelativePrefixes.find(
+    (prefix) => identity.relativePath.startsWith(prefix)
+  );
+  if (!matchedPrefix) return "included";
+  if (matchedPrefix === "test/generated/") return "test-generated";
+  if (matchedPrefix === "test/bases/") return "test-base";
+  if (matchedPrefix === "test/screenshots/") return "obsolete-screenshot";
+  return "derived-output";
+}
+function shouldDescendIntoReferenceGameDirectory(repositoryPath, policy) {
+  const normalized = repositoryPath.endsWith("/") ? repositoryPath : `${repositoryPath}/`;
+  const identity = referenceGamePathIdentity(normalized);
+  if (!identity) return true;
+  return !policy.excludedGameRelativePrefixes.some(
+    (prefix) => identity.relativePath.startsWith(prefix)
+  );
+}
+
+// src/reference-games/source-inventory-policy.ts
+var REFERENCE_GAME_SOURCE_INVENTORY_POLICY = createReferenceGameSourceInventoryPolicy(WORKSPACE_CODEGEN_OWNERSHIP);
+function classifyReferenceGameSourcePath2(repositoryPath) {
+  return classifyReferenceGameSourcePath(repositoryPath, REFERENCE_GAME_SOURCE_INVENTORY_POLICY);
+}
+function isReferenceGameSourceObject(repositoryPath) {
+  return classifyReferenceGameSourcePath2(repositoryPath) === "included";
+}
+function shouldDescendIntoReferenceGameDirectory2(repositoryPath) {
+  return shouldDescendIntoReferenceGameDirectory(repositoryPath, REFERENCE_GAME_SOURCE_INVENTORY_POLICY);
+}
+
+// src/reference-games/source-collector.ts
+import { createHash } from "crypto";
+import { readFile, readdir, stat } from "fs/promises";
+import path from "path";
+async function collectReferenceGameSourceManifest(options) {
+  const sourceRoot = path.resolve(options.sourceRoot);
+  const referenceGamesRoot = path.join(sourceRoot, "examples/reference-games");
+  const gameIds = await listGameIds(referenceGamesRoot);
+  if (gameIds.length === 0) {
+    throw new Error("No reference-game packages were found.");
+  }
+  const objects = await collectReferenceGameSourceObjects({
+    referenceGamesRoot,
+    sourceRoot
+  });
+  const games = await Promise.all(
+    gameIds.map(async (gameId) => {
+      const gameRoot = path.join(referenceGamesRoot, gameId);
+      const metadata = await readJson(
+        path.join(gameRoot, "reference-game.json")
+      );
+      return buildGameEntry({
+        gameId,
+        gameRoot,
+        sourceRoot,
+        metadata,
+        objects
+      });
+    })
+  );
+  const payload = {
+    inventoryPolicy: {
+      schemaVersion: REFERENCE_GAME_SOURCE_INVENTORY_POLICY.schemaVersion,
+      workspaceOwnershipVersion: REFERENCE_GAME_SOURCE_INVENTORY_POLICY.workspaceOwnershipVersion,
+      excludedGameRelativePaths: [
+        ...REFERENCE_GAME_SOURCE_INVENTORY_POLICY.excludedGameRelativePaths
+      ],
+      excludedGameRelativePrefixes: [
+        ...REFERENCE_GAME_SOURCE_INVENTORY_POLICY.excludedGameRelativePrefixes
+      ]
+    },
+    games: games.sort(
+      (left, right) => compareReferenceGameCanonicalStrings(left.id, right.id)
+    ),
+    objects: objects.sort(
+      (left, right) => compareReferenceGameCanonicalStrings(left.path, right.path)
+    )
+  };
+  return parseReferenceGameSourceManifest({
+    schemaVersion: REFERENCE_GAME_SOURCE_MANIFEST_SCHEMA_VERSION,
+    manifestType: "dreamboard.reference-game-source",
+    sourceFingerprint: computeReferenceGameSourceFingerprint(payload),
+    payload,
+    provenance: options.provenance
+  });
+}
+async function collectReferenceGameSourceObjects(options) {
+  const files = await walkFiles(options.referenceGamesRoot, {
+    shouldDescend: (directory) => shouldDescendIntoReferenceGameDirectory2(
+      toPosix(path.relative(options.sourceRoot, directory))
+    )
+  });
+  const objects = [];
+  for (const relative of files) {
+    const absolute = path.join(options.referenceGamesRoot, relative);
+    const repositoryPath = toPosix(path.relative(options.sourceRoot, absolute));
+    if (!isReferenceGameSourceObject(repositoryPath)) continue;
+    const content = await readFile(absolute);
+    objects.push({
+      path: repositoryPath,
+      sha256: `sha256:${sha256Buffer(content)}`,
+      byteLength: content.length
+    });
+  }
+  return objects;
+}
+async function buildGameEntry(options) {
+  const root = `examples/reference-games/${options.gameId}`;
+  const workspace = objectValue(options.metadata.workspace);
+  const packageJsonPath = path.join(options.gameRoot, "package.json");
+  const lockfilePath = path.join(options.gameRoot, "pnpm-lock.yaml");
+  const packageJson = await readJson(packageJsonPath);
+  const sdkSpecifier = findSdkSpecifier(packageJson);
+  if (!sdkSpecifier) {
+    throw new Error(`${root}/package.json must declare @dreamboard-games/sdk.`);
+  }
+  const mechanics = stringArray(options.metadata.mechanics);
+  if (mechanics.length === 0) {
+    throw new Error(`${root}/reference-game.json must declare mechanics.`);
+  }
+  const teaching = objectValue(options.metadata.teaching);
+  const entry = {
+    id: options.gameId,
+    root,
+    sourceSha256: sourceSha256ForGameObjects(options.objects, root),
+    packageJsonSha256: `sha256:${await sha256File(packageJsonPath)}`,
+    lockfileSha256: `sha256:${await sha256File(lockfilePath)}`,
+    sdkSpecifier,
+    manifest: await firstExistingRelative(options.gameRoot, [
+      stringValue(workspace.manifest),
+      "manifest.ts",
+      "reference-game.json"
+    ]),
+    reducer: await firstExistingRelative(options.gameRoot, [
+      stringValue(workspace.reducer),
+      "app/game.ts"
+    ]),
+    ui: await firstExistingRelative(options.gameRoot, [
+      stringValue(workspace.ui),
+      "ui/index.tsx"
+    ]),
+    behaviorScenarios: stringArray(workspace.behaviorScenarios).length > 0 ? stringArray(workspace.behaviorScenarios) : await collectScenarioEntries(options.gameRoot, ["test/scenarios"]),
+    uiScenarios: stringArray(workspace.uiScenarios).length > 0 ? stringArray(workspace.uiScenarios) : await collectScenarioEntries(options.gameRoot, ["test/ui-scenarios"]),
+    mechanics,
+    readFirst: stringArray(teaching.readFirst).length > 0 ? stringArray(teaching.readFirst) : await deriveReadFirst(options.gameRoot, options.sourceRoot)
+  };
+  assertGameEntryPathsAreSourceObjects(entry, options.objects);
+  return entry;
+}
+function assertGameEntryPathsAreSourceObjects(entry, objects) {
+  const objectPaths = new Set(
+    objects.map(({ path: objectPath }) => objectPath)
+  );
+  const paths = [
+    entry.manifest,
+    entry.reducer,
+    entry.ui,
+    ...entry.behaviorScenarios,
+    ...entry.uiScenarios,
+    ...entry.readFirst
+  ];
+  for (const relativePath of paths) {
+    if (path.isAbsolute(relativePath) || relativePath.split(/[\\/]+/u).includes("..")) {
+      throw new Error(
+        `${entry.root} source entry must stay within the game root: ${relativePath}.`
+      );
+    }
+    const repositoryPath = path.posix.join(entry.root, toPosix(relativePath));
+    if (!objectPaths.has(repositoryPath)) {
+      throw new Error(
+        `${entry.root} source entry is missing from the authored object inventory: ${relativePath}.`
+      );
+    }
+  }
+}
+async function listGameIds(referenceGamesRoot) {
+  const entries = await readdir(referenceGamesRoot, { withFileTypes: true });
+  const discovered = [];
+  for (const entry of entries.filter(
+    (entry2) => entry2.isDirectory() && /^[a-z0-9][a-z0-9-]*$/u.test(entry2.name)
+  ).sort(
+    (left, right) => compareReferenceGameCanonicalStrings(left.name, right.name)
+  )) {
+    if (await isFile(
+      path.join(referenceGamesRoot, entry.name, "reference-game.json")
+    )) {
+      discovered.push(entry.name);
+    }
+  }
+  const expected = [...CANONICAL_REFERENCE_GAME_IDS];
+  const missing = expected.filter((gameId) => !discovered.includes(gameId));
+  const extra = discovered.filter((gameId) => !expected.includes(gameId));
+  if (missing.length > 0 || extra.length > 0) {
+    throw new Error(
+      `Reference-game identity mismatch (missing: ${missing.join(", ") || "none"}; extra: ${extra.join(", ") || "none"}).`
+    );
+  }
+  return expected;
+}
+async function deriveReadFirst(gameRoot, sourceRoot) {
+  const candidates = [
+    "README.md",
+    "rule.md",
+    "manifest.ts",
+    "app/game.ts",
+    "ui/index.tsx"
+  ];
+  const existing = [];
+  for (const candidate of candidates) {
+    if (await isFile(path.join(gameRoot, candidate))) existing.push(candidate);
+  }
+  if (existing.length === 0) {
+    throw new Error(
+      `${path.relative(sourceRoot, gameRoot)} must provide at least one readFirst file.`
+    );
+  }
+  return existing.slice(0, 5);
+}
+async function firstExistingRelative(root, candidates) {
+  const paths = candidates.filter(
+    (candidate) => typeof candidate === "string" && candidate.length > 0
+  );
+  for (const candidate of paths) {
+    if (path.isAbsolute(candidate) || candidate.includes("..")) {
+      throw new Error(`${candidate} must be a relative path within ${root}.`);
+    }
+    if (await isFile(path.join(root, candidate))) return candidate;
+  }
+  throw new Error(`${root} must provide one of: ${paths.join(", ")}`);
+}
+async function collectScenarioEntries(gameRoot, directories) {
+  for (const directory of directories) {
+    const absolute = path.join(gameRoot, directory);
+    if (!await isDirectory(absolute)) continue;
+    const files = (await walkFiles(absolute)).filter(
+      (relative) => relative.endsWith(".scenario.ts") || relative.endsWith(".scenario.mjs")
+    ).map((relative) => path.posix.join(directory, toPosix(relative)));
+    if (files.length > 0) return files;
+  }
+  throw new Error(`${gameRoot} must provide at least one scenario entry.`);
+}
+async function walkFiles(root, options = {}) {
+  const files = [];
+  async function visit(current) {
+    const entries = await readdir(current, { withFileTypes: true });
+    for (const entry of entries.sort(
+      (left, right) => compareReferenceGameCanonicalStrings(left.name, right.name)
+    )) {
+      const entryPath = path.join(current, entry.name);
+      if (entry.isDirectory()) {
+        if (!options.shouldDescend || options.shouldDescend(entryPath)) {
+          await visit(entryPath);
+        }
+      } else if (entry.isFile()) {
+        files.push(path.relative(root, entryPath));
+      }
+    }
+  }
+  await visit(root);
+  return files.sort();
+}
+async function readJson(filePath) {
+  const value = JSON.parse(await readFile(filePath, "utf8"));
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new Error(`${filePath} must contain a JSON object.`);
+  }
+  return value;
+}
+function findSdkSpecifier(packageJson) {
+  for (const group of ["dependencies", "devDependencies", "peerDependencies"]) {
+    const value = objectValue(packageJson[group])["@dreamboard-games/sdk"];
+    if (typeof value === "string" && value.length > 0) return value;
+  }
+  return null;
+}
+function objectValue(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function stringValue(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function stringArray(value) {
+  return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : [];
+}
+async function sha256File(filePath) {
+  return sha256Buffer(await readFile(filePath));
+}
+function sourceSha256ForGameObjects(objects, gameRoot) {
+  const hash = createHash("sha256");
+  hash.update("reference-game-authored-objects@1\0");
+  for (const object of objects.filter(({ path: objectPath }) => objectPath.startsWith(`${gameRoot}/`)).sort(
+    (left, right) => compareReferenceGameCanonicalStrings(left.path, right.path)
+  )) {
+    hash.update(object.path.slice(gameRoot.length + 1));
+    hash.update("\0");
+    hash.update(object.sha256);
+    hash.update("\0");
+    hash.update(String(object.byteLength));
+    hash.update("\0");
+  }
+  return `sha256:${hash.digest("hex")}`;
+}
+function sha256Buffer(buffer) {
+  return createHash("sha256").update(buffer).digest("hex");
+}
+async function isFile(filePath) {
+  return stat(filePath).then((value) => value.isFile()).catch((error) => {
+    if (isMissingPathError(error)) return false;
+    throw error;
+  });
+}
+async function isDirectory(filePath) {
+  return stat(filePath).then((value) => value.isDirectory()).catch((error) => {
+    if (isMissingPathError(error)) return false;
+    throw error;
+  });
+}
+function isMissingPathError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function toPosix(value) {
+  return value.split(path.sep).join("/");
+}
+
+export {
+  CANONICAL_REFERENCE_GAME_IDS,
+  referenceGamePathIdentity,
+  REFERENCE_GAME_SOURCE_INVENTORY_POLICY,
+  classifyReferenceGameSourcePath2 as classifyReferenceGameSourcePath,
+  isReferenceGameSourceObject,
+  shouldDescendIntoReferenceGameDirectory2 as shouldDescendIntoReferenceGameDirectory,
+  collectReferenceGameSourceManifest,
+  collectReferenceGameSourceObjects
+};
+//# sourceMappingURL=chunk-XLHLFTLI.js.map

package/dist/chunk-XLHLFTLI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/reference-games/source-inventory-policy-core.mjs","../src/reference-games/source-inventory-policy.ts","../src/reference-games/source-collector.ts"],"sourcesContent":["export const CANONICAL_REFERENCE_GAME_IDS = Object.freeze([\n  \"automa-river-rival\",\n  \"deck-building-market\",\n  \"hearts\",\n  \"hex-network-trading\",\n  \"multiplayer-ranking-and-ties\",\n  \"roll-and-write-scorecard\",\n  \"simultaneous-card-drafting\",\n  \"solo-countdown-puzzle\",\n  \"worker-placement-tableau\",\n]);\n\nexport function createReferenceGameSourceInventoryPolicy(ownership) {\n  return Object.freeze({\n    schemaVersion: 1,\n    workspaceOwnershipVersion: ownership.version,\n    excludedGameRelativePaths: Object.freeze(\n      [...ownership.dynamic.generatedFiles].sort(),\n    ),\n    excludedGameRelativePrefixes: Object.freeze(\n      [\n        \".dreamboard/\",\n        \".turbo/\",\n        \"build/\",\n        \"coverage/\",\n        \"dist/\",\n        \"node_modules/\",\n        \"playwright-report/\",\n        \"test-results/\",\n        \"test/bases/\",\n        \"test/generated/\",\n        \"test/screenshots/\",\n      ].sort(),\n    ),\n  });\n}\n\nexport function referenceGamePathIdentity(repositoryPath) {\n  const prefix = \"examples/reference-games/\";\n  if (!repositoryPath.startsWith(prefix)) return null;\n  const remainder = repositoryPath.slice(prefix.length);\n  const separator = remainder.indexOf(\"/\");\n  if (separator < 1) return null;\n  const gameId = remainder.slice(0, separator);\n  if (!/^[a-z0-9][a-z0-9-]*$/u.test(gameId)) return null;\n  return { gameId, relativePath: remainder.slice(separator + 1) };\n}\n\nexport function classifyReferenceGameSourcePath(repositoryPath, policy) {\n  const identity = referenceGamePathIdentity(repositoryPath);\n  if (!identity) return \"included\";\n  if (policy.excludedGameRelativePaths.includes(identity.relativePath)) {\n    return \"workspace-generated\";\n  }\n  const matchedPrefix = policy.excludedGameRelativePrefixes.find((prefix) =>\n    identity.relativePath.startsWith(prefix),\n  );\n  if (!matchedPrefix) return \"included\";\n  if (matchedPrefix === \"test/generated/\") return \"test-generated\";\n  if (matchedPrefix === \"test/bases/\") return \"test-base\";\n  if (matchedPrefix === \"test/screenshots/\") return \"obsolete-screenshot\";\n  return \"derived-output\";\n}\n\nexport function shouldDescendIntoReferenceGameDirectory(\n  repositoryPath,\n  policy,\n) {\n  const normalized = repositoryPath.endsWith(\"/\")\n    ? repositoryPath\n    : `${repositoryPath}/`;\n  const identity = referenceGamePathIdentity(normalized);\n  if (!identity) return true;\n  return !policy.excludedGameRelativePrefixes.some((prefix) =>\n    identity.relativePath.startsWith(prefix),\n  );\n}\n","import { WORKSPACE_CODEGEN_OWNERSHIP } from \"@dreamboard-games/workspace-codegen\";\n\nimport {\n  CANONICAL_REFERENCE_GAME_IDS,\n  classifyReferenceGameSourcePath as classifyPath,\n  createReferenceGameSourceInventoryPolicy,\n  referenceGamePathIdentity,\n  shouldDescendIntoReferenceGameDirectory as shouldDescend,\n  type ReferenceGameSourcePathClass,\n} from \"./source-inventory-policy-core.mjs\";\n\nexport const REFERENCE_GAME_SOURCE_INVENTORY_POLICY =\n  createReferenceGameSourceInventoryPolicy(WORKSPACE_CODEGEN_OWNERSHIP);\n\nexport {\n  CANONICAL_REFERENCE_GAME_IDS,\n  referenceGamePathIdentity,\n  type ReferenceGameSourcePathClass,\n};\n\nexport function classifyReferenceGameSourcePath(\n  repositoryPath: string,\n): ReferenceGameSourcePathClass {\n  return classifyPath(repositoryPath, REFERENCE_GAME_SOURCE_INVENTORY_POLICY);\n}\n\nexport function isReferenceGameSourceObject(repositoryPath: string): boolean {\n  return classifyReferenceGameSourcePath(repositoryPath) === \"included\";\n}\n\nexport function shouldDescendIntoReferenceGameDirectory(\n  repositoryPath: string,\n): boolean {\n  return shouldDescend(repositoryPath, REFERENCE_GAME_SOURCE_INVENTORY_POLICY);\n}\n","import { createHash } from \"node:crypto\";\nimport { readFile, readdir, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n  REFERENCE_GAME_SOURCE_MANIFEST_SCHEMA_VERSION,\n  parseReferenceGameSourceManifest,\n  type ReferenceGameSourceManifest,\n  type ReferenceGameSourceProvenance,\n} from \"./schema.js\";\nimport {\n  compareReferenceGameCanonicalStrings,\n  computeReferenceGameSourceFingerprint,\n} from \"./canonical.js\";\nimport {\n  CANONICAL_REFERENCE_GAME_IDS,\n  REFERENCE_GAME_SOURCE_INVENTORY_POLICY,\n  isReferenceGameSourceObject,\n  shouldDescendIntoReferenceGameDirectory,\n} from \"./source-inventory-policy.js\";\n\nexport {\n  CANONICAL_REFERENCE_GAME_IDS,\n  REFERENCE_GAME_SOURCE_INVENTORY_POLICY,\n  classifyReferenceGameSourcePath,\n  isReferenceGameSourceObject,\n  referenceGamePathIdentity,\n  shouldDescendIntoReferenceGameDirectory,\n  type ReferenceGameSourcePathClass,\n} from \"./source-inventory-policy.js\";\n\nexport async function collectReferenceGameSourceManifest(options: {\n  readonly sourceRoot: string;\n  readonly provenance: ReferenceGameSourceProvenance;\n}): Promise<ReferenceGameSourceManifest> {\n  const sourceRoot = path.resolve(options.sourceRoot);\n  const referenceGamesRoot = path.join(sourceRoot, \"examples/reference-games\");\n  const gameIds = await listGameIds(referenceGamesRoot);\n  if (gameIds.length === 0) {\n    throw new Error(\"No reference-game packages were found.\");\n  }\n  const objects = await collectReferenceGameSourceObjects({\n    referenceGamesRoot,\n    sourceRoot,\n  });\n  const games = await Promise.all(\n    gameIds.map(async (gameId) => {\n      const gameRoot = path.join(referenceGamesRoot, gameId);\n      const metadata = await readJson(\n        path.join(gameRoot, \"reference-game.json\"),\n      );\n      return buildGameEntry({\n        gameId,\n        gameRoot,\n        sourceRoot,\n        metadata,\n        objects,\n      });\n    }),\n  );\n  const payload = {\n    inventoryPolicy: {\n      schemaVersion: REFERENCE_GAME_SOURCE_INVENTORY_POLICY.schemaVersion,\n      workspaceOwnershipVersion:\n        REFERENCE_GAME_SOURCE_INVENTORY_POLICY.workspaceOwnershipVersion,\n      excludedGameRelativePaths: [\n        ...REFERENCE_GAME_SOURCE_INVENTORY_POLICY.excludedGameRelativePaths,\n      ],\n      excludedGameRelativePrefixes: [\n        ...REFERENCE_GAME_SOURCE_INVENTORY_POLICY.excludedGameRelativePrefixes,\n      ],\n    },\n    games: games.sort((left, right) =>\n      compareReferenceGameCanonicalStrings(left.id, right.id),\n    ),\n    objects: objects.sort((left, right) =>\n      compareReferenceGameCanonicalStrings(left.path, right.path),\n    ),\n  };\n  return parseReferenceGameSourceManifest({\n    schemaVersion: REFERENCE_GAME_SOURCE_MANIFEST_SCHEMA_VERSION,\n    manifestType: \"dreamboard.reference-game-source\",\n    sourceFingerprint: computeReferenceGameSourceFingerprint(payload),\n    payload,\n    provenance: options.provenance,\n  });\n}\n\nexport async function collectReferenceGameSourceObjects(options: {\n  readonly referenceGamesRoot: string;\n  readonly sourceRoot: string;\n}): Promise<\n  Array<{\n    readonly path: string;\n    readonly sha256: string;\n    readonly byteLength: number;\n  }>\n> {\n  const files = await walkFiles(options.referenceGamesRoot, {\n    shouldDescend: (directory) =>\n      shouldDescendIntoReferenceGameDirectory(\n        toPosix(path.relative(options.sourceRoot, directory)),\n      ),\n  });\n  const objects = [];\n  for (const relative of files) {\n    const absolute = path.join(options.referenceGamesRoot, relative);\n    const repositoryPath = toPosix(path.relative(options.sourceRoot, absolute));\n    if (!isReferenceGameSourceObject(repositoryPath)) continue;\n    const content = await readFile(absolute);\n    objects.push({\n      path: repositoryPath,\n      sha256: `sha256:${sha256Buffer(content)}`,\n      byteLength: content.length,\n    });\n  }\n  return objects;\n}\n\nasync function buildGameEntry(options: {\n  readonly gameId: string;\n  readonly gameRoot: string;\n  readonly sourceRoot: string;\n  readonly metadata: Record<string, unknown>;\n  readonly objects: readonly {\n    readonly path: string;\n    readonly sha256: string;\n    readonly byteLength: number;\n  }[];\n}) {\n  const root = `examples/reference-games/${options.gameId}`;\n  const workspace = objectValue(options.metadata.workspace);\n  const packageJsonPath = path.join(options.gameRoot, \"package.json\");\n  const lockfilePath = path.join(options.gameRoot, \"pnpm-lock.yaml\");\n  const packageJson = await readJson(packageJsonPath);\n  const sdkSpecifier = findSdkSpecifier(packageJson);\n  if (!sdkSpecifier) {\n    throw new Error(`${root}/package.json must declare @dreamboard-games/sdk.`);\n  }\n  const mechanics = stringArray(options.metadata.mechanics);\n  if (mechanics.length === 0) {\n    throw new Error(`${root}/reference-game.json must declare mechanics.`);\n  }\n  const teaching = objectValue(options.metadata.teaching);\n  const entry = {\n    id: options.gameId,\n    root,\n    sourceSha256: sourceSha256ForGameObjects(options.objects, root),\n    packageJsonSha256: `sha256:${await sha256File(packageJsonPath)}`,\n    lockfileSha256: `sha256:${await sha256File(lockfilePath)}`,\n    sdkSpecifier,\n    manifest: await firstExistingRelative(options.gameRoot, [\n      stringValue(workspace.manifest),\n      \"manifest.ts\",\n      \"reference-game.json\",\n    ]),\n    reducer: await firstExistingRelative(options.gameRoot, [\n      stringValue(workspace.reducer),\n      \"app/game.ts\",\n    ]),\n    ui: await firstExistingRelative(options.gameRoot, [\n      stringValue(workspace.ui),\n      \"ui/index.tsx\",\n    ]),\n    behaviorScenarios:\n      stringArray(workspace.behaviorScenarios).length > 0\n        ? stringArray(workspace.behaviorScenarios)\n        : await collectScenarioEntries(options.gameRoot, [\"test/scenarios\"]),\n    uiScenarios:\n      stringArray(workspace.uiScenarios).length > 0\n        ? stringArray(workspace.uiScenarios)\n        : await collectScenarioEntries(options.gameRoot, [\"test/ui-scenarios\"]),\n    mechanics,\n    readFirst:\n      stringArray(teaching.readFirst).length > 0\n        ? stringArray(teaching.readFirst)\n        : await deriveReadFirst(options.gameRoot, options.sourceRoot),\n  };\n  assertGameEntryPathsAreSourceObjects(entry, options.objects);\n  return entry;\n}\n\nfunction assertGameEntryPathsAreSourceObjects(\n  entry: {\n    readonly root: string;\n    readonly manifest: string;\n    readonly reducer: string;\n    readonly ui: string;\n    readonly behaviorScenarios: readonly string[];\n    readonly uiScenarios: readonly string[];\n    readonly readFirst: readonly string[];\n  },\n  objects: readonly { readonly path: string }[],\n): void {\n  const objectPaths = new Set(\n    objects.map(({ path: objectPath }) => objectPath),\n  );\n  const paths = [\n    entry.manifest,\n    entry.reducer,\n    entry.ui,\n    ...entry.behaviorScenarios,\n    ...entry.uiScenarios,\n    ...entry.readFirst,\n  ];\n  for (const relativePath of paths) {\n    if (\n      path.isAbsolute(relativePath) ||\n      relativePath.split(/[\\\\/]+/u).includes(\"..\")\n    ) {\n      throw new Error(\n        `${entry.root} source entry must stay within the game root: ${relativePath}.`,\n      );\n    }\n    const repositoryPath = path.posix.join(entry.root, toPosix(relativePath));\n    if (!objectPaths.has(repositoryPath)) {\n      throw new Error(\n        `${entry.root} source entry is missing from the authored object inventory: ${relativePath}.`,\n      );\n    }\n  }\n}\n\nasync function listGameIds(referenceGamesRoot: string): Promise<string[]> {\n  const entries = await readdir(referenceGamesRoot, { withFileTypes: true });\n  const discovered: string[] = [];\n  for (const entry of entries\n    .filter(\n      (entry) =>\n        entry.isDirectory() && /^[a-z0-9][a-z0-9-]*$/u.test(entry.name),\n    )\n    .sort((left, right) =>\n      compareReferenceGameCanonicalStrings(left.name, right.name),\n    )) {\n    if (\n      await isFile(\n        path.join(referenceGamesRoot, entry.name, \"reference-game.json\"),\n      )\n    ) {\n      discovered.push(entry.name);\n    }\n  }\n  const expected = [...CANONICAL_REFERENCE_GAME_IDS];\n  const missing = expected.filter((gameId) => !discovered.includes(gameId));\n  const extra = discovered.filter((gameId) => !expected.includes(gameId));\n  if (missing.length > 0 || extra.length > 0) {\n    throw new Error(\n      `Reference-game identity mismatch (missing: ${missing.join(\", \") || \"none\"}; extra: ${extra.join(\", \") || \"none\"}).`,\n    );\n  }\n  return expected;\n}\n\nasync function deriveReadFirst(gameRoot: string, sourceRoot: string) {\n  const candidates = [\n    \"README.md\",\n    \"rule.md\",\n    \"manifest.ts\",\n    \"app/game.ts\",\n    \"ui/index.tsx\",\n  ];\n  const existing = [];\n  for (const candidate of candidates) {\n    if (await isFile(path.join(gameRoot, candidate))) existing.push(candidate);\n  }\n  if (existing.length === 0) {\n    throw new Error(\n      `${path.relative(sourceRoot, gameRoot)} must provide at least one readFirst file.`,\n    );\n  }\n  return existing.slice(0, 5);\n}\n\nasync function firstExistingRelative(root: string, candidates: unknown[]) {\n  const paths = candidates.filter(\n    (candidate): candidate is string =>\n      typeof candidate === \"string\" && candidate.length > 0,\n  );\n  for (const candidate of paths) {\n    if (path.isAbsolute(candidate) || candidate.includes(\"..\")) {\n      throw new Error(`${candidate} must be a relative path within ${root}.`);\n    }\n    if (await isFile(path.join(root, candidate))) return candidate;\n  }\n  throw new Error(`${root} must provide one of: ${paths.join(\", \")}`);\n}\n\nasync function collectScenarioEntries(gameRoot: string, directories: string[]) {\n  for (const directory of directories) {\n    const absolute = path.join(gameRoot, directory);\n    if (!(await isDirectory(absolute))) continue;\n    const files = (await walkFiles(absolute))\n      .filter(\n        (relative) =>\n          relative.endsWith(\".scenario.ts\") ||\n          relative.endsWith(\".scenario.mjs\"),\n      )\n      .map((relative) => path.posix.join(directory, toPosix(relative)));\n    if (files.length > 0) return files;\n  }\n  throw new Error(`${gameRoot} must provide at least one scenario entry.`);\n}\n\nasync function walkFiles(\n  root: string,\n  options: { readonly shouldDescend?: (directory: string) => boolean } = {},\n): Promise<string[]> {\n  const files: string[] = [];\n  async function visit(current: string) {\n    const entries = await readdir(current, { withFileTypes: true });\n    for (const entry of entries.sort((left, right) =>\n      compareReferenceGameCanonicalStrings(left.name, right.name),\n    )) {\n      const entryPath = path.join(current, entry.name);\n      if (entry.isDirectory()) {\n        if (!options.shouldDescend || options.shouldDescend(entryPath)) {\n          await visit(entryPath);\n        }\n      } else if (entry.isFile()) {\n        files.push(path.relative(root, entryPath));\n      }\n    }\n  }\n  await visit(root);\n  return files.sort();\n}\n\nasync function readJson(filePath: string): Promise<Record<string, unknown>> {\n  const value = JSON.parse(await readFile(filePath, \"utf8\")) as unknown;\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new Error(`${filePath} must contain a JSON object.`);\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction findSdkSpecifier(packageJson: Record<string, unknown>): string | null {\n  for (const group of [\"dependencies\", \"devDependencies\", \"peerDependencies\"]) {\n    const value = objectValue(packageJson[group])[\"@dreamboard-games/sdk\"];\n    if (typeof value === \"string\" && value.length > 0) return value;\n  }\n  return null;\n}\n\nfunction objectValue(value: unknown): Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nfunction stringArray(value: unknown): string[] {\n  return Array.isArray(value) && value.every((item) => typeof item === \"string\")\n    ? value\n    : [];\n}\n\nasync function sha256File(filePath: string): Promise<string> {\n  return sha256Buffer(await readFile(filePath));\n}\n\nfunction sourceSha256ForGameObjects(\n  objects: readonly {\n    readonly path: string;\n    readonly sha256: string;\n    readonly byteLength: number;\n  }[],\n  gameRoot: string,\n) {\n  const hash = createHash(\"sha256\");\n  hash.update(\"reference-game-authored-objects@1\\0\");\n  for (const object of objects\n    .filter(({ path: objectPath }) => objectPath.startsWith(`${gameRoot}/`))\n    .sort((left, right) =>\n      compareReferenceGameCanonicalStrings(left.path, right.path),\n    )) {\n    hash.update(object.path.slice(gameRoot.length + 1));\n    hash.update(\"\\0\");\n    hash.update(object.sha256);\n    hash.update(\"\\0\");\n    hash.update(String(object.byteLength));\n    hash.update(\"\\0\");\n  }\n  return `sha256:${hash.digest(\"hex\")}`;\n}\n\nfunction sha256Buffer(buffer: Uint8Array): string {\n  return createHash(\"sha256\").update(buffer).digest(\"hex\");\n}\n\nasync function isFile(filePath: string): Promise<boolean> {\n  return stat(filePath)\n    .then((value) => value.isFile())\n    .catch((error: unknown) => {\n      if (isMissingPathError(error)) return false;\n      throw error;\n    });\n}\n\nasync function isDirectory(filePath: string): Promise<boolean> {\n  return stat(filePath)\n    .then((value) => value.isDirectory())\n    .catch((error: unknown) => {\n      if (isMissingPathError(error)) return false;\n      throw error;\n    });\n}\n\nfunction isMissingPathError(error: unknown): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as { readonly code?: unknown }).code === \"ENOENT\"\n  );\n}\n\nfunction toPosix(value: string): string {\n  return value.split(path.sep).join(\"/\");\n}\n"],"mappings":"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","names":["classifyReferenceGameSourcePath","shouldDescendIntoReferenceGameDirectory","shouldDescendIntoReferenceGameDirectory","entry"]}

package/dist/{chunk-B2YBS3SG.js → chunk-YNW3KBDE.js}

@@ -1,3 +1,7 @@
+import {
+  zod_exports
+} from "./chunk-3PFDHTR7.js";
+
 // src/reducer/model/manifest.ts
 import { z } from "zod";
 function toNonEmptyStringTuple(values) {
@@ -7,17 +11,23 @@ function toNonEmptyStringTuple(values) {
   }
   return [first, ...rest];
 }
-var manifestScopedSchemas = /* @__PURE__ */ new WeakSet();
-function markManifestScopedSchema(schema) {
-  manifestScopedSchemas.add(schema);
+var manifestScopedSchemas = /* @__PURE__ */ new WeakMap();
+function markManifestScopedSchema(schema, family) {
+  manifestScopedSchemas.set(schema, family);
   return schema;
 }
 function isManifestScopedSchema(schema) {
   return typeof schema === "object" && schema !== null && manifestScopedSchemas.has(schema);
 }
-function createManifestStringLiteralSchema(values) {
+function manifestSchemaFamily(schema) {
+  if (typeof schema !== "object" || schema === null) {
+    return void 0;
+  }
+  return manifestScopedSchemas.get(schema);
+}
+function createManifestStringLiteralSchema(values, family) {
   const schema = values.length === 0 ? z.string() : z.enum(toNonEmptyStringTuple(values));
-  return markManifestScopedSchema(schema);
+  return markManifestScopedSchema(schema, family);
 }
 function assumeManifestSchema(schema) {
   return schema;
@@ -57,11 +67,13 @@ function createManifestRuntimeSchema({
     rng: z.object({
       seed: z.number().nullable().optional(),
       cursor: z.number().int().default(0),
-      trace: z.array(z.string()).default([])
+      trace: z.array(z.string()).default([]),
+      draws: z.array(zod_exports.RngDrawSchema).default([])
     }).default({
       seed: null,
       cursor: 0,
-      trace: []
+      trace: [],
+      draws: []
     }),
     setup: z.object({
       profileId: setupProfileIdSchema,
@@ -122,6 +134,7 @@ var FrameworkErrorCodes = {
   NOT_YOUR_TURN: "NOT_YOUR_TURN",
   WRONG_PHASE: "WRONG_PHASE",
   WRONG_STEP: "WRONG_STEP",
+  NO_LEGAL_INPUT: "NO_LEGAL_INPUT",
   INVALID_PARAMS: "INVALID_PARAMS",
   UNKNOWN_INTERACTION: "UNKNOWN_INTERACTION",
   INTERNAL_ERROR: "INTERNAL_ERROR"
@@ -2275,13 +2288,25 @@ function dealCardsFromDeckToHandInPlace(table, fromZoneId, playerId, toZoneId, c
 }
 
 // src/reducer/rng.ts
-function nextRandomInt(bound, rng) {
-  if (bound <= 0) {
-    throw new Error("Random bound must be positive.");
+function nextRandomInt(bound, rng, operation = {
+  kind: "integer",
+  parameters: { minInclusive: 0, maxInclusive: bound - 1 }
+}) {
+  if (!Number.isSafeInteger(bound) || bound <= 0) {
+    throw new Error("Random bound must be a positive safe integer.");
   }
   const seed = rng.seed ?? 1;
   const raw = hashSeedCursor(seed, rng.cursor);
   const value = raw % bound;
+  const draw = {
+    index: rng.draws.length,
+    cursorBefore: rng.cursor,
+    cursorAfter: rng.cursor + 1,
+    operation: {
+      kind: operation.kind,
+      parameters: { ...operation.parameters }
+    }
+  };
   return [
     value,
     {
@@ -2290,8 +2315,10 @@ function nextRandomInt(bound, rng) {
       trace: [
         ...rng.trace,
         `cursor=${rng.cursor};bound=${bound};value=${value}`
-      ]
-    }
+      ],
+      draws: [...rng.draws, draw]
+    },
+    draw
   ];
 }
 function hashSeedCursor(seed, cursor) {
@@ -2738,6 +2765,7 @@ function collectReducerDefinitionIndex(definition) {
 export {
   markManifestScopedSchema,
   isManifestScopedSchema,
+  manifestSchemaFamily,
   createManifestStringLiteralSchema,
   assumeManifestSchema,
   cloneManifestDefault,
@@ -2872,4 +2900,4 @@ export {
   collectReducerDefinitionIndex,
   applySetupBootstrap
 };
-//# sourceMappingURL=chunk-B2YBS3SG.js.map
+//# sourceMappingURL=chunk-YNW3KBDE.js.map