@eigeninteractive/testkit 0.4.1 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{chunk-JJW4WLTM.js → chunk-BQIY636F.js} +41 -11
- package/dist/chunk-BQIY636F.js.map +1 -0
- package/dist/contract-cli.d.ts +1 -0
- package/dist/contract-cli.js +1 -1
- package/dist/contract-command.d.ts +13 -0
- package/dist/game-contract.d.ts +58 -0
- package/dist/index.d.ts +8 -234
- package/dist/index.js +1 -1
- package/dist/inspect-cli.d.ts +15 -0
- package/dist/kernel-scenarios.d.ts +27 -0
- package/dist/local-state.d.ts +13 -17
- package/dist/twin-fixtures.d.ts +145 -0
- package/package.json +5 -5
- package/dist/chunk-JJW4WLTM.js.map +0 -1
|
@@ -79,6 +79,18 @@ function parseRatingPoolCase(where, raw) {
|
|
|
79
79
|
expected: raw.expected === null ? null : asString(`${where}.expected`, raw.expected)
|
|
80
80
|
};
|
|
81
81
|
}
|
|
82
|
+
function parsePlayerLimitsCase(where, raw) {
|
|
83
|
+
const expected = asObject(`${where}.expected`, raw.expected);
|
|
84
|
+
return {
|
|
85
|
+
kind: "playerLimits",
|
|
86
|
+
name: asString(`${where}.name`, raw.name),
|
|
87
|
+
config: asObject(`${where}.config`, raw.config),
|
|
88
|
+
expected: {
|
|
89
|
+
minPlayers: asNumber(`${where}.expected.minPlayers`, expected.minPlayers),
|
|
90
|
+
maxPlayers: asNumber(`${where}.expected.maxPlayers`, expected.maxPlayers)
|
|
91
|
+
}
|
|
92
|
+
};
|
|
93
|
+
}
|
|
82
94
|
function parseBotSeatableCase(where, raw) {
|
|
83
95
|
return {
|
|
84
96
|
kind: "botSeatable",
|
|
@@ -99,12 +111,14 @@ function parseTwinFixtureFile(path, json) {
|
|
|
99
111
|
switch (obj.kind) {
|
|
100
112
|
case "action":
|
|
101
113
|
return parseActionCase(where, obj);
|
|
114
|
+
case "playerLimits":
|
|
115
|
+
return parsePlayerLimitsCase(where, obj);
|
|
102
116
|
case "ratingPool":
|
|
103
117
|
return parseRatingPoolCase(where, obj);
|
|
104
118
|
case "botSeatable":
|
|
105
119
|
return parseBotSeatableCase(where, obj);
|
|
106
120
|
default:
|
|
107
|
-
throw new Error(`${where}.kind: expected one of action | ratingPool | botSeatable, got ${JSON.stringify(obj.kind)}`);
|
|
121
|
+
throw new Error(`${where}.kind: expected one of action | playerLimits | ratingPool | botSeatable, got ${JSON.stringify(obj.kind)}`);
|
|
108
122
|
}
|
|
109
123
|
});
|
|
110
124
|
return { schemaVersion, cases };
|
|
@@ -113,12 +127,14 @@ function evaluateTwinCase(rules, kase) {
|
|
|
113
127
|
switch (kase.kind) {
|
|
114
128
|
case "action":
|
|
115
129
|
return evaluateAction(rules, kase);
|
|
130
|
+
case "playerLimits":
|
|
131
|
+
return evaluatePlayerLimits(rules, kase);
|
|
116
132
|
case "ratingPool":
|
|
117
133
|
return evaluateRatingPool(rules, kase);
|
|
118
134
|
case "botSeatable":
|
|
119
135
|
return evaluateBotSeatable(rules, kase);
|
|
120
136
|
default:
|
|
121
|
-
return [`unknown case kind "${kase.kind}", expected action | ratingPool | botSeatable`];
|
|
137
|
+
return [`unknown case kind "${kase.kind}", expected action | playerLimits | ratingPool | botSeatable`];
|
|
122
138
|
}
|
|
123
139
|
}
|
|
124
140
|
function twinFixtureTests(gameModule, fixturesRoot) {
|
|
@@ -240,6 +256,16 @@ function evaluateRatingPool(rules, kase) {
|
|
|
240
256
|
}
|
|
241
257
|
return failures;
|
|
242
258
|
}
|
|
259
|
+
function evaluatePlayerLimits(rules, kase) {
|
|
260
|
+
const failures = [];
|
|
261
|
+
const config = parseWith(rules, "config", kase.config, failures);
|
|
262
|
+
if (config === void 0) return failures;
|
|
263
|
+
const limits = rules.playerLimits({ config });
|
|
264
|
+
if (limits.minPlayers !== kase.expected.minPlayers || limits.maxPlayers !== kase.expected.maxPlayers) {
|
|
265
|
+
failures.push(`playerLimits returned ${limits.minPlayers}-${limits.maxPlayers}, fixture expects ${kase.expected.minPlayers}-${kase.expected.maxPlayers}`);
|
|
266
|
+
}
|
|
267
|
+
return failures;
|
|
268
|
+
}
|
|
243
269
|
function evaluateBotSeatable(rules, kase) {
|
|
244
270
|
const failures = [];
|
|
245
271
|
const gameConfig = parseWith(rules, "config", kase.gameConfig, failures);
|
|
@@ -298,23 +324,27 @@ function deepEquals(a, b) {
|
|
|
298
324
|
// src/game-contract.ts
|
|
299
325
|
import { existsSync, readdirSync as readdirSync2, readFileSync as readFileSync2, writeFileSync } from "node:fs";
|
|
300
326
|
import { basename, relative, resolve } from "node:path";
|
|
327
|
+
import { assertPortableSchema } from "@eigeninteractive/rules";
|
|
301
328
|
var GAME_CONTRACT_FORMAT_VERSION = 1;
|
|
302
329
|
function canonical(value) {
|
|
303
330
|
if (Array.isArray(value)) return value.map(canonical);
|
|
304
331
|
if (value !== null && typeof value === "object") {
|
|
305
332
|
return Object.fromEntries(
|
|
306
|
-
Object.entries(value).sort(([a], [b]) => a
|
|
333
|
+
Object.entries(value).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, item]) => [key, canonical(item)])
|
|
307
334
|
);
|
|
308
335
|
}
|
|
309
336
|
return value;
|
|
310
337
|
}
|
|
311
|
-
function jsonSchema(schema, label
|
|
338
|
+
function jsonSchema(schema, label) {
|
|
312
339
|
const options = { target: "draft-2020-12" };
|
|
340
|
+
let emitted;
|
|
313
341
|
try {
|
|
314
|
-
|
|
342
|
+
emitted = canonical(schema["~standard"].jsonSchema.output(options));
|
|
315
343
|
} catch (error) {
|
|
316
|
-
throw new Error(`${label} cannot emit its
|
|
344
|
+
throw new Error(`${label} cannot emit its type as draft-2020-12 JSON Schema`, { cause: error });
|
|
317
345
|
}
|
|
346
|
+
assertPortableSchema(emitted, label);
|
|
347
|
+
return emitted;
|
|
318
348
|
}
|
|
319
349
|
function fixtureFiles2(root) {
|
|
320
350
|
const found = [];
|
|
@@ -361,10 +391,10 @@ function buildGameContract(options) {
|
|
|
361
391
|
version,
|
|
362
392
|
{
|
|
363
393
|
schemas: {
|
|
364
|
-
state: jsonSchema(rules.schemas.state, `v${version} state
|
|
365
|
-
observation: jsonSchema(rules.schemas.observation, `v${version} observation
|
|
366
|
-
action: jsonSchema(rules.schemas.action, `v${version} action
|
|
367
|
-
config: jsonSchema(rules.schemas.config, `v${version} config
|
|
394
|
+
state: jsonSchema(rules.schemas.state, `v${version} state`),
|
|
395
|
+
observation: jsonSchema(rules.schemas.observation, `v${version} observation`),
|
|
396
|
+
action: jsonSchema(rules.schemas.action, `v${version} action`),
|
|
397
|
+
config: jsonSchema(rules.schemas.config, `v${version} config`)
|
|
368
398
|
}
|
|
369
399
|
}
|
|
370
400
|
])
|
|
@@ -450,4 +480,4 @@ export {
|
|
|
450
480
|
emitConfiguredGameContract,
|
|
451
481
|
checkConfiguredGameContract
|
|
452
482
|
};
|
|
453
|
-
//# sourceMappingURL=chunk-
|
|
483
|
+
//# sourceMappingURL=chunk-BQIY636F.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/twin-fixtures.ts","../src/game-contract.ts","../src/contract-command.ts"],"sourcesContent":["/**\n * Twin-drift fixture runner: the TS half of the shared JSON fixtures that\n * keep a version unit's TS and Dart `GameRules` twins in sync. The JSON\n * fixture format is shared verbatim with the Dart runner\n * (`lib/testing/twin_fixtures.dart`): one file, two consumers.\n *\n * One fixture file per concern lives beside the version units at\n * `<fixturesRoot>/v<N>/*.json` and is consumed by BOTH sides: this module\n * runs each case against the TS unit (schemas + `applyAction` +\n * `computeObservation` + the two predicates), while the Dart runner runs the\n * same file against the Dart twin (generated payload parsing,\n * `isValidAction`, `previewAction`, predicate twins). A behavioral divergence\n * then fails one side's CI instead of degrading UX in production.\n *\n * ## Fixture file format\n *\n * ```jsonc\n * {\n * \"schemaVersion\": 1,\n * \"cases\": [\n * {\n * \"kind\": \"action\",\n * \"name\": \"seat 0 marks an empty cell\",\n * \"config\": {},\n * \"state\": { ... }, // TS: applyAction input\n * \"obs\": { ... }, // Dart-only; defaults to `state`\n * \"pending\": [0],\n * \"playerIndex\": 0,\n * \"participantCount\": 2, // optional, default 2\n * \"rngSeed\": \"any string\", // optional, default \"twin-fixtures\"\n * \"action\": { ... },\n * \"expected\": {\n * \"valid\": true, // false ⇒ TS IllegalMoveError,\n * // Dart isValidAction false\n * \"state\": { ... }, // optional, TS envelope.state\n * \"pending\": [1], // optional, TS envelope.pendingPlayers\n * \"outcome\": [ ... ], // optional, TS envelope.outcome\n * // (null asserts the game is ongoing)\n * \"observation\": { ... } // optional, the actor's post-action\n * // view: TS computeObservation slice\n * // data; Dart previewAction (when the\n * // game implements optimism)\n * }\n * },\n * { \"kind\": \"playerLimits\", \"name\": \"...\", \"config\": {},\n * \"expected\": { \"minPlayers\": 2, \"maxPlayers\": 2 } },\n * { \"kind\": \"ratingPool\", \"name\": \"...\", \"access\": \"public\",\n * \"minPlayers\": 2, \"maxPlayers\": 2, \"config\": {}, \"expected\": \"blitz\" },\n * { \"kind\": \"botSeatable\", \"name\": \"...\", \"gameConfig\": {},\n * \"botConfig\": {}, \"expected\": false }\n * ]\n * }\n * ```\n *\n * The `state`/`obs` split exists for hidden-info games (a seat's observation\n * is not the state); perfect-info games omit `obs`. `expected.observation` is\n * the shared behavioral anchor: the TS side must project the post-action\n * state to it, and a Dart `previewAction` that returns non-null must predict\n * it, so the two sides are compared through one recorded value.\n *\n * Wire it up in a game-owned test file running under plain-Node vitest:\n *\n * ```ts\n * import { twinFixtureTests } from \"@eigeninteractive/testkit\";\n * import gameModule from \"../src/module/index.js\";\n *\n * twinFixtureTests(gameModule, new URL(\"../src/module/fixtures/\", import.meta.url));\n * ```\n */\n\nimport { readdirSync, readFileSync } from \"node:fs\";\nimport { type Envelope, type GameAccess, type GameModule, type GameRules, IllegalMoveError, type Json, type JsonObject, type ObservationSlice, type OutcomeEntry } from \"@eigeninteractive/rules\";\nimport Rand from \"rand-seed\";\nimport { it } from \"vitest\";\n\n/** One fixture file: cases targeting one `schemaVersion` unit. */\nexport interface TwinFixtureFile {\n schemaVersion: number;\n cases: TwinFixtureCase[];\n}\n\n/** A game-action case: exercises schemas, `applyAction`, and (through\n * `expected.observation`) `computeObservation` for the acting seat. */\nexport interface ActionCase {\n kind: \"action\";\n name: string;\n config: JsonObject;\n state: JsonObject;\n /** Dart-side observation payload; unused here (defaults to `state`). */\n obs?: JsonObject;\n pending: number[];\n playerIndex: number;\n participantCount?: number;\n rngSeed?: string;\n action: JsonObject;\n expected: {\n valid: boolean;\n state?: JsonObject;\n pending?: number[];\n outcome?: OutcomeEntry[] | null;\n observation?: JsonObject;\n };\n}\n\n/** A `ratingPool` predicate case. Omitted timing fields mean null. */\nexport interface RatingPoolCase {\n kind: \"ratingPool\";\n name: string;\n access: GameAccess;\n turnSeconds?: number | null;\n budgetSeconds?: number | null;\n incrementSeconds?: number | null;\n minPlayers: number;\n maxPlayers: number;\n config: JsonObject;\n expected: string | null;\n}\n\n/** A `playerLimits` case: the seats one config may be played with. */\nexport interface PlayerLimitsCase {\n kind: \"playerLimits\";\n name: string;\n config: JsonObject;\n expected: { minPlayers: number; maxPlayers: number };\n}\n\n/** A `botSeatable` predicate case. */\nexport interface BotSeatableCase {\n kind: \"botSeatable\";\n name: string;\n gameConfig: JsonObject;\n botConfig: JsonObject;\n expected: boolean;\n}\n\nexport type TwinFixtureCase = ActionCase | PlayerLimitsCase | RatingPoolCase | BotSeatableCase;\n\n// ── Fixture validation ────────────────────────────────────────────────────────\n//\n// The case types above are compile-time only; the JSON they describe arrives\n// at runtime from a hand-written file. Asserting `JSON.parse(...) as\n// TwinFixtureFile` would make every field a lie the moment a fixture is\n// mistyped, and because most fields flow straight into a comparison, the\n// symptom would be a confusing `undefined` diff attributed to the game's\n// rules rather than to the fixture. These parsers close that gap: a\n// malformed fixture fails at LOAD, naming the file, the case, and the field.\n//\n// Hand-written rather than schema-library-backed on purpose: `@eigeninteractive/rules`\n// describes an implementor's schemas with `StandardSchemaV1` precisely so the\n// engine never mandates a validation library, and the Dart twin runner is\n// deliberately framework-free. This is ~80 lines and keeps both true.\n\nfunction describe(value: unknown): string {\n if (value === null) return \"null\";\n if (Array.isArray(value)) return \"an array\";\n return typeof value;\n}\n\nfunction fail(where: string, expected: string, got: unknown): never {\n throw new Error(`${where}: expected ${expected}, got ${describe(got)}`);\n}\n\nfunction asObject(where: string, v: unknown): JsonObject {\n if (typeof v !== \"object\" || v === null || Array.isArray(v)) fail(where, \"an object\", v);\n return v as JsonObject;\n}\n\nfunction asString(where: string, v: unknown): string {\n if (typeof v !== \"string\") fail(where, \"a string\", v);\n return v;\n}\n\nfunction asNumber(where: string, v: unknown): number {\n if (typeof v !== \"number\" || !Number.isFinite(v)) fail(where, \"a finite number\", v);\n return v;\n}\n\nfunction asBoolean(where: string, v: unknown): boolean {\n if (typeof v !== \"boolean\") fail(where, \"a boolean\", v);\n return v;\n}\n\nfunction asNumberArray(where: string, v: unknown): number[] {\n if (!Array.isArray(v)) fail(where, \"an array of numbers\", v);\n return v.map((n, i) => asNumber(`${where}[${i}]`, n));\n}\n\n/** Applies `read` only when the key is present and non-null; absent and\n * explicit null both mean \"not specified\" for every optional fixture field. */\nfunction optional<T>(where: string, v: unknown, read: (where: string, v: unknown) => T): T | undefined {\n return v === undefined || v === null ? undefined : read(where, v);\n}\n\nfunction parseActionCase(where: string, raw: JsonObject): ActionCase {\n const expectedRaw = asObject(`${where}.expected`, raw.expected);\n const expected: ActionCase[\"expected\"] = {\n valid: asBoolean(`${where}.expected.valid`, expectedRaw.valid),\n state: optional(`${where}.expected.state`, expectedRaw.state, asObject),\n pending: optional(`${where}.expected.pending`, expectedRaw.pending, asNumberArray),\n observation: optional(`${where}.expected.observation`, expectedRaw.observation, asObject),\n };\n // `outcome` is three-valued: absent (unchecked), null (asserts the game is\n // ongoing), or a list. `checkEnvelope` distinguishes absent from null with\n // an `in` test, so the key must only be set when the fixture set it.\n if (\"outcome\" in expectedRaw) {\n const outcome = expectedRaw.outcome;\n if (outcome !== null && !Array.isArray(outcome)) fail(`${where}.expected.outcome`, \"an array or null\", outcome);\n expected.outcome = outcome as OutcomeEntry[] | null;\n }\n return {\n kind: \"action\",\n name: asString(`${where}.name`, raw.name),\n config: asObject(`${where}.config`, raw.config),\n state: asObject(`${where}.state`, raw.state),\n obs: optional(`${where}.obs`, raw.obs, asObject),\n pending: asNumberArray(`${where}.pending`, raw.pending),\n playerIndex: asNumber(`${where}.playerIndex`, raw.playerIndex),\n participantCount: optional(`${where}.participantCount`, raw.participantCount, asNumber),\n rngSeed: optional(`${where}.rngSeed`, raw.rngSeed, asString),\n action: asObject(`${where}.action`, raw.action),\n expected,\n };\n}\n\nfunction parseRatingPoolCase(where: string, raw: JsonObject): RatingPoolCase {\n const access = asString(`${where}.access`, raw.access);\n if (access !== \"public\" && access !== \"private\" && access !== \"friends\") {\n throw new Error(`${where}.access: expected one of public | private | friends, got ${JSON.stringify(access)}`);\n }\n return {\n kind: \"ratingPool\",\n name: asString(`${where}.name`, raw.name),\n access,\n turnSeconds: optional(`${where}.turnSeconds`, raw.turnSeconds, asNumber) ?? null,\n budgetSeconds: optional(`${where}.budgetSeconds`, raw.budgetSeconds, asNumber) ?? null,\n incrementSeconds: optional(`${where}.incrementSeconds`, raw.incrementSeconds, asNumber) ?? null,\n minPlayers: asNumber(`${where}.minPlayers`, raw.minPlayers),\n maxPlayers: asNumber(`${where}.maxPlayers`, raw.maxPlayers),\n config: asObject(`${where}.config`, raw.config),\n expected: raw.expected === null ? null : asString(`${where}.expected`, raw.expected),\n };\n}\n\nfunction parsePlayerLimitsCase(where: string, raw: JsonObject): PlayerLimitsCase {\n const expected = asObject(`${where}.expected`, raw.expected);\n return {\n kind: \"playerLimits\",\n name: asString(`${where}.name`, raw.name),\n config: asObject(`${where}.config`, raw.config),\n expected: {\n minPlayers: asNumber(`${where}.expected.minPlayers`, expected.minPlayers),\n maxPlayers: asNumber(`${where}.expected.maxPlayers`, expected.maxPlayers),\n },\n };\n}\n\nfunction parseBotSeatableCase(where: string, raw: JsonObject): BotSeatableCase {\n return {\n kind: \"botSeatable\",\n name: asString(`${where}.name`, raw.name),\n gameConfig: asObject(`${where}.gameConfig`, raw.gameConfig),\n botConfig: asObject(`${where}.botConfig`, raw.botConfig),\n expected: asBoolean(`${where}.expected`, raw.expected),\n };\n}\n\n/** Validate one fixture file's parsed JSON, or throw naming the offending\n * file, case, and field. Exported so a repo can lint its fixtures without\n * running them. */\nexport function parseTwinFixtureFile(path: string, json: unknown): TwinFixtureFile {\n const root = asObject(path, json);\n const schemaVersion = asNumber(`${path}.schemaVersion`, root.schemaVersion);\n if (!Array.isArray(root.cases)) fail(`${path}.cases`, \"an array\", root.cases);\n const cases = root.cases.map((raw, i) => {\n // Prefer the case's own name in the location once we can read it: a\n // fixture author finds \"cases[3] (seat 0 wins)\" faster than an index.\n const indexed = `${path}.cases[${i}]`;\n const obj = asObject(indexed, raw);\n const where = typeof obj.name === \"string\" ? `${indexed} (${obj.name})` : indexed;\n switch (obj.kind) {\n case \"action\":\n return parseActionCase(where, obj);\n case \"playerLimits\":\n return parsePlayerLimitsCase(where, obj);\n case \"ratingPool\":\n return parseRatingPoolCase(where, obj);\n case \"botSeatable\":\n return parseBotSeatableCase(where, obj);\n default:\n throw new Error(`${where}.kind: expected one of action | playerLimits | ratingPool | botSeatable, got ${JSON.stringify(obj.kind)}`);\n }\n });\n return { schemaVersion, cases };\n}\n\n/** Run one fixture case against a rules unit, returning failure descriptions\n * (empty ⇒ the case passes). Pure; the file-reading test registrar is\n * {@link twinFixtureTests}. */\nexport function evaluateTwinCase(rules: GameRules, kase: TwinFixtureCase): string[] {\n switch (kase.kind) {\n case \"action\":\n return evaluateAction(rules, kase);\n case \"playerLimits\":\n return evaluatePlayerLimits(rules, kase);\n case \"ratingPool\":\n return evaluateRatingPool(rules, kase);\n case \"botSeatable\":\n return evaluateBotSeatable(rules, kase);\n default:\n return [`unknown case kind \"${(kase as { kind: string }).kind}\", expected action | playerLimits | ratingPool | botSeatable`];\n }\n}\n\n/** Register one vitest test per fixture case found under `fixturesRoot`\n * (layout: `<root>/v<N>/*.json`). Call at the top level of a test module\n * running in a Node environment. */\nexport function twinFixtureTests(gameModule: GameModule, fixturesRoot: string | URL): void {\n for (const filePath of fixtureFiles(fixturesRoot)) {\n const fixture = parseTwinFixtureFile(filePath, JSON.parse(readFileSync(filePath, \"utf8\")));\n const rules = gameModule.versions[fixture.schemaVersion];\n for (const kase of fixture.cases) {\n it(`twin v${fixture.schemaVersion}: ${kase.name}`, () => {\n if (!rules) {\n throw new Error(`gameModule ships no rules unit for schemaVersion ${fixture.schemaVersion} (fixture: ${filePath})`);\n }\n const failures = evaluateTwinCase(rules, kase);\n if (failures.length) throw new Error(`\\n${failures.join(\"\\n\")}`);\n });\n }\n }\n}\n\nfunction* fixtureFiles(root: string | URL): Generator<string> {\n const dirs = readdirSync(root, { withFileTypes: true })\n .filter((e) => e.isDirectory())\n .sort((a, b) => a.name.localeCompare(b.name));\n for (const dir of dirs) {\n const files = readdirSync(`${dir.parentPath}/${dir.name}`, {\n withFileTypes: true,\n })\n .filter((e) => e.isFile() && e.name.endsWith(\".json\"))\n .sort((a, b) => a.name.localeCompare(b.name));\n for (const file of files) yield `${file.parentPath}/${file.name}`;\n }\n}\n\n// ── Case evaluators ───────────────────────────────────────────────────────────\n\nfunction evaluateAction(rules: GameRules, kase: ActionCase): string[] {\n const failures: string[] = [];\n const config = parseWith(rules, \"config\", kase.config, failures);\n const state = parseWith(rules, \"state\", kase.state, failures);\n const action = parseWith(rules, \"action\", kase.action, failures);\n if (config === undefined || state === undefined || action === undefined) {\n return failures;\n }\n\n // The parsed action must be the fixture action: a schema that strips or\n // defaults fields the twin relies on is itself drift.\n if (!deepEquals(action, kase.action)) {\n failures.push(`action schema does not preserve the fixture action, parsed to ${JSON.stringify(action)}`);\n }\n\n const envelope = applyFixtureAction(rules, kase, config, state, action);\n if (typeof envelope === \"string\") {\n if (envelope) failures.push(envelope);\n return failures;\n }\n checkEnvelope(rules, kase, envelope, failures);\n if (kase.expected.observation !== undefined) {\n checkObservation(rules, kase, envelope, config, action, failures);\n }\n return failures;\n}\n\n/** Invoke `applyAction` and reconcile with `expected.valid`. Returns the\n * envelope on a valid accepted move, an error string on failure, or \"\" when\n * an expected-illegal move was correctly rejected (nothing left to check). */\nfunction applyFixtureAction(rules: GameRules, kase: ActionCase, config: JsonObject, state: JsonObject, action: JsonObject): Envelope | string {\n let envelope: Envelope;\n try {\n envelope = rules.applyAction({\n state,\n pending: kase.pending,\n data: action,\n playerIndex: kase.playerIndex,\n rng: new Rand(kase.rngSeed ?? \"twin-fixtures\"),\n config,\n });\n } catch (error) {\n if (!(error instanceof IllegalMoveError)) {\n return `applyAction threw a non-IllegalMoveError: ${error}`;\n }\n return kase.expected.valid ? `applyAction rejected a move the fixture expects to be valid: ${error.message}` : \"\";\n }\n return kase.expected.valid ? envelope : \"applyAction accepted a move the fixture expects to be illegal\";\n}\n\nfunction checkEnvelope(rules: GameRules, kase: ActionCase, envelope: Envelope, failures: string[]): void {\n if (validate(rules, \"state\", envelope.state) === undefined) {\n failures.push(\"applyAction returned state that violates its own schema\");\n }\n const expected = kase.expected;\n if (expected.state !== undefined && !deepEquals(envelope.state, expected.state)) {\n failures.push(`envelope.state mismatch, got ${JSON.stringify(envelope.state)}`);\n }\n if (expected.pending !== undefined && !deepEquals(envelope.pendingPlayers, expected.pending)) {\n failures.push(`envelope.pendingPlayers mismatch, got ${JSON.stringify(envelope.pendingPlayers)}`);\n }\n if (\"outcome\" in expected && !deepEquals(envelope.outcome ?? null, expected.outcome ?? null)) {\n failures.push(`envelope.outcome mismatch, got ${JSON.stringify(envelope.outcome ?? null)}`);\n }\n}\n\nfunction checkObservation(rules: GameRules, kase: ActionCase, envelope: Envelope, config: JsonObject, action: JsonObject, failures: string[]): void {\n let slice: ObservationSlice;\n try {\n slice = rules.computeObservation({\n state: envelope.state,\n pending: envelope.pendingPlayers,\n playerIndex: kase.playerIndex,\n participantCount: kase.participantCount ?? 2,\n config,\n cause: { kind: \"game\", data: action, playerIndex: kase.playerIndex },\n isReplay: false,\n });\n } catch (error) {\n failures.push(`computeObservation threw: ${error}`);\n return;\n }\n if (!deepEquals(slice.data, kase.expected.observation as Json)) {\n failures.push(`actor's observation mismatch, got ${JSON.stringify(slice.data)}`);\n }\n}\n\nfunction evaluateRatingPool(rules: GameRules, kase: RatingPoolCase): string[] {\n const failures: string[] = [];\n const config = parseWith(rules, \"config\", kase.config, failures);\n if (config === undefined) return failures;\n const pool = rules.ratingPool({\n access: kase.access,\n turnSeconds: kase.turnSeconds ?? null,\n budgetSeconds: kase.budgetSeconds ?? null,\n incrementSeconds: kase.incrementSeconds ?? null,\n minPlayers: kase.minPlayers,\n maxPlayers: kase.maxPlayers,\n config,\n });\n if (pool !== kase.expected) {\n failures.push(`ratingPool returned ${JSON.stringify(pool)}, fixture expects ${JSON.stringify(kase.expected)}`);\n }\n return failures;\n}\n\nfunction evaluatePlayerLimits(rules: GameRules, kase: PlayerLimitsCase): string[] {\n const failures: string[] = [];\n const config = parseWith(rules, \"config\", kase.config, failures);\n if (config === undefined) return failures;\n const limits = rules.playerLimits({ config });\n if (limits.minPlayers !== kase.expected.minPlayers || limits.maxPlayers !== kase.expected.maxPlayers) {\n failures.push(`playerLimits returned ${limits.minPlayers}-${limits.maxPlayers}, fixture expects ${kase.expected.minPlayers}-${kase.expected.maxPlayers}`);\n }\n return failures;\n}\n\nfunction evaluateBotSeatable(rules: GameRules, kase: BotSeatableCase): string[] {\n const failures: string[] = [];\n const gameConfig = parseWith(rules, \"config\", kase.gameConfig, failures);\n if (gameConfig === undefined) return failures;\n const seatable = rules.botSeatable({\n gameConfig,\n botConfig: kase.botConfig,\n });\n if (seatable !== kase.expected) {\n failures.push(`botSeatable returned ${seatable}, fixture expects ${kase.expected}`);\n }\n return failures;\n}\n\n// ── Helpers ───────────────────────────────────────────────────────────────────\n\n/** Run one of the unit's Standard Schemas synchronously, returning the parsed\n * value or undefined on failure (issues written to the second return slot). */\nfunction validate(rules: GameRules, which: \"config\" | \"state\" | \"action\", value: unknown, issues?: string[]): JsonObject | undefined {\n const result = rules.schemas[which][\"~standard\"].validate(value);\n if (result instanceof Promise) {\n issues?.push(`${which} schema validated asynchronously; must be sync`);\n return undefined;\n }\n if (result.issues) {\n issues?.push(\n result.issues\n .map((i) => {\n const path = i.path?.map((p) => (typeof p === \"object\" ? String(p.key) : String(p))).join(\".\");\n return path ? `${path}: ${i.message}` : i.message;\n })\n .join(\"; \"),\n );\n return undefined;\n }\n return result.value as JsonObject;\n}\n\n/** Parse a fixture payload through one of the unit's schemas, recording a\n * failure (and returning undefined) when it does not conform. */\nfunction parseWith(rules: GameRules, which: \"config\" | \"state\" | \"action\", value: JsonObject, failures: string[]): JsonObject | undefined {\n const issues: string[] = [];\n const parsed = validate(rules, which, value, issues);\n if (parsed === undefined) {\n failures.push(`fixture ${which} fails the TS ${which} schema: ${issues.join(\"; \")}`);\n }\n return parsed;\n}\n\n/** Structural JSON equality. Object keys with `undefined` values count as\n * absent (matching how schema libraries model optional fields); array order\n * matters. */\nexport function deepEquals(a: Json | undefined, b: Json | undefined): boolean {\n if (a === undefined || a === null) return b === undefined || b === null;\n if (b === undefined || b === null) return false;\n if (Array.isArray(a) || Array.isArray(b)) {\n if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) {\n return false;\n }\n return a.every((item, i) => deepEquals(item, b[i]));\n }\n if (typeof a === \"object\" || typeof b === \"object\") {\n if (typeof a !== \"object\" || typeof b !== \"object\") return false;\n const keys = new Set([...Object.keys(a), ...Object.keys(b)]);\n return [...keys].every((k) => deepEquals((a as JsonObject)[k], (b as JsonObject)[k]));\n }\n return a === b;\n}\n","/**\n * Emit the language-neutral contract a game's Flutter repository consumes.\n *\n * The authoritative inputs live with the TypeScript rules: the four payload\n * schemas and the shared behavioral fixtures. The output is one deterministic\n * JSON file so it can be copied, attached to a release, or fetched by checksum\n * without assuming any repository layout.\n */\n\nimport { existsSync, readdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { basename, relative, resolve } from \"node:path\";\nimport { assertPortableSchema, type GameModule, type StandardJSONSchemaV1 } from \"@eigeninteractive/rules\";\nimport { parseTwinFixtureFile } from \"./twin-fixtures.js\";\n\n/** Current format of the language-neutral contract consumed by EigenInteractive's Dart generator. */\nexport const GAME_CONTRACT_FORMAT_VERSION = 1;\n\n/** One validated twin-fixture document embedded in a {@link GameContract}. */\nexport interface GameContractFixture {\n /** POSIX-style path relative to the supplied fixtures root. */\n path: string;\n /** Validated fixture document, retained in its original JSON shape. */\n document: unknown;\n}\n\n/** The four JSON Schemas emitted for one game `schemaVersion`. */\nexport interface GameContractVersion {\n schemas: {\n state: Record<string, unknown>;\n observation: Record<string, unknown>;\n action: Record<string, unknown>;\n config: Record<string, unknown>;\n };\n}\n\n/** Language-neutral schemas and fixtures shared by a game's Worker and app. */\nexport interface GameContract {\n formatVersion: typeof GAME_CONTRACT_FORMAT_VERSION;\n game: string;\n versions: Record<string, GameContractVersion>;\n fixtures: GameContractFixture[];\n}\n\n/** Inputs for building a {@link GameContract} without writing it. */\nexport interface BuildGameContractOptions {\n /** Stable display name used as the generated Dart type prefix. */\n game: string;\n /** Authoritative TypeScript rules registry. */\n gameModule: GameModule;\n /** Root containing `v<N>/*.json` twin fixtures. */\n fixturesRoot?: string | URL;\n}\n\n/** Inputs for emitting or checking a {@link GameContract} file. */\nexport interface EmitGameContractOptions extends BuildGameContractOptions {\n /** Destination `game-contract.json` path. */\n output: string | URL;\n}\n\n/**\n * Sort object keys so the same schemas always emit the same bytes.\n *\n * Ordering is by UTF-16 code unit — plain `Array#sort` — which is what RFC 8785\n * specifies and what `tool/check-contracts.mjs` uses to digest a manifest. It is\n * *not* `localeCompare`: that collates case-insensitively, so a `$defs` entry\n * named `Move` sorts before `additionalProperties` under one rule and after it\n * under the other. Generated JSON Schema is full of capitalized `$defs` names, so\n * the two orders genuinely disagree, and a digest computed over one would never\n * match a document written by the other.\n */\nfunction canonical(value: unknown): unknown {\n if (Array.isArray(value)) return value.map(canonical);\n if (value !== null && typeof value === \"object\") {\n return Object.fromEntries(\n Object.entries(value as Record<string, unknown>)\n .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n .map(([key, item]) => [key, canonical(item)]),\n );\n }\n return value;\n}\n\n/**\n * Emit one payload schema as portable draft-2020-12 JSON Schema.\n *\n * Always the **output** direction. Zod's input schema omits\n * `additionalProperties: false` on objects, because on input a permissive object\n * still strips unknown keys rather than rejecting them — but the contract is what\n * the Dart side generates a validator from, and an open object there means the two\n * halves disagree about an unknown key. Schemas are required to be transform-free\n * (see `GameSchemas`), so the two directions describe the same values and the\n * output one is simply the honest document.\n *\n * The result is then checked against the portable profile, because emission is\n * where an unportable schema can still be fixed cheaply. Skipping this check is\n * how the profile came to be violated in the first place.\n */\nfunction jsonSchema(schema: StandardJSONSchemaV1, label: string): Record<string, unknown> {\n const options = { target: \"draft-2020-12\" as const };\n let emitted: unknown;\n try {\n emitted = canonical(schema[\"~standard\"].jsonSchema.output(options));\n } catch (error) {\n throw new Error(`${label} cannot emit its type as draft-2020-12 JSON Schema`, { cause: error });\n }\n assertPortableSchema(emitted, label);\n return emitted as Record<string, unknown>;\n}\n\nfunction fixtureFiles(root: string): string[] {\n const found: string[] = [];\n const visit = (directory: string): void => {\n for (const entry of readdirSync(directory, { withFileTypes: true })) {\n const path = resolve(directory, entry.name);\n if (entry.isDirectory()) visit(path);\n else if (entry.isFile() && entry.name.endsWith(\".json\")) found.push(path);\n }\n };\n visit(root);\n return found.sort();\n}\n\nfunction fixtures(fixturesRoot: string | URL | undefined, versions: ReadonlySet<string>): GameContractFixture[] {\n if (fixturesRoot === undefined) return [];\n const root = fixturesRoot instanceof URL ? fixturesRoot.pathname : resolve(fixturesRoot);\n return fixtureFiles(root).map((path) => {\n const document = JSON.parse(readFileSync(path, \"utf8\")) as unknown;\n const fixture = parseTwinFixtureFile(path, document);\n const fixturePath = relative(root, path).split(\"\\\\\").join(\"/\");\n const directory = fixturePath.split(\"/\")[0];\n const match = /^v([1-9]\\d*)$/.exec(directory ?? \"\");\n if (match === null) {\n throw new Error(`${fixturePath}: fixtures must live under a v<N>/ directory`);\n }\n const pathVersion = Number(match[1]);\n if (pathVersion !== fixture.schemaVersion) {\n throw new Error(`${fixturePath}: directory v${pathVersion} disagrees with schemaVersion ${fixture.schemaVersion}`);\n }\n if (!versions.has(String(fixture.schemaVersion))) {\n throw new Error(`${fixturePath}: gameModule ships no rules unit for schemaVersion ${fixture.schemaVersion}`);\n }\n return {\n path: fixturePath,\n document: canonical(document),\n };\n });\n}\n\n/** Build a deterministic in-memory contract without touching the filesystem. */\nexport function buildGameContract(options: BuildGameContractOptions): GameContract {\n const game = options.game.trim();\n if (game.length === 0) throw new Error(\"game contract name must not be empty\");\n\n const versions = Object.fromEntries(\n Object.entries(options.gameModule.versions)\n .sort(([a], [b]) => Number(a) - Number(b))\n .map(([version, rules]) => [\n version,\n {\n schemas: {\n state: jsonSchema(rules.schemas.state, `v${version} state`),\n observation: jsonSchema(rules.schemas.observation, `v${version} observation`),\n action: jsonSchema(rules.schemas.action, `v${version} action`),\n config: jsonSchema(rules.schemas.config, `v${version} config`),\n },\n },\n ]),\n );\n\n if (Object.keys(versions).length === 0) {\n throw new Error(\"game contract must contain at least one schema version\");\n }\n\n return {\n formatVersion: GAME_CONTRACT_FORMAT_VERSION,\n game,\n versions,\n fixtures: fixtures(options.fixturesRoot, new Set(Object.keys(versions))),\n };\n}\n\n/** Render one deterministic, newline-terminated contract document. */\nexport function gameContractJson(options: BuildGameContractOptions): string {\n return `${JSON.stringify(buildGameContract(options), null, 2)}\\n`;\n}\n\n/** Emit one deterministic, newline-terminated `game-contract.json`. */\nexport function emitGameContract(options: EmitGameContractOptions): void {\n const output = options.output instanceof URL ? options.output : resolve(options.output);\n writeFileSync(output, gameContractJson(options));\n}\n\n/** Fail when an emitted contract is missing or differs from its inputs. */\nexport function checkGameContract(options: EmitGameContractOptions): void {\n const output = options.output instanceof URL ? options.output : resolve(options.output);\n if (!existsSync(output) || readFileSync(output, \"utf8\") !== gameContractJson(options)) {\n throw new Error(`${output.toString()} is stale; run eigen-contract`);\n }\n}\n\n/** A useful default filename for scripts that accept an output directory. */\nexport const gameContractFilename = (game: string): string =>\n `${basename(game)\n .toLowerCase()\n .replaceAll(/[^a-z0-9]+/g, \"-\")}-game-contract.json`;\n","import { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { GameModule } from \"@eigeninteractive/rules\";\nimport { tsImport } from \"tsx/esm/api\";\nimport { checkGameContract, emitGameContract } from \"./game-contract.js\";\n\ninterface EigenPackageConfig {\n game?: unknown;\n module?: unknown;\n fixtures?: unknown;\n contract?: unknown;\n}\n\ninterface PackageManifest {\n eigen?: EigenPackageConfig;\n}\n\nfunction configuredString(value: unknown, fallback: string, field: string): string {\n if (value === undefined) return fallback;\n if (typeof value !== \"string\" || value.trim().length === 0) {\n throw new Error(`package.json eigen.${field} must be a non-empty string`);\n }\n return value;\n}\n\nconst isGameModule = (value: unknown): value is GameModule => value !== null && typeof value === \"object\" && \"versions\" in value && value.versions !== null && typeof value.versions === \"object\";\n\n/**\n * Emit a contract from the conventional game package layout.\n *\n * The package default-exports its GameModule from `src/module/index.ts` and\n * declares `{ \"eigen\": { \"game\": \"…\" } }` in package.json. Paths can be\n * overridden under the same `eigen` object.\n */\nasync function configuredGameContractOptions(root: string) {\n const manifest = JSON.parse(readFileSync(resolve(root, \"package.json\"), \"utf8\")) as PackageManifest;\n const config = manifest.eigen ?? {};\n const game = configuredString(config.game, \"\", \"game\");\n if (game.length === 0) {\n throw new Error('package.json must declare an EigenInteractive game name, e.g. \"eigen\": { \"game\": \"Chess\" }');\n }\n\n const modulePath = configuredString(config.module, \"src/module/index.ts\", \"module\");\n const fixturesPath = configuredString(config.fixtures, \"src/module/fixtures\", \"fixtures\");\n const contractPath = configuredString(config.contract, \"game-contract.json\", \"contract\");\n const imported = (await tsImport(pathToFileURL(resolve(root, modulePath)).href, import.meta.url)) as { default?: unknown };\n\n if (!isGameModule(imported.default)) {\n throw new Error(`${modulePath} must default-export an EigenInteractive GameModule`);\n }\n\n return {\n game,\n gameModule: imported.default,\n fixturesRoot: resolve(root, fixturesPath),\n output: resolve(root, contractPath),\n };\n}\n\n/**\n * Emits `game-contract.json` from an EigenInteractive package's conventional layout.\n *\n * This is the programmatic form of the `eigen-contract` executable. Most\n * games should invoke the executable through their package script.\n */\nexport async function emitConfiguredGameContract(root = process.cwd()): Promise<void> {\n emitGameContract(await configuredGameContractOptions(root));\n}\n\n/**\n * Fails when the conventionally configured contract is absent or stale.\n *\n * Use this in CI through `eigen-contract --check`.\n */\nexport async function checkConfiguredGameContract(root = process.cwd()): Promise<void> {\n checkGameContract(await configuredGameContractOptions(root));\n}\n"],"mappings":";AAsEA,SAAS,aAAa,oBAAoB;AAC1C,SAA0E,wBAA8F;AACxK,OAAO,UAAU;AACjB,SAAS,UAAU;AA+EnB,SAAS,SAAS,OAAwB;AACxC,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,SAAO,OAAO;AAChB;AAEA,SAAS,KAAK,OAAe,UAAkB,KAAqB;AAClE,QAAM,IAAI,MAAM,GAAG,KAAK,cAAc,QAAQ,SAAS,SAAS,GAAG,CAAC,EAAE;AACxE;AAEA,SAAS,SAAS,OAAe,GAAwB;AACvD,MAAI,OAAO,MAAM,YAAY,MAAM,QAAQ,MAAM,QAAQ,CAAC,EAAG,MAAK,OAAO,aAAa,CAAC;AACvF,SAAO;AACT;AAEA,SAAS,SAAS,OAAe,GAAoB;AACnD,MAAI,OAAO,MAAM,SAAU,MAAK,OAAO,YAAY,CAAC;AACpD,SAAO;AACT;AAEA,SAAS,SAAS,OAAe,GAAoB;AACnD,MAAI,OAAO,MAAM,YAAY,CAAC,OAAO,SAAS,CAAC,EAAG,MAAK,OAAO,mBAAmB,CAAC;AAClF,SAAO;AACT;AAEA,SAAS,UAAU,OAAe,GAAqB;AACrD,MAAI,OAAO,MAAM,UAAW,MAAK,OAAO,aAAa,CAAC;AACtD,SAAO;AACT;AAEA,SAAS,cAAc,OAAe,GAAsB;AAC1D,MAAI,CAAC,MAAM,QAAQ,CAAC,EAAG,MAAK,OAAO,uBAAuB,CAAC;AAC3D,SAAO,EAAE,IAAI,CAAC,GAAG,MAAM,SAAS,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD;AAIA,SAAS,SAAY,OAAe,GAAY,MAAuD;AACrG,SAAO,MAAM,UAAa,MAAM,OAAO,SAAY,KAAK,OAAO,CAAC;AAClE;AAEA,SAAS,gBAAgB,OAAe,KAA6B;AACnE,QAAM,cAAc,SAAS,GAAG,KAAK,aAAa,IAAI,QAAQ;AAC9D,QAAM,WAAmC;AAAA,IACvC,OAAO,UAAU,GAAG,KAAK,mBAAmB,YAAY,KAAK;AAAA,IAC7D,OAAO,SAAS,GAAG,KAAK,mBAAmB,YAAY,OAAO,QAAQ;AAAA,IACtE,SAAS,SAAS,GAAG,KAAK,qBAAqB,YAAY,SAAS,aAAa;AAAA,IACjF,aAAa,SAAS,GAAG,KAAK,yBAAyB,YAAY,aAAa,QAAQ;AAAA,EAC1F;AAIA,MAAI,aAAa,aAAa;AAC5B,UAAM,UAAU,YAAY;AAC5B,QAAI,YAAY,QAAQ,CAAC,MAAM,QAAQ,OAAO,EAAG,MAAK,GAAG,KAAK,qBAAqB,oBAAoB,OAAO;AAC9G,aAAS,UAAU;AAAA,EACrB;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAAS,GAAG,KAAK,SAAS,IAAI,IAAI;AAAA,IACxC,QAAQ,SAAS,GAAG,KAAK,WAAW,IAAI,MAAM;AAAA,IAC9C,OAAO,SAAS,GAAG,KAAK,UAAU,IAAI,KAAK;AAAA,IAC3C,KAAK,SAAS,GAAG,KAAK,QAAQ,IAAI,KAAK,QAAQ;AAAA,IAC/C,SAAS,cAAc,GAAG,KAAK,YAAY,IAAI,OAAO;AAAA,IACtD,aAAa,SAAS,GAAG,KAAK,gBAAgB,IAAI,WAAW;AAAA,IAC7D,kBAAkB,SAAS,GAAG,KAAK,qBAAqB,IAAI,kBAAkB,QAAQ;AAAA,IACtF,SAAS,SAAS,GAAG,KAAK,YAAY,IAAI,SAAS,QAAQ;AAAA,IAC3D,QAAQ,SAAS,GAAG,KAAK,WAAW,IAAI,MAAM;AAAA,IAC9C;AAAA,EACF;AACF;AAEA,SAAS,oBAAoB,OAAe,KAAiC;AAC3E,QAAM,SAAS,SAAS,GAAG,KAAK,WAAW,IAAI,MAAM;AACrD,MAAI,WAAW,YAAY,WAAW,aAAa,WAAW,WAAW;AACvE,UAAM,IAAI,MAAM,GAAG,KAAK,4DAA4D,KAAK,UAAU,MAAM,CAAC,EAAE;AAAA,EAC9G;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAAS,GAAG,KAAK,SAAS,IAAI,IAAI;AAAA,IACxC;AAAA,IACA,aAAa,SAAS,GAAG,KAAK,gBAAgB,IAAI,aAAa,QAAQ,KAAK;AAAA,IAC5E,eAAe,SAAS,GAAG,KAAK,kBAAkB,IAAI,eAAe,QAAQ,KAAK;AAAA,IAClF,kBAAkB,SAAS,GAAG,KAAK,qBAAqB,IAAI,kBAAkB,QAAQ,KAAK;AAAA,IAC3F,YAAY,SAAS,GAAG,KAAK,eAAe,IAAI,UAAU;AAAA,IAC1D,YAAY,SAAS,GAAG,KAAK,eAAe,IAAI,UAAU;AAAA,IAC1D,QAAQ,SAAS,GAAG,KAAK,WAAW,IAAI,MAAM;AAAA,IAC9C,UAAU,IAAI,aAAa,OAAO,OAAO,SAAS,GAAG,KAAK,aAAa,IAAI,QAAQ;AAAA,EACrF;AACF;AAEA,SAAS,sBAAsB,OAAe,KAAmC;AAC/E,QAAM,WAAW,SAAS,GAAG,KAAK,aAAa,IAAI,QAAQ;AAC3D,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAAS,GAAG,KAAK,SAAS,IAAI,IAAI;AAAA,IACxC,QAAQ,SAAS,GAAG,KAAK,WAAW,IAAI,MAAM;AAAA,IAC9C,UAAU;AAAA,MACR,YAAY,SAAS,GAAG,KAAK,wBAAwB,SAAS,UAAU;AAAA,MACxE,YAAY,SAAS,GAAG,KAAK,wBAAwB,SAAS,UAAU;AAAA,IAC1E;AAAA,EACF;AACF;AAEA,SAAS,qBAAqB,OAAe,KAAkC;AAC7E,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,SAAS,GAAG,KAAK,SAAS,IAAI,IAAI;AAAA,IACxC,YAAY,SAAS,GAAG,KAAK,eAAe,IAAI,UAAU;AAAA,IAC1D,WAAW,SAAS,GAAG,KAAK,cAAc,IAAI,SAAS;AAAA,IACvD,UAAU,UAAU,GAAG,KAAK,aAAa,IAAI,QAAQ;AAAA,EACvD;AACF;AAKO,SAAS,qBAAqB,MAAc,MAAgC;AACjF,QAAM,OAAO,SAAS,MAAM,IAAI;AAChC,QAAM,gBAAgB,SAAS,GAAG,IAAI,kBAAkB,KAAK,aAAa;AAC1E,MAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,EAAG,MAAK,GAAG,IAAI,UAAU,YAAY,KAAK,KAAK;AAC5E,QAAM,QAAQ,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM;AAGvC,UAAM,UAAU,GAAG,IAAI,UAAU,CAAC;AAClC,UAAM,MAAM,SAAS,SAAS,GAAG;AACjC,UAAM,QAAQ,OAAO,IAAI,SAAS,WAAW,GAAG,OAAO,KAAK,IAAI,IAAI,MAAM;AAC1E,YAAQ,IAAI,MAAM;AAAA,MAChB,KAAK;AACH,eAAO,gBAAgB,OAAO,GAAG;AAAA,MACnC,KAAK;AACH,eAAO,sBAAsB,OAAO,GAAG;AAAA,MACzC,KAAK;AACH,eAAO,oBAAoB,OAAO,GAAG;AAAA,MACvC,KAAK;AACH,eAAO,qBAAqB,OAAO,GAAG;AAAA,MACxC;AACE,cAAM,IAAI,MAAM,GAAG,KAAK,gFAAgF,KAAK,UAAU,IAAI,IAAI,CAAC,EAAE;AAAA,IACtI;AAAA,EACF,CAAC;AACD,SAAO,EAAE,eAAe,MAAM;AAChC;AAKO,SAAS,iBAAiB,OAAkB,MAAiC;AAClF,UAAQ,KAAK,MAAM;AAAA,IACjB,KAAK;AACH,aAAO,eAAe,OAAO,IAAI;AAAA,IACnC,KAAK;AACH,aAAO,qBAAqB,OAAO,IAAI;AAAA,IACzC,KAAK;AACH,aAAO,mBAAmB,OAAO,IAAI;AAAA,IACvC,KAAK;AACH,aAAO,oBAAoB,OAAO,IAAI;AAAA,IACxC;AACE,aAAO,CAAC,sBAAuB,KAA0B,IAAI,8DAA8D;AAAA,EAC/H;AACF;AAKO,SAAS,iBAAiB,YAAwB,cAAkC;AACzF,aAAW,YAAY,aAAa,YAAY,GAAG;AACjD,UAAM,UAAU,qBAAqB,UAAU,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC,CAAC;AACzF,UAAM,QAAQ,WAAW,SAAS,QAAQ,aAAa;AACvD,eAAW,QAAQ,QAAQ,OAAO;AAChC,SAAG,SAAS,QAAQ,aAAa,KAAK,KAAK,IAAI,IAAI,MAAM;AACvD,YAAI,CAAC,OAAO;AACV,gBAAM,IAAI,MAAM,oDAAoD,QAAQ,aAAa,cAAc,QAAQ,GAAG;AAAA,QACpH;AACA,cAAM,WAAW,iBAAiB,OAAO,IAAI;AAC7C,YAAI,SAAS,OAAQ,OAAM,IAAI,MAAM;AAAA,EAAK,SAAS,KAAK,IAAI,CAAC,EAAE;AAAA,MACjE,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEA,UAAU,aAAa,MAAuC;AAC5D,QAAM,OAAO,YAAY,MAAM,EAAE,eAAe,KAAK,CAAC,EACnD,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,EAC7B,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAC9C,aAAW,OAAO,MAAM;AACtB,UAAM,QAAQ,YAAY,GAAG,IAAI,UAAU,IAAI,IAAI,IAAI,IAAI;AAAA,MACzD,eAAe;AAAA,IACjB,CAAC,EACE,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,EAAE,KAAK,SAAS,OAAO,CAAC,EACpD,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAC9C,eAAW,QAAQ,MAAO,OAAM,GAAG,KAAK,UAAU,IAAI,KAAK,IAAI;AAAA,EACjE;AACF;AAIA,SAAS,eAAe,OAAkB,MAA4B;AACpE,QAAM,WAAqB,CAAC;AAC5B,QAAM,SAAS,UAAU,OAAO,UAAU,KAAK,QAAQ,QAAQ;AAC/D,QAAM,QAAQ,UAAU,OAAO,SAAS,KAAK,OAAO,QAAQ;AAC5D,QAAM,SAAS,UAAU,OAAO,UAAU,KAAK,QAAQ,QAAQ;AAC/D,MAAI,WAAW,UAAa,UAAU,UAAa,WAAW,QAAW;AACvE,WAAO;AAAA,EACT;AAIA,MAAI,CAAC,WAAW,QAAQ,KAAK,MAAM,GAAG;AACpC,aAAS,KAAK,iEAAiE,KAAK,UAAU,MAAM,CAAC,EAAE;AAAA,EACzG;AAEA,QAAM,WAAW,mBAAmB,OAAO,MAAM,QAAQ,OAAO,MAAM;AACtE,MAAI,OAAO,aAAa,UAAU;AAChC,QAAI,SAAU,UAAS,KAAK,QAAQ;AACpC,WAAO;AAAA,EACT;AACA,gBAAc,OAAO,MAAM,UAAU,QAAQ;AAC7C,MAAI,KAAK,SAAS,gBAAgB,QAAW;AAC3C,qBAAiB,OAAO,MAAM,UAAU,QAAQ,QAAQ,QAAQ;AAAA,EAClE;AACA,SAAO;AACT;AAKA,SAAS,mBAAmB,OAAkB,MAAkB,QAAoB,OAAmB,QAAuC;AAC5I,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,YAAY;AAAA,MAC3B;AAAA,MACA,SAAS,KAAK;AAAA,MACd,MAAM;AAAA,MACN,aAAa,KAAK;AAAA,MAClB,KAAK,IAAI,KAAK,KAAK,WAAW,eAAe;AAAA,MAC7C;AAAA,IACF,CAAC;AAAA,EACH,SAAS,OAAO;AACd,QAAI,EAAE,iBAAiB,mBAAmB;AACxC,aAAO,6CAA6C,KAAK;AAAA,IAC3D;AACA,WAAO,KAAK,SAAS,QAAQ,gEAAgE,MAAM,OAAO,KAAK;AAAA,EACjH;AACA,SAAO,KAAK,SAAS,QAAQ,WAAW;AAC1C;AAEA,SAAS,cAAc,OAAkB,MAAkB,UAAoB,UAA0B;AACvG,MAAI,SAAS,OAAO,SAAS,SAAS,KAAK,MAAM,QAAW;AAC1D,aAAS,KAAK,yDAAyD;AAAA,EACzE;AACA,QAAM,WAAW,KAAK;AACtB,MAAI,SAAS,UAAU,UAAa,CAAC,WAAW,SAAS,OAAO,SAAS,KAAK,GAAG;AAC/E,aAAS,KAAK,gCAAgC,KAAK,UAAU,SAAS,KAAK,CAAC,EAAE;AAAA,EAChF;AACA,MAAI,SAAS,YAAY,UAAa,CAAC,WAAW,SAAS,gBAAgB,SAAS,OAAO,GAAG;AAC5F,aAAS,KAAK,yCAAyC,KAAK,UAAU,SAAS,cAAc,CAAC,EAAE;AAAA,EAClG;AACA,MAAI,aAAa,YAAY,CAAC,WAAW,SAAS,WAAW,MAAM,SAAS,WAAW,IAAI,GAAG;AAC5F,aAAS,KAAK,kCAAkC,KAAK,UAAU,SAAS,WAAW,IAAI,CAAC,EAAE;AAAA,EAC5F;AACF;AAEA,SAAS,iBAAiB,OAAkB,MAAkB,UAAoB,QAAoB,QAAoB,UAA0B;AAClJ,MAAI;AACJ,MAAI;AACF,YAAQ,MAAM,mBAAmB;AAAA,MAC/B,OAAO,SAAS;AAAA,MAChB,SAAS,SAAS;AAAA,MAClB,aAAa,KAAK;AAAA,MAClB,kBAAkB,KAAK,oBAAoB;AAAA,MAC3C;AAAA,MACA,OAAO,EAAE,MAAM,QAAQ,MAAM,QAAQ,aAAa,KAAK,YAAY;AAAA,MACnE,UAAU;AAAA,IACZ,CAAC;AAAA,EACH,SAAS,OAAO;AACd,aAAS,KAAK,6BAA6B,KAAK,EAAE;AAClD;AAAA,EACF;AACA,MAAI,CAAC,WAAW,MAAM,MAAM,KAAK,SAAS,WAAmB,GAAG;AAC9D,aAAS,KAAK,qCAAqC,KAAK,UAAU,MAAM,IAAI,CAAC,EAAE;AAAA,EACjF;AACF;AAEA,SAAS,mBAAmB,OAAkB,MAAgC;AAC5E,QAAM,WAAqB,CAAC;AAC5B,QAAM,SAAS,UAAU,OAAO,UAAU,KAAK,QAAQ,QAAQ;AAC/D,MAAI,WAAW,OAAW,QAAO;AACjC,QAAM,OAAO,MAAM,WAAW;AAAA,IAC5B,QAAQ,KAAK;AAAA,IACb,aAAa,KAAK,eAAe;AAAA,IACjC,eAAe,KAAK,iBAAiB;AAAA,IACrC,kBAAkB,KAAK,oBAAoB;AAAA,IAC3C,YAAY,KAAK;AAAA,IACjB,YAAY,KAAK;AAAA,IACjB;AAAA,EACF,CAAC;AACD,MAAI,SAAS,KAAK,UAAU;AAC1B,aAAS,KAAK,uBAAuB,KAAK,UAAU,IAAI,CAAC,qBAAqB,KAAK,UAAU,KAAK,QAAQ,CAAC,EAAE;AAAA,EAC/G;AACA,SAAO;AACT;AAEA,SAAS,qBAAqB,OAAkB,MAAkC;AAChF,QAAM,WAAqB,CAAC;AAC5B,QAAM,SAAS,UAAU,OAAO,UAAU,KAAK,QAAQ,QAAQ;AAC/D,MAAI,WAAW,OAAW,QAAO;AACjC,QAAM,SAAS,MAAM,aAAa,EAAE,OAAO,CAAC;AAC5C,MAAI,OAAO,eAAe,KAAK,SAAS,cAAc,OAAO,eAAe,KAAK,SAAS,YAAY;AACpG,aAAS,KAAK,yBAAyB,OAAO,UAAU,IAAI,OAAO,UAAU,qBAAqB,KAAK,SAAS,UAAU,IAAI,KAAK,SAAS,UAAU,EAAE;AAAA,EAC1J;AACA,SAAO;AACT;AAEA,SAAS,oBAAoB,OAAkB,MAAiC;AAC9E,QAAM,WAAqB,CAAC;AAC5B,QAAM,aAAa,UAAU,OAAO,UAAU,KAAK,YAAY,QAAQ;AACvE,MAAI,eAAe,OAAW,QAAO;AACrC,QAAM,WAAW,MAAM,YAAY;AAAA,IACjC;AAAA,IACA,WAAW,KAAK;AAAA,EAClB,CAAC;AACD,MAAI,aAAa,KAAK,UAAU;AAC9B,aAAS,KAAK,wBAAwB,QAAQ,qBAAqB,KAAK,QAAQ,EAAE;AAAA,EACpF;AACA,SAAO;AACT;AAMA,SAAS,SAAS,OAAkB,OAAsC,OAAgB,QAA2C;AACnI,QAAM,SAAS,MAAM,QAAQ,KAAK,EAAE,WAAW,EAAE,SAAS,KAAK;AAC/D,MAAI,kBAAkB,SAAS;AAC7B,YAAQ,KAAK,GAAG,KAAK,gDAAgD;AACrE,WAAO;AAAA,EACT;AACA,MAAI,OAAO,QAAQ;AACjB,YAAQ;AAAA,MACN,OAAO,OACJ,IAAI,CAAC,MAAM;AACV,cAAM,OAAO,EAAE,MAAM,IAAI,CAAC,MAAO,OAAO,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAE,EAAE,KAAK,GAAG;AAC7F,eAAO,OAAO,GAAG,IAAI,KAAK,EAAE,OAAO,KAAK,EAAE;AAAA,MAC5C,CAAC,EACA,KAAK,IAAI;AAAA,IACd;AACA,WAAO;AAAA,EACT;AACA,SAAO,OAAO;AAChB;AAIA,SAAS,UAAU,OAAkB,OAAsC,OAAmB,UAA4C;AACxI,QAAM,SAAmB,CAAC;AAC1B,QAAM,SAAS,SAAS,OAAO,OAAO,OAAO,MAAM;AACnD,MAAI,WAAW,QAAW;AACxB,aAAS,KAAK,WAAW,KAAK,iBAAiB,KAAK,YAAY,OAAO,KAAK,IAAI,CAAC,EAAE;AAAA,EACrF;AACA,SAAO;AACT;AAKO,SAAS,WAAW,GAAqB,GAA8B;AAC5E,MAAI,MAAM,UAAa,MAAM,KAAM,QAAO,MAAM,UAAa,MAAM;AACnE,MAAI,MAAM,UAAa,MAAM,KAAM,QAAO;AAC1C,MAAI,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,GAAG;AACxC,QAAI,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ;AACnE,aAAO;AAAA,IACT;AACA,WAAO,EAAE,MAAM,CAAC,MAAM,MAAM,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC;AAAA,EACpD;AACA,MAAI,OAAO,MAAM,YAAY,OAAO,MAAM,UAAU;AAClD,QAAI,OAAO,MAAM,YAAY,OAAO,MAAM,SAAU,QAAO;AAC3D,UAAM,OAAO,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC;AAC3D,WAAO,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,WAAY,EAAiB,CAAC,GAAI,EAAiB,CAAC,CAAC,CAAC;AAAA,EACtF;AACA,SAAO,MAAM;AACf;;;AC3gBA,SAAS,YAAY,eAAAA,cAAa,gBAAAC,eAAc,qBAAqB;AACrE,SAAS,UAAU,UAAU,eAAe;AAC5C,SAAS,4BAAwE;AAI1E,IAAM,+BAA+B;AAuD5C,SAAS,UAAU,OAAyB;AAC1C,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,SAAS;AACpD,MAAI,UAAU,QAAQ,OAAO,UAAU,UAAU;AAC/C,WAAO,OAAO;AAAA,MACZ,OAAO,QAAQ,KAAgC,EAC5C,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAO,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAE,EAC/C,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,CAAC;AAAA,IAChD;AAAA,EACF;AACA,SAAO;AACT;AAiBA,SAAS,WAAW,QAA8B,OAAwC;AACxF,QAAM,UAAU,EAAE,QAAQ,gBAAyB;AACnD,MAAI;AACJ,MAAI;AACF,cAAU,UAAU,OAAO,WAAW,EAAE,WAAW,OAAO,OAAO,CAAC;AAAA,EACpE,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,GAAG,KAAK,sDAAsD,EAAE,OAAO,MAAM,CAAC;AAAA,EAChG;AACA,uBAAqB,SAAS,KAAK;AACnC,SAAO;AACT;AAEA,SAASC,cAAa,MAAwB;AAC5C,QAAM,QAAkB,CAAC;AACzB,QAAM,QAAQ,CAAC,cAA4B;AACzC,eAAW,SAASC,aAAY,WAAW,EAAE,eAAe,KAAK,CAAC,GAAG;AACnE,YAAM,OAAO,QAAQ,WAAW,MAAM,IAAI;AAC1C,UAAI,MAAM,YAAY,EAAG,OAAM,IAAI;AAAA,eAC1B,MAAM,OAAO,KAAK,MAAM,KAAK,SAAS,OAAO,EAAG,OAAM,KAAK,IAAI;AAAA,IAC1E;AAAA,EACF;AACA,QAAM,IAAI;AACV,SAAO,MAAM,KAAK;AACpB;AAEA,SAAS,SAAS,cAAwC,UAAsD;AAC9G,MAAI,iBAAiB,OAAW,QAAO,CAAC;AACxC,QAAM,OAAO,wBAAwB,MAAM,aAAa,WAAW,QAAQ,YAAY;AACvF,SAAOD,cAAa,IAAI,EAAE,IAAI,CAAC,SAAS;AACtC,UAAM,WAAW,KAAK,MAAME,cAAa,MAAM,MAAM,CAAC;AACtD,UAAM,UAAU,qBAAqB,MAAM,QAAQ;AACnD,UAAM,cAAc,SAAS,MAAM,IAAI,EAAE,MAAM,IAAI,EAAE,KAAK,GAAG;AAC7D,UAAM,YAAY,YAAY,MAAM,GAAG,EAAE,CAAC;AAC1C,UAAM,QAAQ,gBAAgB,KAAK,aAAa,EAAE;AAClD,QAAI,UAAU,MAAM;AAClB,YAAM,IAAI,MAAM,GAAG,WAAW,8CAA8C;AAAA,IAC9E;AACA,UAAM,cAAc,OAAO,MAAM,CAAC,CAAC;AACnC,QAAI,gBAAgB,QAAQ,eAAe;AACzC,YAAM,IAAI,MAAM,GAAG,WAAW,gBAAgB,WAAW,iCAAiC,QAAQ,aAAa,EAAE;AAAA,IACnH;AACA,QAAI,CAAC,SAAS,IAAI,OAAO,QAAQ,aAAa,CAAC,GAAG;AAChD,YAAM,IAAI,MAAM,GAAG,WAAW,sDAAsD,QAAQ,aAAa,EAAE;AAAA,IAC7G;AACA,WAAO;AAAA,MACL,MAAM;AAAA,MACN,UAAU,UAAU,QAAQ;AAAA,IAC9B;AAAA,EACF,CAAC;AACH;AAGO,SAAS,kBAAkB,SAAiD;AACjF,QAAM,OAAO,QAAQ,KAAK,KAAK;AAC/B,MAAI,KAAK,WAAW,EAAG,OAAM,IAAI,MAAM,sCAAsC;AAE7E,QAAM,WAAW,OAAO;AAAA,IACtB,OAAO,QAAQ,QAAQ,WAAW,QAAQ,EACvC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,EACxC,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM;AAAA,MACzB;AAAA,MACA;AAAA,QACE,SAAS;AAAA,UACP,OAAO,WAAW,MAAM,QAAQ,OAAO,IAAI,OAAO,QAAQ;AAAA,UAC1D,aAAa,WAAW,MAAM,QAAQ,aAAa,IAAI,OAAO,cAAc;AAAA,UAC5E,QAAQ,WAAW,MAAM,QAAQ,QAAQ,IAAI,OAAO,SAAS;AAAA,UAC7D,QAAQ,WAAW,MAAM,QAAQ,QAAQ,IAAI,OAAO,SAAS;AAAA,QAC/D;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACL;AAEA,MAAI,OAAO,KAAK,QAAQ,EAAE,WAAW,GAAG;AACtC,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AAEA,SAAO;AAAA,IACL,eAAe;AAAA,IACf;AAAA,IACA;AAAA,IACA,UAAU,SAAS,QAAQ,cAAc,IAAI,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC;AAAA,EACzE;AACF;AAGO,SAAS,iBAAiB,SAA2C;AAC1E,SAAO,GAAG,KAAK,UAAU,kBAAkB,OAAO,GAAG,MAAM,CAAC,CAAC;AAAA;AAC/D;AAGO,SAAS,iBAAiB,SAAwC;AACvE,QAAM,SAAS,QAAQ,kBAAkB,MAAM,QAAQ,SAAS,QAAQ,QAAQ,MAAM;AACtF,gBAAc,QAAQ,iBAAiB,OAAO,CAAC;AACjD;AAGO,SAAS,kBAAkB,SAAwC;AACxE,QAAM,SAAS,QAAQ,kBAAkB,MAAM,QAAQ,SAAS,QAAQ,QAAQ,MAAM;AACtF,MAAI,CAAC,WAAW,MAAM,KAAKA,cAAa,QAAQ,MAAM,MAAM,iBAAiB,OAAO,GAAG;AACrF,UAAM,IAAI,MAAM,GAAG,OAAO,SAAS,CAAC,+BAA+B;AAAA,EACrE;AACF;AAGO,IAAM,uBAAuB,CAAC,SACnC,GAAG,SAAS,IAAI,EACb,YAAY,EACZ,WAAW,eAAe,GAAG,CAAC;;;AC5MnC,SAAS,gBAAAC,qBAAoB;AAC7B,SAAS,WAAAC,gBAAe;AACxB,SAAS,qBAAqB;AAE9B,SAAS,gBAAgB;AAczB,SAAS,iBAAiB,OAAgB,UAAkB,OAAuB;AACjF,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,GAAG;AAC1D,UAAM,IAAI,MAAM,sBAAsB,KAAK,6BAA6B;AAAA,EAC1E;AACA,SAAO;AACT;AAEA,IAAM,eAAe,CAAC,UAAwC,UAAU,QAAQ,OAAO,UAAU,YAAY,cAAc,SAAS,MAAM,aAAa,QAAQ,OAAO,MAAM,aAAa;AASzL,eAAe,8BAA8B,MAAc;AACzD,QAAM,WAAW,KAAK,MAAMC,cAAaC,SAAQ,MAAM,cAAc,GAAG,MAAM,CAAC;AAC/E,QAAM,SAAS,SAAS,SAAS,CAAC;AAClC,QAAM,OAAO,iBAAiB,OAAO,MAAM,IAAI,MAAM;AACrD,MAAI,KAAK,WAAW,GAAG;AACrB,UAAM,IAAI,MAAM,4FAA4F;AAAA,EAC9G;AAEA,QAAM,aAAa,iBAAiB,OAAO,QAAQ,uBAAuB,QAAQ;AAClF,QAAM,eAAe,iBAAiB,OAAO,UAAU,uBAAuB,UAAU;AACxF,QAAM,eAAe,iBAAiB,OAAO,UAAU,sBAAsB,UAAU;AACvF,QAAM,WAAY,MAAM,SAAS,cAAcA,SAAQ,MAAM,UAAU,CAAC,EAAE,MAAM,YAAY,GAAG;AAE/F,MAAI,CAAC,aAAa,SAAS,OAAO,GAAG;AACnC,UAAM,IAAI,MAAM,GAAG,UAAU,qDAAqD;AAAA,EACpF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,YAAY,SAAS;AAAA,IACrB,cAAcA,SAAQ,MAAM,YAAY;AAAA,IACxC,QAAQA,SAAQ,MAAM,YAAY;AAAA,EACpC;AACF;AAQA,eAAsB,2BAA2B,OAAO,QAAQ,IAAI,GAAkB;AACpF,mBAAiB,MAAM,8BAA8B,IAAI,CAAC;AAC5D;AAOA,eAAsB,4BAA4B,OAAO,QAAQ,IAAI,GAAkB;AACrF,oBAAkB,MAAM,8BAA8B,IAAI,CAAC;AAC7D;","names":["readdirSync","readFileSync","fixtureFiles","readdirSync","readFileSync","readFileSync","resolve","readFileSync","resolve"]}
|
package/dist/contract-cli.d.ts
CHANGED
package/dist/contract-cli.js
CHANGED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Emits `game-contract.json` from an EigenInteractive package's conventional layout.
|
|
3
|
+
*
|
|
4
|
+
* This is the programmatic form of the `eigen-contract` executable. Most
|
|
5
|
+
* games should invoke the executable through their package script.
|
|
6
|
+
*/
|
|
7
|
+
export declare function emitConfiguredGameContract(root?: string): Promise<void>;
|
|
8
|
+
/**
|
|
9
|
+
* Fails when the conventionally configured contract is absent or stale.
|
|
10
|
+
*
|
|
11
|
+
* Use this in CI through `eigen-contract --check`.
|
|
12
|
+
*/
|
|
13
|
+
export declare function checkConfiguredGameContract(root?: string): Promise<void>;
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Emit the language-neutral contract a game's Flutter repository consumes.
|
|
3
|
+
*
|
|
4
|
+
* The authoritative inputs live with the TypeScript rules: the four payload
|
|
5
|
+
* schemas and the shared behavioral fixtures. The output is one deterministic
|
|
6
|
+
* JSON file so it can be copied, attached to a release, or fetched by checksum
|
|
7
|
+
* without assuming any repository layout.
|
|
8
|
+
*/
|
|
9
|
+
import { type GameModule } from "@eigeninteractive/rules";
|
|
10
|
+
/** Current format of the language-neutral contract consumed by EigenInteractive's Dart generator. */
|
|
11
|
+
export declare const GAME_CONTRACT_FORMAT_VERSION = 1;
|
|
12
|
+
/** One validated twin-fixture document embedded in a {@link GameContract}. */
|
|
13
|
+
export interface GameContractFixture {
|
|
14
|
+
/** POSIX-style path relative to the supplied fixtures root. */
|
|
15
|
+
path: string;
|
|
16
|
+
/** Validated fixture document, retained in its original JSON shape. */
|
|
17
|
+
document: unknown;
|
|
18
|
+
}
|
|
19
|
+
/** The four JSON Schemas emitted for one game `schemaVersion`. */
|
|
20
|
+
export interface GameContractVersion {
|
|
21
|
+
schemas: {
|
|
22
|
+
state: Record<string, unknown>;
|
|
23
|
+
observation: Record<string, unknown>;
|
|
24
|
+
action: Record<string, unknown>;
|
|
25
|
+
config: Record<string, unknown>;
|
|
26
|
+
};
|
|
27
|
+
}
|
|
28
|
+
/** Language-neutral schemas and fixtures shared by a game's Worker and app. */
|
|
29
|
+
export interface GameContract {
|
|
30
|
+
formatVersion: typeof GAME_CONTRACT_FORMAT_VERSION;
|
|
31
|
+
game: string;
|
|
32
|
+
versions: Record<string, GameContractVersion>;
|
|
33
|
+
fixtures: GameContractFixture[];
|
|
34
|
+
}
|
|
35
|
+
/** Inputs for building a {@link GameContract} without writing it. */
|
|
36
|
+
export interface BuildGameContractOptions {
|
|
37
|
+
/** Stable display name used as the generated Dart type prefix. */
|
|
38
|
+
game: string;
|
|
39
|
+
/** Authoritative TypeScript rules registry. */
|
|
40
|
+
gameModule: GameModule;
|
|
41
|
+
/** Root containing `v<N>/*.json` twin fixtures. */
|
|
42
|
+
fixturesRoot?: string | URL;
|
|
43
|
+
}
|
|
44
|
+
/** Inputs for emitting or checking a {@link GameContract} file. */
|
|
45
|
+
export interface EmitGameContractOptions extends BuildGameContractOptions {
|
|
46
|
+
/** Destination `game-contract.json` path. */
|
|
47
|
+
output: string | URL;
|
|
48
|
+
}
|
|
49
|
+
/** Build a deterministic in-memory contract without touching the filesystem. */
|
|
50
|
+
export declare function buildGameContract(options: BuildGameContractOptions): GameContract;
|
|
51
|
+
/** Render one deterministic, newline-terminated contract document. */
|
|
52
|
+
export declare function gameContractJson(options: BuildGameContractOptions): string;
|
|
53
|
+
/** Emit one deterministic, newline-terminated `game-contract.json`. */
|
|
54
|
+
export declare function emitGameContract(options: EmitGameContractOptions): void;
|
|
55
|
+
/** Fail when an emitted contract is missing or differs from its inputs. */
|
|
56
|
+
export declare function checkGameContract(options: EmitGameContractOptions): void;
|
|
57
|
+
/** A useful default filename for scripts that accept an output directory. */
|
|
58
|
+
export declare const gameContractFilename: (game: string) => string;
|
package/dist/index.d.ts
CHANGED
|
@@ -1,237 +1,11 @@
|
|
|
1
|
-
import { GameModule, GameRules, JsonObject, TransitionCause, OutcomeEntry, GameAccess, Json } from '@eigeninteractive/rules';
|
|
2
|
-
import { SeatView } from '@eigeninteractive/kernel';
|
|
3
|
-
export { CommitInput, CommitPlan, DEADLINE_GRACE_MS, Effect, GameRow, Intent, ObservationFrame, RejectCode, Rejected, Seat, SeatView, StateRow, commit, deriveRng, isRejected, randomSeed } from '@eigeninteractive/kernel';
|
|
4
|
-
|
|
5
1
|
/**
|
|
6
|
-
*
|
|
2
|
+
* `@eigeninteractive/testkit`: drive a game's rules through the real kernel without a
|
|
3
|
+
* Worker, a database or a network. Build a table, submit actions as seats,
|
|
4
|
+
* assert on the resulting transitions and per-seat observations.
|
|
7
5
|
*
|
|
8
|
-
*
|
|
9
|
-
* games should invoke the executable through their package script.
|
|
6
|
+
* @module @eigeninteractive/testkit
|
|
10
7
|
*/
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
* Use this in CI through `eigen-contract --check`.
|
|
16
|
-
*/
|
|
17
|
-
declare function checkConfiguredGameContract(root?: string): Promise<void>;
|
|
18
|
-
|
|
19
|
-
/**
|
|
20
|
-
* Emit the language-neutral contract a game's Flutter repository consumes.
|
|
21
|
-
*
|
|
22
|
-
* The authoritative inputs live with the TypeScript rules: the four payload
|
|
23
|
-
* schemas and the shared behavioral fixtures. The output is one deterministic
|
|
24
|
-
* JSON file so it can be copied, attached to a release, or fetched by checksum
|
|
25
|
-
* without assuming any repository layout.
|
|
26
|
-
*/
|
|
27
|
-
|
|
28
|
-
/** Current format of the language-neutral contract consumed by EigenInteractive's Dart generator. */
|
|
29
|
-
declare const GAME_CONTRACT_FORMAT_VERSION = 1;
|
|
30
|
-
/** One validated twin-fixture document embedded in a {@link GameContract}. */
|
|
31
|
-
interface GameContractFixture {
|
|
32
|
-
/** POSIX-style path relative to the supplied fixtures root. */
|
|
33
|
-
path: string;
|
|
34
|
-
/** Validated fixture document, retained in its original JSON shape. */
|
|
35
|
-
document: unknown;
|
|
36
|
-
}
|
|
37
|
-
/** The four JSON Schemas emitted for one game `schemaVersion`. */
|
|
38
|
-
interface GameContractVersion {
|
|
39
|
-
schemas: {
|
|
40
|
-
state: Record<string, unknown>;
|
|
41
|
-
observation: Record<string, unknown>;
|
|
42
|
-
action: Record<string, unknown>;
|
|
43
|
-
config: Record<string, unknown>;
|
|
44
|
-
};
|
|
45
|
-
}
|
|
46
|
-
/** Language-neutral schemas and fixtures shared by a game's Worker and app. */
|
|
47
|
-
interface GameContract {
|
|
48
|
-
formatVersion: typeof GAME_CONTRACT_FORMAT_VERSION;
|
|
49
|
-
game: string;
|
|
50
|
-
versions: Record<string, GameContractVersion>;
|
|
51
|
-
fixtures: GameContractFixture[];
|
|
52
|
-
}
|
|
53
|
-
/** Inputs for building a {@link GameContract} without writing it. */
|
|
54
|
-
interface BuildGameContractOptions {
|
|
55
|
-
/** Stable display name used as the generated Dart type prefix. */
|
|
56
|
-
game: string;
|
|
57
|
-
/** Authoritative TypeScript rules registry. */
|
|
58
|
-
gameModule: GameModule;
|
|
59
|
-
/** Root containing `v<N>/*.json` twin fixtures. */
|
|
60
|
-
fixturesRoot?: string | URL;
|
|
61
|
-
}
|
|
62
|
-
/** Inputs for emitting or checking a {@link GameContract} file. */
|
|
63
|
-
interface EmitGameContractOptions extends BuildGameContractOptions {
|
|
64
|
-
/** Destination `game-contract.json` path. */
|
|
65
|
-
output: string | URL;
|
|
66
|
-
}
|
|
67
|
-
/** Build a deterministic in-memory contract without touching the filesystem. */
|
|
68
|
-
declare function buildGameContract(options: BuildGameContractOptions): GameContract;
|
|
69
|
-
/** Render one deterministic, newline-terminated contract document. */
|
|
70
|
-
declare function gameContractJson(options: BuildGameContractOptions): string;
|
|
71
|
-
/** Emit one deterministic, newline-terminated `game-contract.json`. */
|
|
72
|
-
declare function emitGameContract(options: EmitGameContractOptions): void;
|
|
73
|
-
/** Fail when an emitted contract is missing or differs from its inputs. */
|
|
74
|
-
declare function checkGameContract(options: EmitGameContractOptions): void;
|
|
75
|
-
/** A useful default filename for scripts that accept an output directory. */
|
|
76
|
-
declare const gameContractFilename: (game: string) => string;
|
|
77
|
-
|
|
78
|
-
/**
|
|
79
|
-
* The kernel-scenario surface for game tests: how an implementor drives real
|
|
80
|
-
* engine transitions over their rules unit (same-view pairs, timing/grace
|
|
81
|
-
* behavior, lifecycle outcomes) without depending on the engine's internals.
|
|
82
|
-
*
|
|
83
|
-
* `@eigeninteractive/kernel` is an internal package: implementors ship `@eigeninteractive/rules` +
|
|
84
|
-
* `@eigeninteractive/server` and dev-depend on `@eigeninteractive/testkit` alone. Everything a
|
|
85
|
-
* game's test suite legitimately needs from the kernel is re-exported here,
|
|
86
|
-
* so the kernel's own surface stays free to churn.
|
|
87
|
-
*/
|
|
88
|
-
|
|
89
|
-
/** Project one seat's view of a state: the stored-frame shape the same-view
|
|
90
|
-
* rule compares (`commit()`'s `staleViews` input). Convenience for scenario
|
|
91
|
-
* tests that replay a simultaneous-move race. */
|
|
92
|
-
declare function projectView(rules: GameRules, args: {
|
|
93
|
-
state: JsonObject;
|
|
94
|
-
pending: number[];
|
|
95
|
-
/** The seat to project for, or null for a viewer. */
|
|
96
|
-
seat: number | null;
|
|
97
|
-
config: JsonObject;
|
|
98
|
-
cause?: TransitionCause;
|
|
99
|
-
participantCount?: number;
|
|
100
|
-
isReplay?: boolean;
|
|
101
|
-
}): SeatView;
|
|
102
|
-
|
|
103
|
-
/**
|
|
104
|
-
* Twin-drift fixture runner: the TS half of the shared JSON fixtures that
|
|
105
|
-
* keep a version unit's TS and Dart `GameRules` twins in sync. The JSON
|
|
106
|
-
* fixture format is shared verbatim with the Dart runner
|
|
107
|
-
* (`lib/testing/twin_fixtures.dart`): one file, two consumers.
|
|
108
|
-
*
|
|
109
|
-
* One fixture file per concern lives beside the version units at
|
|
110
|
-
* `<fixturesRoot>/v<N>/*.json` and is consumed by BOTH sides: this module
|
|
111
|
-
* runs each case against the TS unit (schemas + `applyAction` +
|
|
112
|
-
* `computeObservation` + the two predicates), while the Dart runner runs the
|
|
113
|
-
* same file against the Dart twin (generated payload parsing,
|
|
114
|
-
* `isValidAction`, `previewAction`, predicate twins). A behavioral divergence
|
|
115
|
-
* then fails one side's CI instead of degrading UX in production.
|
|
116
|
-
*
|
|
117
|
-
* ## Fixture file format
|
|
118
|
-
*
|
|
119
|
-
* ```jsonc
|
|
120
|
-
* {
|
|
121
|
-
* "schemaVersion": 1,
|
|
122
|
-
* "cases": [
|
|
123
|
-
* {
|
|
124
|
-
* "kind": "action",
|
|
125
|
-
* "name": "seat 0 marks an empty cell",
|
|
126
|
-
* "config": {},
|
|
127
|
-
* "state": { ... }, // TS: applyAction input
|
|
128
|
-
* "obs": { ... }, // Dart-only; defaults to `state`
|
|
129
|
-
* "pending": [0],
|
|
130
|
-
* "playerIndex": 0,
|
|
131
|
-
* "participantCount": 2, // optional, default 2
|
|
132
|
-
* "rngSeed": "any string", // optional, default "twin-fixtures"
|
|
133
|
-
* "action": { ... },
|
|
134
|
-
* "expected": {
|
|
135
|
-
* "valid": true, // false ⇒ TS IllegalMoveError,
|
|
136
|
-
* // Dart isValidAction false
|
|
137
|
-
* "state": { ... }, // optional, TS envelope.state
|
|
138
|
-
* "pending": [1], // optional, TS envelope.pendingPlayers
|
|
139
|
-
* "outcome": [ ... ], // optional, TS envelope.outcome
|
|
140
|
-
* // (null asserts the game is ongoing)
|
|
141
|
-
* "observation": { ... } // optional, the actor's post-action
|
|
142
|
-
* // view: TS computeObservation slice
|
|
143
|
-
* // data; Dart previewAction (when the
|
|
144
|
-
* // game implements optimism)
|
|
145
|
-
* }
|
|
146
|
-
* },
|
|
147
|
-
* { "kind": "ratingPool", "name": "...", "access": "public",
|
|
148
|
-
* "minPlayers": 2, "maxPlayers": 2, "config": {}, "expected": "blitz" },
|
|
149
|
-
* { "kind": "botSeatable", "name": "...", "gameConfig": {},
|
|
150
|
-
* "botConfig": {}, "expected": false }
|
|
151
|
-
* ]
|
|
152
|
-
* }
|
|
153
|
-
* ```
|
|
154
|
-
*
|
|
155
|
-
* The `state`/`obs` split exists for hidden-info games (a seat's observation
|
|
156
|
-
* is not the state); perfect-info games omit `obs`. `expected.observation` is
|
|
157
|
-
* the shared behavioral anchor: the TS side must project the post-action
|
|
158
|
-
* state to it, and a Dart `previewAction` that returns non-null must predict
|
|
159
|
-
* it, so the two sides are compared through one recorded value.
|
|
160
|
-
*
|
|
161
|
-
* Wire it up in a game-owned test file running under plain-Node vitest:
|
|
162
|
-
*
|
|
163
|
-
* ```ts
|
|
164
|
-
* import { twinFixtureTests } from "@eigeninteractive/testkit";
|
|
165
|
-
* import gameModule from "../src/module/index.js";
|
|
166
|
-
*
|
|
167
|
-
* twinFixtureTests(gameModule, new URL("../src/module/fixtures/", import.meta.url));
|
|
168
|
-
* ```
|
|
169
|
-
*/
|
|
170
|
-
|
|
171
|
-
/** One fixture file: cases targeting one `schemaVersion` unit. */
|
|
172
|
-
interface TwinFixtureFile {
|
|
173
|
-
schemaVersion: number;
|
|
174
|
-
cases: TwinFixtureCase[];
|
|
175
|
-
}
|
|
176
|
-
/** A game-action case: exercises schemas, `applyAction`, and (through
|
|
177
|
-
* `expected.observation`) `computeObservation` for the acting seat. */
|
|
178
|
-
interface ActionCase {
|
|
179
|
-
kind: "action";
|
|
180
|
-
name: string;
|
|
181
|
-
config: JsonObject;
|
|
182
|
-
state: JsonObject;
|
|
183
|
-
/** Dart-side observation payload; unused here (defaults to `state`). */
|
|
184
|
-
obs?: JsonObject;
|
|
185
|
-
pending: number[];
|
|
186
|
-
playerIndex: number;
|
|
187
|
-
participantCount?: number;
|
|
188
|
-
rngSeed?: string;
|
|
189
|
-
action: JsonObject;
|
|
190
|
-
expected: {
|
|
191
|
-
valid: boolean;
|
|
192
|
-
state?: JsonObject;
|
|
193
|
-
pending?: number[];
|
|
194
|
-
outcome?: OutcomeEntry[] | null;
|
|
195
|
-
observation?: JsonObject;
|
|
196
|
-
};
|
|
197
|
-
}
|
|
198
|
-
/** A `ratingPool` predicate case. Omitted timing fields mean null. */
|
|
199
|
-
interface RatingPoolCase {
|
|
200
|
-
kind: "ratingPool";
|
|
201
|
-
name: string;
|
|
202
|
-
access: GameAccess;
|
|
203
|
-
turnSeconds?: number | null;
|
|
204
|
-
budgetSeconds?: number | null;
|
|
205
|
-
incrementSeconds?: number | null;
|
|
206
|
-
minPlayers: number;
|
|
207
|
-
maxPlayers: number;
|
|
208
|
-
config: JsonObject;
|
|
209
|
-
expected: string | null;
|
|
210
|
-
}
|
|
211
|
-
/** A `botSeatable` predicate case. */
|
|
212
|
-
interface BotSeatableCase {
|
|
213
|
-
kind: "botSeatable";
|
|
214
|
-
name: string;
|
|
215
|
-
gameConfig: JsonObject;
|
|
216
|
-
botConfig: JsonObject;
|
|
217
|
-
expected: boolean;
|
|
218
|
-
}
|
|
219
|
-
type TwinFixtureCase = ActionCase | RatingPoolCase | BotSeatableCase;
|
|
220
|
-
/** Validate one fixture file's parsed JSON, or throw naming the offending
|
|
221
|
-
* file, case, and field. Exported so a repo can lint its fixtures without
|
|
222
|
-
* running them. */
|
|
223
|
-
declare function parseTwinFixtureFile(path: string, json: unknown): TwinFixtureFile;
|
|
224
|
-
/** Run one fixture case against a rules unit, returning failure descriptions
|
|
225
|
-
* (empty ⇒ the case passes). Pure; the file-reading test registrar is
|
|
226
|
-
* {@link twinFixtureTests}. */
|
|
227
|
-
declare function evaluateTwinCase(rules: GameRules, kase: TwinFixtureCase): string[];
|
|
228
|
-
/** Register one vitest test per fixture case found under `fixturesRoot`
|
|
229
|
-
* (layout: `<root>/v<N>/*.json`). Call at the top level of a test module
|
|
230
|
-
* running in a Node environment. */
|
|
231
|
-
declare function twinFixtureTests(gameModule: GameModule, fixturesRoot: string | URL): void;
|
|
232
|
-
/** Structural JSON equality. Object keys with `undefined` values count as
|
|
233
|
-
* absent (matching how schema libraries model optional fields); array order
|
|
234
|
-
* matters. */
|
|
235
|
-
declare function deepEquals(a: Json | undefined, b: Json | undefined): boolean;
|
|
236
|
-
|
|
237
|
-
export { type ActionCase, type BotSeatableCase, type BuildGameContractOptions, type EmitGameContractOptions, GAME_CONTRACT_FORMAT_VERSION, type GameContract, type GameContractFixture, type GameContractVersion, type RatingPoolCase, type TwinFixtureCase, type TwinFixtureFile, buildGameContract, checkConfiguredGameContract, checkGameContract, deepEquals, emitConfiguredGameContract, emitGameContract, evaluateTwinCase, gameContractFilename, gameContractJson, parseTwinFixtureFile, projectView, twinFixtureTests };
|
|
8
|
+
export { checkConfiguredGameContract, emitConfiguredGameContract } from "./contract-command.js";
|
|
9
|
+
export { type BuildGameContractOptions, buildGameContract, checkGameContract, type EmitGameContractOptions, emitGameContract, GAME_CONTRACT_FORMAT_VERSION, type GameContract, type GameContractFixture, type GameContractVersion, gameContractFilename, gameContractJson, } from "./game-contract.js";
|
|
10
|
+
export { type CommitInput, type CommitPlan, commit, DEADLINE_GRACE_MS, deriveRng, type Effect, type GameRow, type Intent, isRejected, type ObservationFrame, projectView, type RejectCode, type Rejected, randomSeed, type Seat, type SeatView, type StateRow, } from "./kernel-scenarios.js";
|
|
11
|
+
export { type ActionCase, type BotSeatableCase, deepEquals, evaluateTwinCase, type PlayerLimitsCase, parseTwinFixtureFile, type RatingPoolCase, type TwinFixtureCase, type TwinFixtureFile, twinFixtureTests, } from "./twin-fixtures.js";
|
package/dist/index.js
CHANGED
package/dist/inspect-cli.d.ts
CHANGED
|
@@ -1 +1,16 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* `eigen-inspect`: read a Worker's local `.wrangler` state from the terminal.
|
|
4
|
+
*
|
|
5
|
+
* Deliberately narrow. Wrangler already ships a first-party browser for local
|
|
6
|
+
* resources (press `e` in `wrangler dev`, or open `/cdn-cgi/explorer`), and
|
|
7
|
+
* generic table browsing is its job, not this tool's. What that view cannot do
|
|
8
|
+
* is answer a question in the engine's own terms, because a game's truth is
|
|
9
|
+
* split across two stores on purpose: the D1 index and the game's own Durable
|
|
10
|
+
* Object. This reads both, decodes the JSON columns, prints the transition log
|
|
11
|
+
* as a timeline, and says what the game is waiting for.
|
|
12
|
+
*
|
|
13
|
+
* It also runs with no dev server, no browser and no account, and emits
|
|
14
|
+
* `--json` for a script or an agent.
|
|
15
|
+
*/
|
|
16
|
+
export {};
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The kernel-scenario surface for game tests: how an implementor drives real
|
|
3
|
+
* engine transitions over their rules unit (same-view pairs, timing/grace
|
|
4
|
+
* behavior, lifecycle outcomes) without depending on the engine's internals.
|
|
5
|
+
*
|
|
6
|
+
* `@eigeninteractive/kernel` is an internal package: implementors ship `@eigeninteractive/rules` +
|
|
7
|
+
* `@eigeninteractive/server` and dev-depend on `@eigeninteractive/testkit` alone. Everything a
|
|
8
|
+
* game's test suite legitimately needs from the kernel is re-exported here,
|
|
9
|
+
* so the kernel's own surface stays free to churn.
|
|
10
|
+
*/
|
|
11
|
+
import { type SeatView } from "@eigeninteractive/kernel";
|
|
12
|
+
import type { GameRules, JsonObject, TransitionCause } from "@eigeninteractive/rules";
|
|
13
|
+
export type { CommitInput, CommitPlan, Effect, GameRow, Intent, ObservationFrame, RejectCode, Rejected, Seat, SeatView, StateRow, } from "@eigeninteractive/kernel";
|
|
14
|
+
export { commit, DEADLINE_GRACE_MS, deriveRng, isRejected, randomSeed, } from "@eigeninteractive/kernel";
|
|
15
|
+
/** Project one seat's view of a state: the stored-frame shape the same-view
|
|
16
|
+
* rule compares (`commit()`'s `staleViews` input). Convenience for scenario
|
|
17
|
+
* tests that replay a simultaneous-move race. */
|
|
18
|
+
export declare function projectView(rules: GameRules, args: {
|
|
19
|
+
state: JsonObject;
|
|
20
|
+
pending: number[];
|
|
21
|
+
/** The seat to project for, or null for a viewer. */
|
|
22
|
+
seat: number | null;
|
|
23
|
+
config: JsonObject;
|
|
24
|
+
cause?: TransitionCause;
|
|
25
|
+
participantCount?: number;
|
|
26
|
+
isReplay?: boolean;
|
|
27
|
+
}): SeatView;
|
package/dist/local-state.d.ts
CHANGED
|
@@ -1,5 +1,3 @@
|
|
|
1
|
-
import { DatabaseSync } from 'node:sqlite';
|
|
2
|
-
|
|
3
1
|
/**
|
|
4
2
|
* Read a Worker's LOCAL `.wrangler` state directly: the D1 index and the
|
|
5
3
|
* per-game Durable Object databases, opened as plain SQLite files.
|
|
@@ -34,9 +32,9 @@ import { DatabaseSync } from 'node:sqlite';
|
|
|
34
32
|
*
|
|
35
33
|
* @module @eigeninteractive/testkit/local-state
|
|
36
34
|
*/
|
|
37
|
-
|
|
35
|
+
import { DatabaseSync } from "node:sqlite";
|
|
38
36
|
/** A local Durable Object database: one game's whole session. */
|
|
39
|
-
interface LocalDurableObject {
|
|
37
|
+
export interface LocalDurableObject {
|
|
40
38
|
/** The Durable Object class, parsed from the directory Miniflare names
|
|
41
39
|
* `<worker>-<ClassName>`. */
|
|
42
40
|
className: string;
|
|
@@ -53,17 +51,17 @@ interface LocalDurableObject {
|
|
|
53
51
|
/** What a bound parameter may be: SQLite's own value domain, spelled out here
|
|
54
52
|
* rather than re-exported from `node:sqlite` so the public signature does not
|
|
55
53
|
* depend on a built-in module's type names. */
|
|
56
|
-
type LocalQueryParam = string | number | bigint | null | Uint8Array;
|
|
54
|
+
export type LocalQueryParam = string | number | bigint | null | Uint8Array;
|
|
57
55
|
/** A row of Miniflare's alarm table: the DO's armed alarm, which for a game is
|
|
58
56
|
* its turn deadline plus grace. An absent row means no timer is armed, which is
|
|
59
57
|
* correct for an untimed game and a bug for a timed one mid-turn. */
|
|
60
|
-
interface LocalAlarm {
|
|
58
|
+
export interface LocalAlarm {
|
|
61
59
|
actorId: string;
|
|
62
60
|
actorName: string | null;
|
|
63
61
|
scheduledTime: number | null;
|
|
64
62
|
}
|
|
65
63
|
/** The engine's `games` row: the D1 index entry, a display mirror of the DO. */
|
|
66
|
-
interface LocalGameRow {
|
|
64
|
+
export interface LocalGameRow {
|
|
67
65
|
id: string;
|
|
68
66
|
createdBy: string | null;
|
|
69
67
|
status: string;
|
|
@@ -89,7 +87,7 @@ interface LocalGameRow {
|
|
|
89
87
|
}
|
|
90
88
|
/** One seat, from either store. `username` is filled in from D1's `users` and
|
|
91
89
|
* `bots` tables when the reader has an index to join against. */
|
|
92
|
-
interface LocalSeat {
|
|
90
|
+
export interface LocalSeat {
|
|
93
91
|
playerIndex: number;
|
|
94
92
|
userId: string | null;
|
|
95
93
|
botId: string | null;
|
|
@@ -98,7 +96,7 @@ interface LocalSeat {
|
|
|
98
96
|
displayName: string | null;
|
|
99
97
|
}
|
|
100
98
|
/** The DO's single `meta` row: the authoritative session header. */
|
|
101
|
-
interface LocalGameMeta {
|
|
99
|
+
export interface LocalGameMeta {
|
|
102
100
|
gameId: string;
|
|
103
101
|
status: string;
|
|
104
102
|
access: string;
|
|
@@ -115,7 +113,7 @@ interface LocalGameMeta {
|
|
|
115
113
|
rngSeed: string | null;
|
|
116
114
|
}
|
|
117
115
|
/** One committed transition, decoded. `action` is null at v0 (the start). */
|
|
118
|
-
interface LocalTransition {
|
|
116
|
+
export interface LocalTransition {
|
|
119
117
|
version: number;
|
|
120
118
|
state: unknown;
|
|
121
119
|
action: {
|
|
@@ -137,7 +135,7 @@ interface LocalTransition {
|
|
|
137
135
|
/** Why the game is where it is, and what would move it. Derived rather than
|
|
138
136
|
* stored: this is the sentence a developer actually wants, and every input to
|
|
139
137
|
* it is already on screen above it. */
|
|
140
|
-
interface LocalGameDiagnosis {
|
|
138
|
+
export interface LocalGameDiagnosis {
|
|
141
139
|
/** One line naming the next expected event, or the reason there is none. */
|
|
142
140
|
summary: string;
|
|
143
141
|
/** Disagreements between the D1 mirror and the DO's own truth. A non-empty
|
|
@@ -145,7 +143,7 @@ interface LocalGameDiagnosis {
|
|
|
145
143
|
mirrorDrift: string[];
|
|
146
144
|
}
|
|
147
145
|
/** Everything both stores know about one game. */
|
|
148
|
-
interface LocalGameView {
|
|
146
|
+
export interface LocalGameView {
|
|
149
147
|
gameId: string;
|
|
150
148
|
/** The D1 index row, or null when D1 has no such game: either the id came
|
|
151
149
|
* from a DO name and the index was wiped, or the create write never landed. */
|
|
@@ -182,7 +180,7 @@ interface LocalGameView {
|
|
|
182
180
|
* inside a game repository, including the app half of a two-package layout,
|
|
183
181
|
* where the state lives a directory or two above the shell's cwd.
|
|
184
182
|
*/
|
|
185
|
-
declare function findWranglerState(from?: string): string | null;
|
|
183
|
+
export declare function findWranglerState(from?: string): string | null;
|
|
186
184
|
/**
|
|
187
185
|
* Open a SQLite file for reading only.
|
|
188
186
|
*
|
|
@@ -196,7 +194,7 @@ declare function findWranglerState(from?: string): string | null;
|
|
|
196
194
|
* because that fallback would otherwise CREATE a database rather than report a
|
|
197
195
|
* missing one.
|
|
198
196
|
*/
|
|
199
|
-
declare function openSqlite(file: string): DatabaseSync;
|
|
197
|
+
export declare function openSqlite(file: string): DatabaseSync;
|
|
200
198
|
/**
|
|
201
199
|
* A Worker's local state, with its databases opened lazily and held open.
|
|
202
200
|
*
|
|
@@ -204,7 +202,7 @@ declare function openSqlite(file: string): DatabaseSync;
|
|
|
204
202
|
* {@link close} it. A single instance is the unit both the CLI and a test use,
|
|
205
203
|
* so neither has to know which file backs which resource.
|
|
206
204
|
*/
|
|
207
|
-
declare class LocalStore {
|
|
205
|
+
export declare class LocalStore {
|
|
208
206
|
#private;
|
|
209
207
|
/** Absolute path to `.wrangler/state/v3`. */
|
|
210
208
|
readonly root: string;
|
|
@@ -277,5 +275,3 @@ declare class LocalStore {
|
|
|
277
275
|
/** Release every open handle. */
|
|
278
276
|
close(): void;
|
|
279
277
|
}
|
|
280
|
-
|
|
281
|
-
export { type LocalAlarm, type LocalDurableObject, type LocalGameDiagnosis, type LocalGameMeta, type LocalGameRow, type LocalGameView, type LocalQueryParam, type LocalSeat, LocalStore, type LocalTransition, findWranglerState, openSqlite };
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Twin-drift fixture runner: the TS half of the shared JSON fixtures that
|
|
3
|
+
* keep a version unit's TS and Dart `GameRules` twins in sync. The JSON
|
|
4
|
+
* fixture format is shared verbatim with the Dart runner
|
|
5
|
+
* (`lib/testing/twin_fixtures.dart`): one file, two consumers.
|
|
6
|
+
*
|
|
7
|
+
* One fixture file per concern lives beside the version units at
|
|
8
|
+
* `<fixturesRoot>/v<N>/*.json` and is consumed by BOTH sides: this module
|
|
9
|
+
* runs each case against the TS unit (schemas + `applyAction` +
|
|
10
|
+
* `computeObservation` + the two predicates), while the Dart runner runs the
|
|
11
|
+
* same file against the Dart twin (generated payload parsing,
|
|
12
|
+
* `isValidAction`, `previewAction`, predicate twins). A behavioral divergence
|
|
13
|
+
* then fails one side's CI instead of degrading UX in production.
|
|
14
|
+
*
|
|
15
|
+
* ## Fixture file format
|
|
16
|
+
*
|
|
17
|
+
* ```jsonc
|
|
18
|
+
* {
|
|
19
|
+
* "schemaVersion": 1,
|
|
20
|
+
* "cases": [
|
|
21
|
+
* {
|
|
22
|
+
* "kind": "action",
|
|
23
|
+
* "name": "seat 0 marks an empty cell",
|
|
24
|
+
* "config": {},
|
|
25
|
+
* "state": { ... }, // TS: applyAction input
|
|
26
|
+
* "obs": { ... }, // Dart-only; defaults to `state`
|
|
27
|
+
* "pending": [0],
|
|
28
|
+
* "playerIndex": 0,
|
|
29
|
+
* "participantCount": 2, // optional, default 2
|
|
30
|
+
* "rngSeed": "any string", // optional, default "twin-fixtures"
|
|
31
|
+
* "action": { ... },
|
|
32
|
+
* "expected": {
|
|
33
|
+
* "valid": true, // false ⇒ TS IllegalMoveError,
|
|
34
|
+
* // Dart isValidAction false
|
|
35
|
+
* "state": { ... }, // optional, TS envelope.state
|
|
36
|
+
* "pending": [1], // optional, TS envelope.pendingPlayers
|
|
37
|
+
* "outcome": [ ... ], // optional, TS envelope.outcome
|
|
38
|
+
* // (null asserts the game is ongoing)
|
|
39
|
+
* "observation": { ... } // optional, the actor's post-action
|
|
40
|
+
* // view: TS computeObservation slice
|
|
41
|
+
* // data; Dart previewAction (when the
|
|
42
|
+
* // game implements optimism)
|
|
43
|
+
* }
|
|
44
|
+
* },
|
|
45
|
+
* { "kind": "playerLimits", "name": "...", "config": {},
|
|
46
|
+
* "expected": { "minPlayers": 2, "maxPlayers": 2 } },
|
|
47
|
+
* { "kind": "ratingPool", "name": "...", "access": "public",
|
|
48
|
+
* "minPlayers": 2, "maxPlayers": 2, "config": {}, "expected": "blitz" },
|
|
49
|
+
* { "kind": "botSeatable", "name": "...", "gameConfig": {},
|
|
50
|
+
* "botConfig": {}, "expected": false }
|
|
51
|
+
* ]
|
|
52
|
+
* }
|
|
53
|
+
* ```
|
|
54
|
+
*
|
|
55
|
+
* The `state`/`obs` split exists for hidden-info games (a seat's observation
|
|
56
|
+
* is not the state); perfect-info games omit `obs`. `expected.observation` is
|
|
57
|
+
* the shared behavioral anchor: the TS side must project the post-action
|
|
58
|
+
* state to it, and a Dart `previewAction` that returns non-null must predict
|
|
59
|
+
* it, so the two sides are compared through one recorded value.
|
|
60
|
+
*
|
|
61
|
+
* Wire it up in a game-owned test file running under plain-Node vitest:
|
|
62
|
+
*
|
|
63
|
+
* ```ts
|
|
64
|
+
* import { twinFixtureTests } from "@eigeninteractive/testkit";
|
|
65
|
+
* import gameModule from "../src/module/index.js";
|
|
66
|
+
*
|
|
67
|
+
* twinFixtureTests(gameModule, new URL("../src/module/fixtures/", import.meta.url));
|
|
68
|
+
* ```
|
|
69
|
+
*/
|
|
70
|
+
import { type GameAccess, type GameModule, type GameRules, type Json, type JsonObject, type OutcomeEntry } from "@eigeninteractive/rules";
|
|
71
|
+
/** One fixture file: cases targeting one `schemaVersion` unit. */
|
|
72
|
+
export interface TwinFixtureFile {
|
|
73
|
+
schemaVersion: number;
|
|
74
|
+
cases: TwinFixtureCase[];
|
|
75
|
+
}
|
|
76
|
+
/** A game-action case: exercises schemas, `applyAction`, and (through
|
|
77
|
+
* `expected.observation`) `computeObservation` for the acting seat. */
|
|
78
|
+
export interface ActionCase {
|
|
79
|
+
kind: "action";
|
|
80
|
+
name: string;
|
|
81
|
+
config: JsonObject;
|
|
82
|
+
state: JsonObject;
|
|
83
|
+
/** Dart-side observation payload; unused here (defaults to `state`). */
|
|
84
|
+
obs?: JsonObject;
|
|
85
|
+
pending: number[];
|
|
86
|
+
playerIndex: number;
|
|
87
|
+
participantCount?: number;
|
|
88
|
+
rngSeed?: string;
|
|
89
|
+
action: JsonObject;
|
|
90
|
+
expected: {
|
|
91
|
+
valid: boolean;
|
|
92
|
+
state?: JsonObject;
|
|
93
|
+
pending?: number[];
|
|
94
|
+
outcome?: OutcomeEntry[] | null;
|
|
95
|
+
observation?: JsonObject;
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
/** A `ratingPool` predicate case. Omitted timing fields mean null. */
|
|
99
|
+
export interface RatingPoolCase {
|
|
100
|
+
kind: "ratingPool";
|
|
101
|
+
name: string;
|
|
102
|
+
access: GameAccess;
|
|
103
|
+
turnSeconds?: number | null;
|
|
104
|
+
budgetSeconds?: number | null;
|
|
105
|
+
incrementSeconds?: number | null;
|
|
106
|
+
minPlayers: number;
|
|
107
|
+
maxPlayers: number;
|
|
108
|
+
config: JsonObject;
|
|
109
|
+
expected: string | null;
|
|
110
|
+
}
|
|
111
|
+
/** A `playerLimits` case: the seats one config may be played with. */
|
|
112
|
+
export interface PlayerLimitsCase {
|
|
113
|
+
kind: "playerLimits";
|
|
114
|
+
name: string;
|
|
115
|
+
config: JsonObject;
|
|
116
|
+
expected: {
|
|
117
|
+
minPlayers: number;
|
|
118
|
+
maxPlayers: number;
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
/** A `botSeatable` predicate case. */
|
|
122
|
+
export interface BotSeatableCase {
|
|
123
|
+
kind: "botSeatable";
|
|
124
|
+
name: string;
|
|
125
|
+
gameConfig: JsonObject;
|
|
126
|
+
botConfig: JsonObject;
|
|
127
|
+
expected: boolean;
|
|
128
|
+
}
|
|
129
|
+
export type TwinFixtureCase = ActionCase | PlayerLimitsCase | RatingPoolCase | BotSeatableCase;
|
|
130
|
+
/** Validate one fixture file's parsed JSON, or throw naming the offending
|
|
131
|
+
* file, case, and field. Exported so a repo can lint its fixtures without
|
|
132
|
+
* running them. */
|
|
133
|
+
export declare function parseTwinFixtureFile(path: string, json: unknown): TwinFixtureFile;
|
|
134
|
+
/** Run one fixture case against a rules unit, returning failure descriptions
|
|
135
|
+
* (empty ⇒ the case passes). Pure; the file-reading test registrar is
|
|
136
|
+
* {@link twinFixtureTests}. */
|
|
137
|
+
export declare function evaluateTwinCase(rules: GameRules, kase: TwinFixtureCase): string[];
|
|
138
|
+
/** Register one vitest test per fixture case found under `fixturesRoot`
|
|
139
|
+
* (layout: `<root>/v<N>/*.json`). Call at the top level of a test module
|
|
140
|
+
* running in a Node environment. */
|
|
141
|
+
export declare function twinFixtureTests(gameModule: GameModule, fixturesRoot: string | URL): void;
|
|
142
|
+
/** Structural JSON equality. Object keys with `undefined` values count as
|
|
143
|
+
* absent (matching how schema libraries model optional fields); array order
|
|
144
|
+
* matters. */
|
|
145
|
+
export declare function deepEquals(a: Json | undefined, b: Json | undefined): boolean;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@eigeninteractive/testkit",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.1",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"description": "Test helpers for games built on the EigenInteractive engine: drive rules through the real kernel and run shared twin fixtures, with no Worker, database or network.",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -36,16 +36,16 @@
|
|
|
36
36
|
"dependencies": {
|
|
37
37
|
"rand-seed": "^3.0.0",
|
|
38
38
|
"tsx": "^4.23.1",
|
|
39
|
-
"@eigeninteractive/kernel": "0.
|
|
39
|
+
"@eigeninteractive/kernel": "0.5.1"
|
|
40
40
|
},
|
|
41
41
|
"devDependencies": {
|
|
42
42
|
"@types/node": "^26.1.1",
|
|
43
43
|
"vitest": "^4.1.10",
|
|
44
|
-
"@eigeninteractive/rules": "0.
|
|
44
|
+
"@eigeninteractive/rules": "0.5.1"
|
|
45
45
|
},
|
|
46
46
|
"peerDependencies": {
|
|
47
47
|
"vitest": "^4.1.0",
|
|
48
|
-
"@eigeninteractive/rules": "^0.
|
|
48
|
+
"@eigeninteractive/rules": "^0.5.1"
|
|
49
49
|
},
|
|
50
50
|
"homepage": "https://eigeninteractive.com",
|
|
51
51
|
"repository": {
|
|
@@ -60,7 +60,7 @@
|
|
|
60
60
|
"access": "public"
|
|
61
61
|
},
|
|
62
62
|
"scripts": {
|
|
63
|
-
"build": "tsup",
|
|
63
|
+
"build": "tsup && tsc -p tsconfig.build.json",
|
|
64
64
|
"dev": "tsup --watch",
|
|
65
65
|
"test": "vitest run --passWithNoTests",
|
|
66
66
|
"typecheck": "tsc --noEmit -p tsconfig.json"
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/twin-fixtures.ts","../src/game-contract.ts","../src/contract-command.ts"],"sourcesContent":["/**\n * Twin-drift fixture runner: the TS half of the shared JSON fixtures that\n * keep a version unit's TS and Dart `GameRules` twins in sync. The JSON\n * fixture format is shared verbatim with the Dart runner\n * (`lib/testing/twin_fixtures.dart`): one file, two consumers.\n *\n * One fixture file per concern lives beside the version units at\n * `<fixturesRoot>/v<N>/*.json` and is consumed by BOTH sides: this module\n * runs each case against the TS unit (schemas + `applyAction` +\n * `computeObservation` + the two predicates), while the Dart runner runs the\n * same file against the Dart twin (generated payload parsing,\n * `isValidAction`, `previewAction`, predicate twins). A behavioral divergence\n * then fails one side's CI instead of degrading UX in production.\n *\n * ## Fixture file format\n *\n * ```jsonc\n * {\n * \"schemaVersion\": 1,\n * \"cases\": [\n * {\n * \"kind\": \"action\",\n * \"name\": \"seat 0 marks an empty cell\",\n * \"config\": {},\n * \"state\": { ... }, // TS: applyAction input\n * \"obs\": { ... }, // Dart-only; defaults to `state`\n * \"pending\": [0],\n * \"playerIndex\": 0,\n * \"participantCount\": 2, // optional, default 2\n * \"rngSeed\": \"any string\", // optional, default \"twin-fixtures\"\n * \"action\": { ... },\n * \"expected\": {\n * \"valid\": true, // false ⇒ TS IllegalMoveError,\n * // Dart isValidAction false\n * \"state\": { ... }, // optional, TS envelope.state\n * \"pending\": [1], // optional, TS envelope.pendingPlayers\n * \"outcome\": [ ... ], // optional, TS envelope.outcome\n * // (null asserts the game is ongoing)\n * \"observation\": { ... } // optional, the actor's post-action\n * // view: TS computeObservation slice\n * // data; Dart previewAction (when the\n * // game implements optimism)\n * }\n * },\n * { \"kind\": \"ratingPool\", \"name\": \"...\", \"access\": \"public\",\n * \"minPlayers\": 2, \"maxPlayers\": 2, \"config\": {}, \"expected\": \"blitz\" },\n * { \"kind\": \"botSeatable\", \"name\": \"...\", \"gameConfig\": {},\n * \"botConfig\": {}, \"expected\": false }\n * ]\n * }\n * ```\n *\n * The `state`/`obs` split exists for hidden-info games (a seat's observation\n * is not the state); perfect-info games omit `obs`. `expected.observation` is\n * the shared behavioral anchor: the TS side must project the post-action\n * state to it, and a Dart `previewAction` that returns non-null must predict\n * it, so the two sides are compared through one recorded value.\n *\n * Wire it up in a game-owned test file running under plain-Node vitest:\n *\n * ```ts\n * import { twinFixtureTests } from \"@eigeninteractive/testkit\";\n * import gameModule from \"../src/module/index.js\";\n *\n * twinFixtureTests(gameModule, new URL(\"../src/module/fixtures/\", import.meta.url));\n * ```\n */\n\nimport { readdirSync, readFileSync } from \"node:fs\";\nimport { type Envelope, type GameAccess, type GameModule, type GameRules, IllegalMoveError, type Json, type JsonObject, type ObservationSlice, type OutcomeEntry } from \"@eigeninteractive/rules\";\nimport Rand from \"rand-seed\";\nimport { it } from \"vitest\";\n\n/** One fixture file: cases targeting one `schemaVersion` unit. */\nexport interface TwinFixtureFile {\n schemaVersion: number;\n cases: TwinFixtureCase[];\n}\n\n/** A game-action case: exercises schemas, `applyAction`, and (through\n * `expected.observation`) `computeObservation` for the acting seat. */\nexport interface ActionCase {\n kind: \"action\";\n name: string;\n config: JsonObject;\n state: JsonObject;\n /** Dart-side observation payload; unused here (defaults to `state`). */\n obs?: JsonObject;\n pending: number[];\n playerIndex: number;\n participantCount?: number;\n rngSeed?: string;\n action: JsonObject;\n expected: {\n valid: boolean;\n state?: JsonObject;\n pending?: number[];\n outcome?: OutcomeEntry[] | null;\n observation?: JsonObject;\n };\n}\n\n/** A `ratingPool` predicate case. Omitted timing fields mean null. */\nexport interface RatingPoolCase {\n kind: \"ratingPool\";\n name: string;\n access: GameAccess;\n turnSeconds?: number | null;\n budgetSeconds?: number | null;\n incrementSeconds?: number | null;\n minPlayers: number;\n maxPlayers: number;\n config: JsonObject;\n expected: string | null;\n}\n\n/** A `botSeatable` predicate case. */\nexport interface BotSeatableCase {\n kind: \"botSeatable\";\n name: string;\n gameConfig: JsonObject;\n botConfig: JsonObject;\n expected: boolean;\n}\n\nexport type TwinFixtureCase = ActionCase | RatingPoolCase | BotSeatableCase;\n\n// ── Fixture validation ────────────────────────────────────────────────────────\n//\n// The case types above are compile-time only; the JSON they describe arrives\n// at runtime from a hand-written file. Asserting `JSON.parse(...) as\n// TwinFixtureFile` would make every field a lie the moment a fixture is\n// mistyped, and because most fields flow straight into a comparison, the\n// symptom would be a confusing `undefined` diff attributed to the game's\n// rules rather than to the fixture. These parsers close that gap: a\n// malformed fixture fails at LOAD, naming the file, the case, and the field.\n//\n// Hand-written rather than schema-library-backed on purpose: `@eigeninteractive/rules`\n// describes an implementor's schemas with `StandardSchemaV1` precisely so the\n// engine never mandates a validation library, and the Dart twin runner is\n// deliberately framework-free. This is ~80 lines and keeps both true.\n\nfunction describe(value: unknown): string {\n if (value === null) return \"null\";\n if (Array.isArray(value)) return \"an array\";\n return typeof value;\n}\n\nfunction fail(where: string, expected: string, got: unknown): never {\n throw new Error(`${where}: expected ${expected}, got ${describe(got)}`);\n}\n\nfunction asObject(where: string, v: unknown): JsonObject {\n if (typeof v !== \"object\" || v === null || Array.isArray(v)) fail(where, \"an object\", v);\n return v as JsonObject;\n}\n\nfunction asString(where: string, v: unknown): string {\n if (typeof v !== \"string\") fail(where, \"a string\", v);\n return v;\n}\n\nfunction asNumber(where: string, v: unknown): number {\n if (typeof v !== \"number\" || !Number.isFinite(v)) fail(where, \"a finite number\", v);\n return v;\n}\n\nfunction asBoolean(where: string, v: unknown): boolean {\n if (typeof v !== \"boolean\") fail(where, \"a boolean\", v);\n return v;\n}\n\nfunction asNumberArray(where: string, v: unknown): number[] {\n if (!Array.isArray(v)) fail(where, \"an array of numbers\", v);\n return v.map((n, i) => asNumber(`${where}[${i}]`, n));\n}\n\n/** Applies `read` only when the key is present and non-null; absent and\n * explicit null both mean \"not specified\" for every optional fixture field. */\nfunction optional<T>(where: string, v: unknown, read: (where: string, v: unknown) => T): T | undefined {\n return v === undefined || v === null ? undefined : read(where, v);\n}\n\nfunction parseActionCase(where: string, raw: JsonObject): ActionCase {\n const expectedRaw = asObject(`${where}.expected`, raw.expected);\n const expected: ActionCase[\"expected\"] = {\n valid: asBoolean(`${where}.expected.valid`, expectedRaw.valid),\n state: optional(`${where}.expected.state`, expectedRaw.state, asObject),\n pending: optional(`${where}.expected.pending`, expectedRaw.pending, asNumberArray),\n observation: optional(`${where}.expected.observation`, expectedRaw.observation, asObject),\n };\n // `outcome` is three-valued: absent (unchecked), null (asserts the game is\n // ongoing), or a list. `checkEnvelope` distinguishes absent from null with\n // an `in` test, so the key must only be set when the fixture set it.\n if (\"outcome\" in expectedRaw) {\n const outcome = expectedRaw.outcome;\n if (outcome !== null && !Array.isArray(outcome)) fail(`${where}.expected.outcome`, \"an array or null\", outcome);\n expected.outcome = outcome as OutcomeEntry[] | null;\n }\n return {\n kind: \"action\",\n name: asString(`${where}.name`, raw.name),\n config: asObject(`${where}.config`, raw.config),\n state: asObject(`${where}.state`, raw.state),\n obs: optional(`${where}.obs`, raw.obs, asObject),\n pending: asNumberArray(`${where}.pending`, raw.pending),\n playerIndex: asNumber(`${where}.playerIndex`, raw.playerIndex),\n participantCount: optional(`${where}.participantCount`, raw.participantCount, asNumber),\n rngSeed: optional(`${where}.rngSeed`, raw.rngSeed, asString),\n action: asObject(`${where}.action`, raw.action),\n expected,\n };\n}\n\nfunction parseRatingPoolCase(where: string, raw: JsonObject): RatingPoolCase {\n const access = asString(`${where}.access`, raw.access);\n if (access !== \"public\" && access !== \"private\" && access !== \"friends\") {\n throw new Error(`${where}.access: expected one of public | private | friends, got ${JSON.stringify(access)}`);\n }\n return {\n kind: \"ratingPool\",\n name: asString(`${where}.name`, raw.name),\n access,\n turnSeconds: optional(`${where}.turnSeconds`, raw.turnSeconds, asNumber) ?? null,\n budgetSeconds: optional(`${where}.budgetSeconds`, raw.budgetSeconds, asNumber) ?? null,\n incrementSeconds: optional(`${where}.incrementSeconds`, raw.incrementSeconds, asNumber) ?? null,\n minPlayers: asNumber(`${where}.minPlayers`, raw.minPlayers),\n maxPlayers: asNumber(`${where}.maxPlayers`, raw.maxPlayers),\n config: asObject(`${where}.config`, raw.config),\n expected: raw.expected === null ? null : asString(`${where}.expected`, raw.expected),\n };\n}\n\nfunction parseBotSeatableCase(where: string, raw: JsonObject): BotSeatableCase {\n return {\n kind: \"botSeatable\",\n name: asString(`${where}.name`, raw.name),\n gameConfig: asObject(`${where}.gameConfig`, raw.gameConfig),\n botConfig: asObject(`${where}.botConfig`, raw.botConfig),\n expected: asBoolean(`${where}.expected`, raw.expected),\n };\n}\n\n/** Validate one fixture file's parsed JSON, or throw naming the offending\n * file, case, and field. Exported so a repo can lint its fixtures without\n * running them. */\nexport function parseTwinFixtureFile(path: string, json: unknown): TwinFixtureFile {\n const root = asObject(path, json);\n const schemaVersion = asNumber(`${path}.schemaVersion`, root.schemaVersion);\n if (!Array.isArray(root.cases)) fail(`${path}.cases`, \"an array\", root.cases);\n const cases = root.cases.map((raw, i) => {\n // Prefer the case's own name in the location once we can read it: a\n // fixture author finds \"cases[3] (seat 0 wins)\" faster than an index.\n const indexed = `${path}.cases[${i}]`;\n const obj = asObject(indexed, raw);\n const where = typeof obj.name === \"string\" ? `${indexed} (${obj.name})` : indexed;\n switch (obj.kind) {\n case \"action\":\n return parseActionCase(where, obj);\n case \"ratingPool\":\n return parseRatingPoolCase(where, obj);\n case \"botSeatable\":\n return parseBotSeatableCase(where, obj);\n default:\n throw new Error(`${where}.kind: expected one of action | ratingPool | botSeatable, got ${JSON.stringify(obj.kind)}`);\n }\n });\n return { schemaVersion, cases };\n}\n\n/** Run one fixture case against a rules unit, returning failure descriptions\n * (empty ⇒ the case passes). Pure; the file-reading test registrar is\n * {@link twinFixtureTests}. */\nexport function evaluateTwinCase(rules: GameRules, kase: TwinFixtureCase): string[] {\n switch (kase.kind) {\n case \"action\":\n return evaluateAction(rules, kase);\n case \"ratingPool\":\n return evaluateRatingPool(rules, kase);\n case \"botSeatable\":\n return evaluateBotSeatable(rules, kase);\n default:\n return [`unknown case kind \"${(kase as { kind: string }).kind}\", expected action | ratingPool | botSeatable`];\n }\n}\n\n/** Register one vitest test per fixture case found under `fixturesRoot`\n * (layout: `<root>/v<N>/*.json`). Call at the top level of a test module\n * running in a Node environment. */\nexport function twinFixtureTests(gameModule: GameModule, fixturesRoot: string | URL): void {\n for (const filePath of fixtureFiles(fixturesRoot)) {\n const fixture = parseTwinFixtureFile(filePath, JSON.parse(readFileSync(filePath, \"utf8\")));\n const rules = gameModule.versions[fixture.schemaVersion];\n for (const kase of fixture.cases) {\n it(`twin v${fixture.schemaVersion}: ${kase.name}`, () => {\n if (!rules) {\n throw new Error(`gameModule ships no rules unit for schemaVersion ${fixture.schemaVersion} (fixture: ${filePath})`);\n }\n const failures = evaluateTwinCase(rules, kase);\n if (failures.length) throw new Error(`\\n${failures.join(\"\\n\")}`);\n });\n }\n }\n}\n\nfunction* fixtureFiles(root: string | URL): Generator<string> {\n const dirs = readdirSync(root, { withFileTypes: true })\n .filter((e) => e.isDirectory())\n .sort((a, b) => a.name.localeCompare(b.name));\n for (const dir of dirs) {\n const files = readdirSync(`${dir.parentPath}/${dir.name}`, {\n withFileTypes: true,\n })\n .filter((e) => e.isFile() && e.name.endsWith(\".json\"))\n .sort((a, b) => a.name.localeCompare(b.name));\n for (const file of files) yield `${file.parentPath}/${file.name}`;\n }\n}\n\n// ── Case evaluators ───────────────────────────────────────────────────────────\n\nfunction evaluateAction(rules: GameRules, kase: ActionCase): string[] {\n const failures: string[] = [];\n const config = parseWith(rules, \"config\", kase.config, failures);\n const state = parseWith(rules, \"state\", kase.state, failures);\n const action = parseWith(rules, \"action\", kase.action, failures);\n if (config === undefined || state === undefined || action === undefined) {\n return failures;\n }\n\n // The parsed action must be the fixture action: a schema that strips or\n // defaults fields the twin relies on is itself drift.\n if (!deepEquals(action, kase.action)) {\n failures.push(`action schema does not preserve the fixture action, parsed to ${JSON.stringify(action)}`);\n }\n\n const envelope = applyFixtureAction(rules, kase, config, state, action);\n if (typeof envelope === \"string\") {\n if (envelope) failures.push(envelope);\n return failures;\n }\n checkEnvelope(rules, kase, envelope, failures);\n if (kase.expected.observation !== undefined) {\n checkObservation(rules, kase, envelope, config, action, failures);\n }\n return failures;\n}\n\n/** Invoke `applyAction` and reconcile with `expected.valid`. Returns the\n * envelope on a valid accepted move, an error string on failure, or \"\" when\n * an expected-illegal move was correctly rejected (nothing left to check). */\nfunction applyFixtureAction(rules: GameRules, kase: ActionCase, config: JsonObject, state: JsonObject, action: JsonObject): Envelope | string {\n let envelope: Envelope;\n try {\n envelope = rules.applyAction({\n state,\n pending: kase.pending,\n data: action,\n playerIndex: kase.playerIndex,\n rng: new Rand(kase.rngSeed ?? \"twin-fixtures\"),\n config,\n });\n } catch (error) {\n if (!(error instanceof IllegalMoveError)) {\n return `applyAction threw a non-IllegalMoveError: ${error}`;\n }\n return kase.expected.valid ? `applyAction rejected a move the fixture expects to be valid: ${error.message}` : \"\";\n }\n return kase.expected.valid ? envelope : \"applyAction accepted a move the fixture expects to be illegal\";\n}\n\nfunction checkEnvelope(rules: GameRules, kase: ActionCase, envelope: Envelope, failures: string[]): void {\n if (validate(rules, \"state\", envelope.state) === undefined) {\n failures.push(\"applyAction returned state that violates its own schema\");\n }\n const expected = kase.expected;\n if (expected.state !== undefined && !deepEquals(envelope.state, expected.state)) {\n failures.push(`envelope.state mismatch, got ${JSON.stringify(envelope.state)}`);\n }\n if (expected.pending !== undefined && !deepEquals(envelope.pendingPlayers, expected.pending)) {\n failures.push(`envelope.pendingPlayers mismatch, got ${JSON.stringify(envelope.pendingPlayers)}`);\n }\n if (\"outcome\" in expected && !deepEquals(envelope.outcome ?? null, expected.outcome ?? null)) {\n failures.push(`envelope.outcome mismatch, got ${JSON.stringify(envelope.outcome ?? null)}`);\n }\n}\n\nfunction checkObservation(rules: GameRules, kase: ActionCase, envelope: Envelope, config: JsonObject, action: JsonObject, failures: string[]): void {\n let slice: ObservationSlice;\n try {\n slice = rules.computeObservation({\n state: envelope.state,\n pending: envelope.pendingPlayers,\n playerIndex: kase.playerIndex,\n participantCount: kase.participantCount ?? 2,\n config,\n cause: { kind: \"game\", data: action, playerIndex: kase.playerIndex },\n isReplay: false,\n });\n } catch (error) {\n failures.push(`computeObservation threw: ${error}`);\n return;\n }\n if (!deepEquals(slice.data, kase.expected.observation as Json)) {\n failures.push(`actor's observation mismatch, got ${JSON.stringify(slice.data)}`);\n }\n}\n\nfunction evaluateRatingPool(rules: GameRules, kase: RatingPoolCase): string[] {\n const failures: string[] = [];\n const config = parseWith(rules, \"config\", kase.config, failures);\n if (config === undefined) return failures;\n const pool = rules.ratingPool({\n access: kase.access,\n turnSeconds: kase.turnSeconds ?? null,\n budgetSeconds: kase.budgetSeconds ?? null,\n incrementSeconds: kase.incrementSeconds ?? null,\n minPlayers: kase.minPlayers,\n maxPlayers: kase.maxPlayers,\n config,\n });\n if (pool !== kase.expected) {\n failures.push(`ratingPool returned ${JSON.stringify(pool)}, fixture expects ${JSON.stringify(kase.expected)}`);\n }\n return failures;\n}\n\nfunction evaluateBotSeatable(rules: GameRules, kase: BotSeatableCase): string[] {\n const failures: string[] = [];\n const gameConfig = parseWith(rules, \"config\", kase.gameConfig, failures);\n if (gameConfig === undefined) return failures;\n const seatable = rules.botSeatable({\n gameConfig,\n botConfig: kase.botConfig,\n });\n if (seatable !== kase.expected) {\n failures.push(`botSeatable returned ${seatable}, fixture expects ${kase.expected}`);\n }\n return failures;\n}\n\n// ── Helpers ───────────────────────────────────────────────────────────────────\n\n/** Run one of the unit's Standard Schemas synchronously, returning the parsed\n * value or undefined on failure (issues written to the second return slot). */\nfunction validate(rules: GameRules, which: \"config\" | \"state\" | \"action\", value: unknown, issues?: string[]): JsonObject | undefined {\n const result = rules.schemas[which][\"~standard\"].validate(value);\n if (result instanceof Promise) {\n issues?.push(`${which} schema validated asynchronously; must be sync`);\n return undefined;\n }\n if (result.issues) {\n issues?.push(\n result.issues\n .map((i) => {\n const path = i.path?.map((p) => (typeof p === \"object\" ? String(p.key) : String(p))).join(\".\");\n return path ? `${path}: ${i.message}` : i.message;\n })\n .join(\"; \"),\n );\n return undefined;\n }\n return result.value as JsonObject;\n}\n\n/** Parse a fixture payload through one of the unit's schemas, recording a\n * failure (and returning undefined) when it does not conform. */\nfunction parseWith(rules: GameRules, which: \"config\" | \"state\" | \"action\", value: JsonObject, failures: string[]): JsonObject | undefined {\n const issues: string[] = [];\n const parsed = validate(rules, which, value, issues);\n if (parsed === undefined) {\n failures.push(`fixture ${which} fails the TS ${which} schema: ${issues.join(\"; \")}`);\n }\n return parsed;\n}\n\n/** Structural JSON equality. Object keys with `undefined` values count as\n * absent (matching how schema libraries model optional fields); array order\n * matters. */\nexport function deepEquals(a: Json | undefined, b: Json | undefined): boolean {\n if (a === undefined || a === null) return b === undefined || b === null;\n if (b === undefined || b === null) return false;\n if (Array.isArray(a) || Array.isArray(b)) {\n if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) {\n return false;\n }\n return a.every((item, i) => deepEquals(item, b[i]));\n }\n if (typeof a === \"object\" || typeof b === \"object\") {\n if (typeof a !== \"object\" || typeof b !== \"object\") return false;\n const keys = new Set([...Object.keys(a), ...Object.keys(b)]);\n return [...keys].every((k) => deepEquals((a as JsonObject)[k], (b as JsonObject)[k]));\n }\n return a === b;\n}\n","/**\n * Emit the language-neutral contract a game's Flutter repository consumes.\n *\n * The authoritative inputs live with the TypeScript rules: the four payload\n * schemas and the shared behavioral fixtures. The output is one deterministic\n * JSON file so it can be copied, attached to a release, or fetched by checksum\n * without assuming any repository layout.\n */\n\nimport { existsSync, readdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { basename, relative, resolve } from \"node:path\";\nimport type { GameModule, StandardJSONSchemaV1 } from \"@eigeninteractive/rules\";\nimport { parseTwinFixtureFile } from \"./twin-fixtures.js\";\n\n/** Current format of the language-neutral contract consumed by EigenInteractive's Dart generator. */\nexport const GAME_CONTRACT_FORMAT_VERSION = 1;\n\n/** One validated twin-fixture document embedded in a {@link GameContract}. */\nexport interface GameContractFixture {\n /** POSIX-style path relative to the supplied fixtures root. */\n path: string;\n /** Validated fixture document, retained in its original JSON shape. */\n document: unknown;\n}\n\n/** The four JSON Schemas emitted for one game `schemaVersion`. */\nexport interface GameContractVersion {\n schemas: {\n state: Record<string, unknown>;\n observation: Record<string, unknown>;\n action: Record<string, unknown>;\n config: Record<string, unknown>;\n };\n}\n\n/** Language-neutral schemas and fixtures shared by a game's Worker and app. */\nexport interface GameContract {\n formatVersion: typeof GAME_CONTRACT_FORMAT_VERSION;\n game: string;\n versions: Record<string, GameContractVersion>;\n fixtures: GameContractFixture[];\n}\n\n/** Inputs for building a {@link GameContract} without writing it. */\nexport interface BuildGameContractOptions {\n /** Stable display name used as the generated Dart type prefix. */\n game: string;\n /** Authoritative TypeScript rules registry. */\n gameModule: GameModule;\n /** Root containing `v<N>/*.json` twin fixtures. */\n fixturesRoot?: string | URL;\n}\n\n/** Inputs for emitting or checking a {@link GameContract} file. */\nexport interface EmitGameContractOptions extends BuildGameContractOptions {\n /** Destination `game-contract.json` path. */\n output: string | URL;\n}\n\nfunction canonical(value: unknown): unknown {\n if (Array.isArray(value)) return value.map(canonical);\n if (value !== null && typeof value === \"object\") {\n return Object.fromEntries(\n Object.entries(value as Record<string, unknown>)\n .sort(([a], [b]) => a.localeCompare(b))\n .map(([key, item]) => [key, canonical(item)]),\n );\n }\n return value;\n}\n\nfunction jsonSchema(schema: StandardJSONSchemaV1, label: string, direction: \"input\" | \"output\"): Record<string, unknown> {\n const options = { target: \"draft-2020-12\" as const };\n try {\n return canonical(schema[\"~standard\"].jsonSchema[direction](options)) as Record<string, unknown>;\n } catch (error) {\n throw new Error(`${label} cannot emit its ${direction} type as draft-2020-12 JSON Schema`, { cause: error });\n }\n}\n\nfunction fixtureFiles(root: string): string[] {\n const found: string[] = [];\n const visit = (directory: string): void => {\n for (const entry of readdirSync(directory, { withFileTypes: true })) {\n const path = resolve(directory, entry.name);\n if (entry.isDirectory()) visit(path);\n else if (entry.isFile() && entry.name.endsWith(\".json\")) found.push(path);\n }\n };\n visit(root);\n return found.sort();\n}\n\nfunction fixtures(fixturesRoot: string | URL | undefined, versions: ReadonlySet<string>): GameContractFixture[] {\n if (fixturesRoot === undefined) return [];\n const root = fixturesRoot instanceof URL ? fixturesRoot.pathname : resolve(fixturesRoot);\n return fixtureFiles(root).map((path) => {\n const document = JSON.parse(readFileSync(path, \"utf8\")) as unknown;\n const fixture = parseTwinFixtureFile(path, document);\n const fixturePath = relative(root, path).split(\"\\\\\").join(\"/\");\n const directory = fixturePath.split(\"/\")[0];\n const match = /^v([1-9]\\d*)$/.exec(directory ?? \"\");\n if (match === null) {\n throw new Error(`${fixturePath}: fixtures must live under a v<N>/ directory`);\n }\n const pathVersion = Number(match[1]);\n if (pathVersion !== fixture.schemaVersion) {\n throw new Error(`${fixturePath}: directory v${pathVersion} disagrees with schemaVersion ${fixture.schemaVersion}`);\n }\n if (!versions.has(String(fixture.schemaVersion))) {\n throw new Error(`${fixturePath}: gameModule ships no rules unit for schemaVersion ${fixture.schemaVersion}`);\n }\n return {\n path: fixturePath,\n document: canonical(document),\n };\n });\n}\n\n/** Build a deterministic in-memory contract without touching the filesystem. */\nexport function buildGameContract(options: BuildGameContractOptions): GameContract {\n const game = options.game.trim();\n if (game.length === 0) throw new Error(\"game contract name must not be empty\");\n\n const versions = Object.fromEntries(\n Object.entries(options.gameModule.versions)\n .sort(([a], [b]) => Number(a) - Number(b))\n .map(([version, rules]) => [\n version,\n {\n schemas: {\n state: jsonSchema(rules.schemas.state, `v${version} state`, \"output\"),\n observation: jsonSchema(rules.schemas.observation, `v${version} observation`, \"output\"),\n action: jsonSchema(rules.schemas.action, `v${version} action`, \"input\"),\n config: jsonSchema(rules.schemas.config, `v${version} config`, \"output\"),\n },\n },\n ]),\n );\n\n if (Object.keys(versions).length === 0) {\n throw new Error(\"game contract must contain at least one schema version\");\n }\n\n return {\n formatVersion: GAME_CONTRACT_FORMAT_VERSION,\n game,\n versions,\n fixtures: fixtures(options.fixturesRoot, new Set(Object.keys(versions))),\n };\n}\n\n/** Render one deterministic, newline-terminated contract document. */\nexport function gameContractJson(options: BuildGameContractOptions): string {\n return `${JSON.stringify(buildGameContract(options), null, 2)}\\n`;\n}\n\n/** Emit one deterministic, newline-terminated `game-contract.json`. */\nexport function emitGameContract(options: EmitGameContractOptions): void {\n const output = options.output instanceof URL ? options.output : resolve(options.output);\n writeFileSync(output, gameContractJson(options));\n}\n\n/** Fail when an emitted contract is missing or differs from its inputs. */\nexport function checkGameContract(options: EmitGameContractOptions): void {\n const output = options.output instanceof URL ? options.output : resolve(options.output);\n if (!existsSync(output) || readFileSync(output, \"utf8\") !== gameContractJson(options)) {\n throw new Error(`${output.toString()} is stale; run eigen-contract`);\n }\n}\n\n/** A useful default filename for scripts that accept an output directory. */\nexport const gameContractFilename = (game: string): string =>\n `${basename(game)\n .toLowerCase()\n .replaceAll(/[^a-z0-9]+/g, \"-\")}-game-contract.json`;\n","import { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { GameModule } from \"@eigeninteractive/rules\";\nimport { tsImport } from \"tsx/esm/api\";\nimport { checkGameContract, emitGameContract } from \"./game-contract.js\";\n\ninterface EigenPackageConfig {\n game?: unknown;\n module?: unknown;\n fixtures?: unknown;\n contract?: unknown;\n}\n\ninterface PackageManifest {\n eigen?: EigenPackageConfig;\n}\n\nfunction configuredString(value: unknown, fallback: string, field: string): string {\n if (value === undefined) return fallback;\n if (typeof value !== \"string\" || value.trim().length === 0) {\n throw new Error(`package.json eigen.${field} must be a non-empty string`);\n }\n return value;\n}\n\nconst isGameModule = (value: unknown): value is GameModule => value !== null && typeof value === \"object\" && \"versions\" in value && value.versions !== null && typeof value.versions === \"object\";\n\n/**\n * Emit a contract from the conventional game package layout.\n *\n * The package default-exports its GameModule from `src/module/index.ts` and\n * declares `{ \"eigen\": { \"game\": \"…\" } }` in package.json. Paths can be\n * overridden under the same `eigen` object.\n */\nasync function configuredGameContractOptions(root: string) {\n const manifest = JSON.parse(readFileSync(resolve(root, \"package.json\"), \"utf8\")) as PackageManifest;\n const config = manifest.eigen ?? {};\n const game = configuredString(config.game, \"\", \"game\");\n if (game.length === 0) {\n throw new Error('package.json must declare an EigenInteractive game name, e.g. \"eigen\": { \"game\": \"Chess\" }');\n }\n\n const modulePath = configuredString(config.module, \"src/module/index.ts\", \"module\");\n const fixturesPath = configuredString(config.fixtures, \"src/module/fixtures\", \"fixtures\");\n const contractPath = configuredString(config.contract, \"game-contract.json\", \"contract\");\n const imported = (await tsImport(pathToFileURL(resolve(root, modulePath)).href, import.meta.url)) as { default?: unknown };\n\n if (!isGameModule(imported.default)) {\n throw new Error(`${modulePath} must default-export an EigenInteractive GameModule`);\n }\n\n return {\n game,\n gameModule: imported.default,\n fixturesRoot: resolve(root, fixturesPath),\n output: resolve(root, contractPath),\n };\n}\n\n/**\n * Emits `game-contract.json` from an EigenInteractive package's conventional layout.\n *\n * This is the programmatic form of the `eigen-contract` executable. Most\n * games should invoke the executable through their package script.\n */\nexport async function emitConfiguredGameContract(root = process.cwd()): Promise<void> {\n emitGameContract(await configuredGameContractOptions(root));\n}\n\n/**\n * Fails when the conventionally configured contract is absent or stale.\n *\n * Use this in CI through `eigen-contract --check`.\n */\nexport async function checkConfiguredGameContract(root = process.cwd()): Promise<void> {\n checkGameContract(await configuredGameContractOptions(root));\n}\n"],"mappings":"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","names":["readdirSync","readFileSync","fixtureFiles","readdirSync","readFileSync","readFileSync","resolve","readFileSync","resolve"]}
|