@dreamboard-games/workspace-codegen 0.1.0

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.
Files changed (73) hide show
  1. package/LICENSE +89 -0
  2. package/NOTICE +1 -0
  3. package/dist/hex-geometry.d.ts +2 -0
  4. package/dist/hex-geometry.js +49 -0
  5. package/dist/index.d.ts +13 -0
  6. package/dist/index.js +22 -0
  7. package/dist/manifest-contract.d.ts +14 -0
  8. package/dist/manifest-contract.js +4897 -0
  9. package/dist/manifest-validation.d.ts +6 -0
  10. package/dist/manifest-validation.js +506 -0
  11. package/dist/ownership.d.ts +31 -0
  12. package/dist/ownership.js +86 -0
  13. package/dist/preset-card-sets.d.ts +5 -0
  14. package/dist/preset-card-sets.js +135 -0
  15. package/dist/seeds.d.ts +6 -0
  16. package/dist/seeds.js +766 -0
  17. package/ownership.json +51 -0
  18. package/package.json +46 -0
  19. package/src/__fixtures__/sdk-types/invalid-card-properties-extra-key.ts +62 -0
  20. package/src/__fixtures__/sdk-types/invalid-card-properties-missing-required.ts +60 -0
  21. package/src/__fixtures__/sdk-types/invalid-card-properties-wrong-enum.ts +61 -0
  22. package/src/__fixtures__/sdk-types/invalid-card-properties-wrong-nested.ts +61 -0
  23. package/src/__fixtures__/sdk-types/invalid-card-properties-wrong-scalar.ts +61 -0
  24. package/src/__fixtures__/sdk-types/invalid-card-visibility.ts +40 -0
  25. package/src/__fixtures__/sdk-types/invalid-container-card-set-manifest.ts +62 -0
  26. package/src/__fixtures__/sdk-types/invalid-die-fields-wrong-array-item.ts +43 -0
  27. package/src/__fixtures__/sdk-types/invalid-die-fields-wrong-player-id.ts +43 -0
  28. package/src/__fixtures__/sdk-types/invalid-die-fields-wrong-resource-id.ts +43 -0
  29. package/src/__fixtures__/sdk-types/invalid-die-home-per-player-zone-no-owner.ts +35 -0
  30. package/src/__fixtures__/sdk-types/invalid-die-seed-type-id.ts +31 -0
  31. package/src/__fixtures__/sdk-types/invalid-die-visibility.ts +28 -0
  32. package/src/__fixtures__/sdk-types/invalid-generic-board-edge-id.ts +38 -0
  33. package/src/__fixtures__/sdk-types/invalid-generic-board-nested-field.ts +45 -0
  34. package/src/__fixtures__/sdk-types/invalid-hex-edge-field-edge-id.ts +47 -0
  35. package/src/__fixtures__/sdk-types/invalid-hex-vertex-field-vertex-id.ts +47 -0
  36. package/src/__fixtures__/sdk-types/invalid-manifest.ts +143 -0
  37. package/src/__fixtures__/sdk-types/invalid-piece-fields-extra-key.ts +62 -0
  38. package/src/__fixtures__/sdk-types/invalid-piece-fields-wrong-card-id.ts +61 -0
  39. package/src/__fixtures__/sdk-types/invalid-piece-fields-wrong-enum.ts +61 -0
  40. package/src/__fixtures__/sdk-types/invalid-piece-fields-wrong-scalar.ts +61 -0
  41. package/src/__fixtures__/sdk-types/invalid-piece-fields-wrong-zone-id.ts +61 -0
  42. package/src/__fixtures__/sdk-types/invalid-piece-home-per-player-container-no-owner.ts +48 -0
  43. package/src/__fixtures__/sdk-types/invalid-piece-home-per-player-edge-no-owner.ts +47 -0
  44. package/src/__fixtures__/sdk-types/invalid-piece-home-per-player-space-no-owner.ts +42 -0
  45. package/src/__fixtures__/sdk-types/invalid-piece-home-per-player-vertex-no-owner.ts +49 -0
  46. package/src/__fixtures__/sdk-types/invalid-piece-seed-type-id.ts +30 -0
  47. package/src/__fixtures__/sdk-types/invalid-piece-visibility.ts +28 -0
  48. package/src/__fixtures__/sdk-types/invalid-slot-host-manifest.ts +47 -0
  49. package/src/__fixtures__/sdk-types/invalid-slot-id-manifest.ts +49 -0
  50. package/src/__fixtures__/sdk-types/invalid-square-board-edge-id.ts +47 -0
  51. package/src/__fixtures__/sdk-types/invalid-square-board-space-id.ts +47 -0
  52. package/src/__fixtures__/sdk-types/invalid-square-board-vertex-id.ts +49 -0
  53. package/src/__fixtures__/sdk-types/invalid-square-container-field-space-id.ts +59 -0
  54. package/src/__fixtures__/sdk-types/invalid-square-container-host-space-id.ts +49 -0
  55. package/src/__fixtures__/sdk-types/invalid-square-relation-field-scalar.ts +48 -0
  56. package/src/__fixtures__/sdk-types/invalid-square-relation-space-id.ts +48 -0
  57. package/src/__fixtures__/sdk-types/invalid-square-space-fields-enum.ts +44 -0
  58. package/src/__fixtures__/sdk-types/invalid-square-space-fields-extra-key.ts +45 -0
  59. package/src/__fixtures__/sdk-types/valid-die-type-omits-sides.ts +29 -0
  60. package/src/__fixtures__/sdk-types/valid-manifest-omits-board-templates.ts +19 -0
  61. package/src/__fixtures__/sdk-types/valid-manifest.ts +612 -0
  62. package/src/__fixtures__/sdk-types/valid-player-scoped-seed-homes.ts +59 -0
  63. package/src/authoring-benchmark.test.ts +362 -0
  64. package/src/hex-geometry.ts +69 -0
  65. package/src/index.ts +64 -0
  66. package/src/manifest-contract.test.ts +1764 -0
  67. package/src/manifest-contract.ts +6581 -0
  68. package/src/manifest-validation.test.ts +393 -0
  69. package/src/manifest-validation.ts +795 -0
  70. package/src/ownership.ts +127 -0
  71. package/src/preset-card-sets.ts +169 -0
  72. package/src/sdk-types-authoring.test.ts +361 -0
  73. package/src/seeds.ts +800 -0
@@ -0,0 +1,795 @@
1
+ import type {
2
+ HexBoardSpec,
3
+ HexBoardTemplateSpec,
4
+ HexSpaceSpec,
5
+ HexVertexSpec,
6
+ BoardCard,
7
+ BoardSpec,
8
+ BoardTemplateSpec,
9
+ DieSeedSpec,
10
+ DieTypeSpec,
11
+ GameTopologyManifest,
12
+ PieceSeedSpec,
13
+ PieceTypeSpec,
14
+ SetupOptionSpec,
15
+ ZoneSpec,
16
+ } from "@dreamboard/sdk-types";
17
+ import { resolveHexVertexGeometryKey } from "./hex-geometry.js";
18
+
19
+ export type ManifestAuthoringValidationResult = {
20
+ errors: string[];
21
+ warnings: string[];
22
+ };
23
+
24
+ function isHexBoardTemplateSpec(
25
+ boardTemplate: BoardTemplateSpec,
26
+ ): boardTemplate is Extract<BoardTemplateSpec, { layout: "hex" }> {
27
+ return boardTemplate.layout === "hex";
28
+ }
29
+
30
+ function isHexBoardSpec(
31
+ board: BoardSpec,
32
+ ): board is Extract<BoardSpec, { layout: "hex" }> {
33
+ return board.layout === "hex";
34
+ }
35
+
36
+ function collectDuplicateIdIssues(options: {
37
+ entries: ReadonlyArray<{ id?: string | null; path: string }>;
38
+ label: string;
39
+ }): string[] {
40
+ const issues: string[] = [];
41
+ const pathsById = new Map<string, string[]>();
42
+
43
+ for (const entry of options.entries) {
44
+ const id = entry.id?.trim();
45
+ if (!id) {
46
+ continue;
47
+ }
48
+ const paths = pathsById.get(id) ?? [];
49
+ paths.push(entry.path);
50
+ pathsById.set(id, paths);
51
+ }
52
+
53
+ for (const [id, paths] of pathsById.entries()) {
54
+ if (paths.length > 1) {
55
+ issues.push(`${paths.join(", ")}: Duplicate ${options.label} '${id}'.`);
56
+ }
57
+ }
58
+
59
+ return issues;
60
+ }
61
+
62
+ function renderCardInstanceIds(card: BoardCard): string[] {
63
+ return card.count > 1
64
+ ? Array.from(
65
+ { length: card.count },
66
+ (_, index) => `${card.type}-${index + 1}`,
67
+ )
68
+ : [card.type];
69
+ }
70
+
71
+ function expandSeedIds<
72
+ Seed extends {
73
+ id?: string | null;
74
+ typeId: string;
75
+ count?: number | null;
76
+ },
77
+ >(seeds: readonly Seed[]): string[] {
78
+ return seeds.flatMap((seed) => {
79
+ const count = seed.count ?? 1;
80
+ const baseId = seed.id ?? seed.typeId;
81
+ return count > 1
82
+ ? Array.from({ length: count }, (_, index) => `${baseId}-${index + 1}`)
83
+ : [baseId];
84
+ });
85
+ }
86
+
87
+ function validateTypeSlotDuplicates(options: {
88
+ pieceTypes: readonly PieceTypeSpec[];
89
+ dieTypes: readonly DieTypeSpec[];
90
+ }): string[] {
91
+ const issues: string[] = [];
92
+
93
+ for (const [index, pieceType] of options.pieceTypes.entries()) {
94
+ issues.push(
95
+ ...collectDuplicateIdIssues({
96
+ entries: (pieceType.slots ?? []).map((slot, slotIndex) => ({
97
+ id: slot.id,
98
+ path: `manifest.pieceTypes[${index}].slots[${slotIndex}].id`,
99
+ })),
100
+ label: "piece slot id",
101
+ }),
102
+ );
103
+ }
104
+
105
+ for (const [index, dieType] of options.dieTypes.entries()) {
106
+ issues.push(
107
+ ...collectDuplicateIdIssues({
108
+ entries: (dieType.slots ?? []).map((slot, slotIndex) => ({
109
+ id: slot.id,
110
+ path: `manifest.dieTypes[${index}].slots[${slotIndex}].id`,
111
+ })),
112
+ label: "die slot id",
113
+ }),
114
+ );
115
+ }
116
+
117
+ return issues;
118
+ }
119
+
120
+ function validateSlotHostsAndHomes(manifest: GameTopologyManifest): string[] {
121
+ const issues: string[] = [];
122
+ const pieceTypesById = new Map(
123
+ (manifest.pieceTypes ?? []).map(
124
+ (pieceType) => [pieceType.id, pieceType] as const,
125
+ ),
126
+ );
127
+ const dieTypesById = new Map(
128
+ (manifest.dieTypes ?? []).map((dieType) => [dieType.id, dieType] as const),
129
+ );
130
+ const slotIdsByHostKey = new Map<string, Set<string>>();
131
+
132
+ for (const [index, seed] of (manifest.pieceSeeds ?? []).entries()) {
133
+ const pieceType = pieceTypesById.get(seed.typeId);
134
+ const slotIds = (pieceType?.slots ?? []).map((slot) => slot.id);
135
+ if (slotIds.length === 0) {
136
+ continue;
137
+ }
138
+ if (typeof seed.id !== "string" || seed.id.length === 0) {
139
+ issues.push(
140
+ `manifest.pieceSeeds[${index}].id: Piece seed for slot-bearing type '${seed.typeId}' must declare an explicit id.`,
141
+ );
142
+ continue;
143
+ }
144
+ if ((seed.count ?? 1) !== 1) {
145
+ issues.push(
146
+ `manifest.pieceSeeds[${index}].count: Piece seed '${seed.id}' for slot-bearing type '${seed.typeId}' must omit count or set it to 1.`,
147
+ );
148
+ continue;
149
+ }
150
+ slotIdsByHostKey.set(`piece:${seed.id}`, new Set(slotIds));
151
+ }
152
+
153
+ for (const [index, seed] of (manifest.dieSeeds ?? []).entries()) {
154
+ const dieType = dieTypesById.get(seed.typeId);
155
+ const slotIds = (dieType?.slots ?? []).map((slot) => slot.id);
156
+ if (slotIds.length === 0) {
157
+ continue;
158
+ }
159
+ if (typeof seed.id !== "string" || seed.id.length === 0) {
160
+ issues.push(
161
+ `manifest.dieSeeds[${index}].id: Die seed for slot-bearing type '${seed.typeId}' must declare an explicit id.`,
162
+ );
163
+ continue;
164
+ }
165
+ if ((seed.count ?? 1) !== 1) {
166
+ issues.push(
167
+ `manifest.dieSeeds[${index}].count: Die seed '${seed.id}' for slot-bearing type '${seed.typeId}' must omit count or set it to 1.`,
168
+ );
169
+ continue;
170
+ }
171
+ slotIdsByHostKey.set(`die:${seed.id}`, new Set(slotIds));
172
+ }
173
+
174
+ const validateHome = (
175
+ home: BoardCard["home"] | PieceSeedSpec["home"] | DieSeedSpec["home"],
176
+ path: string,
177
+ ) => {
178
+ if (home?.type !== "slot") {
179
+ return;
180
+ }
181
+
182
+ const hostKey = `${home.host.kind}:${home.host.id}`;
183
+ const slotIds = slotIdsByHostKey.get(hostKey);
184
+ if (!slotIds) {
185
+ issues.push(
186
+ `${path}.host: Unknown strict slot host '${home.host.kind}:${home.host.id}'. Hosts must be singleton piece/die seeds whose type declares slots.`,
187
+ );
188
+ return;
189
+ }
190
+ if (!slotIds.has(home.slotId)) {
191
+ issues.push(
192
+ `${path}.slotId: Unknown slot '${home.slotId}' for host '${home.host.kind}:${home.host.id}'.`,
193
+ );
194
+ }
195
+ };
196
+
197
+ for (const [cardSetIndex, cardSet] of manifest.cardSets.entries()) {
198
+ if (cardSet.type !== "manual") {
199
+ continue;
200
+ }
201
+ for (const [cardIndex, card] of cardSet.cards.entries()) {
202
+ validateHome(
203
+ card.home,
204
+ `manifest.cardSets[${cardSetIndex}].cards[${cardIndex}].home`,
205
+ );
206
+ }
207
+ }
208
+
209
+ for (const [index, seed] of (manifest.pieceSeeds ?? []).entries()) {
210
+ validateHome(seed.home, `manifest.pieceSeeds[${index}].home`);
211
+ }
212
+
213
+ for (const [index, seed] of (manifest.dieSeeds ?? []).entries()) {
214
+ validateHome(seed.home, `manifest.dieSeeds[${index}].home`);
215
+ }
216
+
217
+ return issues;
218
+ }
219
+
220
+ function validateSetupProfileReferences(
221
+ manifest: GameTopologyManifest,
222
+ ): string[] {
223
+ const issues: string[] = [];
224
+ const optionChoiceIdsByOptionId = new Map<string, Set<string>>(
225
+ (manifest.setupOptions ?? []).map((option, optionIndex) => {
226
+ const choiceIds = new Set<string>();
227
+ for (const choice of option.choices ?? []) {
228
+ choiceIds.add(choice.id);
229
+ }
230
+ if (!option.id) {
231
+ issues.push(
232
+ `manifest.setupOptions[${optionIndex}].id: Missing option id.`,
233
+ );
234
+ }
235
+ return [option.id, choiceIds];
236
+ }),
237
+ );
238
+
239
+ for (const [profileIndex, profile] of (
240
+ manifest.setupProfiles ?? []
241
+ ).entries()) {
242
+ const optionValues = profile.optionValues ?? {};
243
+ for (const [optionId, choiceId] of Object.entries(optionValues)) {
244
+ const allowedChoices = optionChoiceIdsByOptionId.get(optionId);
245
+ if (!allowedChoices) {
246
+ issues.push(
247
+ `manifest.setupProfiles[${profileIndex}].optionValues.${optionId}: Unknown setup option '${optionId}'.`,
248
+ );
249
+ continue;
250
+ }
251
+ if (!allowedChoices.has(choiceId)) {
252
+ issues.push(
253
+ `manifest.setupProfiles[${profileIndex}].optionValues.${optionId}: Unknown choice '${choiceId}' for setup option '${optionId}'.`,
254
+ );
255
+ }
256
+ }
257
+ }
258
+
259
+ return issues;
260
+ }
261
+
262
+ function validatePlayerScopedSeedHomes(
263
+ manifest: GameTopologyManifest,
264
+ ): string[] {
265
+ const issues: string[] = [];
266
+ const boardScopeById = new Map(
267
+ (manifest.boards ?? []).map((board) => [board.id, board.scope] as const),
268
+ );
269
+ const zoneScopeById = new Map(
270
+ (manifest.zones ?? []).map((zone) => [zone.id, zone.scope] as const),
271
+ );
272
+
273
+ const validateSeedHome = (
274
+ seed: PieceSeedSpec | DieSeedSpec,
275
+ path: string,
276
+ label: "Piece seed" | "Die seed",
277
+ ) => {
278
+ const authoredId = seed.id ?? seed.typeId;
279
+ if (seed.ownerId) {
280
+ return;
281
+ }
282
+
283
+ if (
284
+ homeTargetsBoard(seed.home) &&
285
+ boardScopeById.get(seed.home.boardId) === "perPlayer"
286
+ ) {
287
+ issues.push(
288
+ `${path}.boardId: ${label} '${authoredId}' requires ownerId because board '${seed.home.boardId}' has scope 'perPlayer'. Add ownerId to resolve the player-scoped destination.`,
289
+ );
290
+ return;
291
+ }
292
+
293
+ if (
294
+ seed.home?.type === "zone" &&
295
+ zoneScopeById.get(seed.home.zoneId) === "perPlayer"
296
+ ) {
297
+ issues.push(
298
+ `${path}.zoneId: ${label} '${authoredId}' requires ownerId because zone '${seed.home.zoneId}' has scope 'perPlayer'. Add ownerId to resolve the player-scoped destination.`,
299
+ );
300
+ }
301
+ };
302
+
303
+ for (const [index, seed] of (manifest.pieceSeeds ?? []).entries()) {
304
+ validateSeedHome(seed, `manifest.pieceSeeds[${index}].home`, "Piece seed");
305
+ }
306
+
307
+ for (const [index, seed] of (manifest.dieSeeds ?? []).entries()) {
308
+ validateSeedHome(seed, `manifest.dieSeeds[${index}].home`, "Die seed");
309
+ }
310
+
311
+ return issues;
312
+ }
313
+
314
+ function homeTargetsBoard(
315
+ home: PieceSeedSpec["home"] | DieSeedSpec["home"] | undefined,
316
+ ): home is Extract<
317
+ NonNullable<PieceSeedSpec["home"] | DieSeedSpec["home"]>,
318
+ { type: "space" | "container" | "edge" | "vertex" }
319
+ > {
320
+ return (
321
+ home?.type === "space" ||
322
+ home?.type === "container" ||
323
+ home?.type === "edge" ||
324
+ home?.type === "vertex"
325
+ );
326
+ }
327
+
328
+ function validateBoardTemplateDuplicates(
329
+ boardTemplates: readonly BoardTemplateSpec[],
330
+ ): string[] {
331
+ const issues: string[] = [];
332
+
333
+ for (const [index, boardTemplate] of boardTemplates.entries()) {
334
+ if (isHexBoardTemplateSpec(boardTemplate)) {
335
+ issues.push(
336
+ ...collectDuplicateIdIssues({
337
+ entries: (boardTemplate.spaces ?? []).map((space, spaceIndex) => ({
338
+ id: space.id,
339
+ path: `manifest.boardTemplates[${index}].spaces[${spaceIndex}].id`,
340
+ })),
341
+ label: "space id",
342
+ }),
343
+ );
344
+ continue;
345
+ }
346
+
347
+ issues.push(
348
+ ...collectDuplicateIdIssues({
349
+ entries: (boardTemplate.spaces ?? []).map((space, spaceIndex) => ({
350
+ id: space.id,
351
+ path: `manifest.boardTemplates[${index}].spaces[${spaceIndex}].id`,
352
+ })),
353
+ label: "space id",
354
+ }),
355
+ );
356
+ issues.push(
357
+ ...collectDuplicateIdIssues({
358
+ entries: (boardTemplate.containers ?? []).map(
359
+ (container, containerIndex) => ({
360
+ id: container.id,
361
+ path: `manifest.boardTemplates[${index}].containers[${containerIndex}].id`,
362
+ }),
363
+ ),
364
+ label: "container id",
365
+ }),
366
+ );
367
+ issues.push(
368
+ ...collectDuplicateIdIssues({
369
+ entries: (boardTemplate.relations ?? []).map(
370
+ (relation, relationIndex) => ({
371
+ id: relation.id,
372
+ path: `manifest.boardTemplates[${index}].relations[${relationIndex}].id`,
373
+ }),
374
+ ),
375
+ label: "relation id",
376
+ }),
377
+ );
378
+ }
379
+
380
+ return issues;
381
+ }
382
+
383
+ function validateBoardDuplicates(boards: readonly BoardSpec[]): string[] {
384
+ const issues: string[] = [];
385
+
386
+ for (const [index, board] of boards.entries()) {
387
+ if (isHexBoardSpec(board)) {
388
+ issues.push(
389
+ ...collectDuplicateIdIssues({
390
+ entries: (board.spaces ?? []).map((space, spaceIndex) => ({
391
+ id: space.id,
392
+ path: `manifest.boards[${index}].spaces[${spaceIndex}].id`,
393
+ })),
394
+ label: "space id",
395
+ }),
396
+ );
397
+ continue;
398
+ }
399
+
400
+ issues.push(
401
+ ...collectDuplicateIdIssues({
402
+ entries: (board.spaces ?? []).map((space, spaceIndex) => ({
403
+ id: space.id,
404
+ path: `manifest.boards[${index}].spaces[${spaceIndex}].id`,
405
+ })),
406
+ label: "space id",
407
+ }),
408
+ );
409
+ issues.push(
410
+ ...collectDuplicateIdIssues({
411
+ entries: (board.containers ?? []).map((container, containerIndex) => ({
412
+ id: container.id,
413
+ path: `manifest.boards[${index}].containers[${containerIndex}].id`,
414
+ })),
415
+ label: "container id",
416
+ }),
417
+ );
418
+ issues.push(
419
+ ...collectDuplicateIdIssues({
420
+ entries: (board.relations ?? []).map((relation, relationIndex) => ({
421
+ id: relation.id,
422
+ path: `manifest.boards[${index}].relations[${relationIndex}].id`,
423
+ })),
424
+ label: "relation id",
425
+ }),
426
+ );
427
+ }
428
+
429
+ return issues;
430
+ }
431
+
432
+ function validateSetupOptionChoiceDuplicates(
433
+ options: readonly SetupOptionSpec[],
434
+ ): string[] {
435
+ const issues: string[] = [];
436
+
437
+ for (const [optionIndex, option] of options.entries()) {
438
+ issues.push(
439
+ ...collectDuplicateIdIssues({
440
+ entries: (option.choices ?? []).map((choice, choiceIndex) => ({
441
+ id: choice.id,
442
+ path: `manifest.setupOptions[${optionIndex}].choices[${choiceIndex}].id`,
443
+ })),
444
+ label: "setup option choice id",
445
+ }),
446
+ );
447
+ }
448
+
449
+ return issues;
450
+ }
451
+
452
+ function resolveHexSpaces(
453
+ board: HexBoardSpec,
454
+ template: HexBoardTemplateSpec | undefined,
455
+ ): HexSpaceSpec[] {
456
+ if (!template) {
457
+ return [...(board.spaces ?? [])].sort((left, right) =>
458
+ left.id.localeCompare(right.id),
459
+ );
460
+ }
461
+
462
+ const templateSpacesById = new Map(
463
+ (template.spaces ?? []).map((space) => [space.id, space] as const),
464
+ );
465
+ const overridesById = new Map(
466
+ (board.spaces ?? []).map((space) => [space.id, space] as const),
467
+ );
468
+ for (const overrideId of overridesById.keys()) {
469
+ if (!templateSpacesById.has(overrideId)) {
470
+ continue;
471
+ }
472
+ }
473
+
474
+ return (template.spaces ?? [])
475
+ .map((templateSpace) => {
476
+ const override = overridesById.get(templateSpace.id);
477
+ if (!override) {
478
+ return templateSpace;
479
+ }
480
+ return {
481
+ ...templateSpace,
482
+ ...override,
483
+ id: templateSpace.id,
484
+ q: templateSpace.q,
485
+ r: templateSpace.r,
486
+ };
487
+ })
488
+ .sort((left, right) => left.id.localeCompare(right.id));
489
+ }
490
+
491
+ function validateHexVertexRefs(options: {
492
+ ownerPath: string;
493
+ ownerLabel: string;
494
+ spaces: readonly HexSpaceSpec[];
495
+ vertices: readonly HexVertexSpec[];
496
+ }): string[] {
497
+ const issues: string[] = [];
498
+ const spacesById = new Map(
499
+ options.spaces.map((space) => [space.id, space] as const),
500
+ );
501
+
502
+ for (const [vertexIndex, vertex] of options.vertices.entries()) {
503
+ try {
504
+ resolveHexVertexGeometryKey(vertex.ref, spacesById);
505
+ } catch (error) {
506
+ const message =
507
+ error instanceof Error ? error.message : "Unknown hex vertex error.";
508
+ issues.push(
509
+ `${options.ownerPath}.vertices[${vertexIndex}].ref: ${options.ownerLabel} with spaces '${vertex.ref.spaces.join(", ")}' failed validation. ${message}`,
510
+ );
511
+ }
512
+ }
513
+
514
+ return issues;
515
+ }
516
+
517
+ function validateHexBoardVertexRefs(manifest: GameTopologyManifest): string[] {
518
+ const issues: string[] = [];
519
+ const hexTemplatesById = new Map(
520
+ (manifest.boardTemplates ?? [])
521
+ .filter(isHexBoardTemplateSpec)
522
+ .map((boardTemplate) => [boardTemplate.id, boardTemplate] as const),
523
+ );
524
+
525
+ for (const [templateIndex, template] of (
526
+ manifest.boardTemplates ?? []
527
+ ).entries()) {
528
+ if (!isHexBoardTemplateSpec(template)) {
529
+ continue;
530
+ }
531
+ issues.push(
532
+ ...validateHexVertexRefs({
533
+ ownerPath: `manifest.boardTemplates[${templateIndex}]`,
534
+ ownerLabel: `Hex board template '${template.id}'`,
535
+ spaces: template.spaces ?? [],
536
+ vertices: template.vertices ?? [],
537
+ }),
538
+ );
539
+ }
540
+
541
+ for (const [boardIndex, board] of (manifest.boards ?? []).entries()) {
542
+ if (!isHexBoardSpec(board)) {
543
+ continue;
544
+ }
545
+ issues.push(
546
+ ...validateHexVertexRefs({
547
+ ownerPath: `manifest.boards[${boardIndex}]`,
548
+ ownerLabel: `Hex board '${board.id}'`,
549
+ spaces: resolveHexSpaces(
550
+ board,
551
+ hexTemplatesById.get(board.templateId ?? ""),
552
+ ),
553
+ vertices: board.vertices ?? [],
554
+ }),
555
+ );
556
+ }
557
+
558
+ return issues;
559
+ }
560
+
561
+ function collectAmbiguousBoardTypeWarnings(
562
+ manifest: GameTopologyManifest,
563
+ ): string[] {
564
+ const warnings: string[] = [];
565
+ const boardTemplatesById = new Map(
566
+ (manifest.boardTemplates ?? []).map(
567
+ (template) => [template.id, template] as const,
568
+ ),
569
+ );
570
+ const boardsBySpaceType = new Map<string, Set<string>>();
571
+ const boardsByEdgeType = new Map<string, Set<string>>();
572
+ const boardsByVertexType = new Map<string, Set<string>>();
573
+
574
+ const addBoardUsage = (
575
+ target: Map<string, Set<string>>,
576
+ typeId: string | null | undefined,
577
+ boardId: string,
578
+ ) => {
579
+ if (!typeId) {
580
+ return;
581
+ }
582
+ const boardIds = target.get(typeId) ?? new Set<string>();
583
+ boardIds.add(boardId);
584
+ target.set(typeId, boardIds);
585
+ };
586
+
587
+ for (const board of manifest.boards ?? []) {
588
+ const template = board.templateId
589
+ ? boardTemplatesById.get(board.templateId)
590
+ : undefined;
591
+ for (const space of [
592
+ ...((template?.layout === board.layout ? template.spaces : undefined) ??
593
+ []),
594
+ ...(board.spaces ?? []),
595
+ ]) {
596
+ addBoardUsage(boardsBySpaceType, space.typeId, board.id);
597
+ }
598
+
599
+ if (board.layout === "hex" || board.layout === "square") {
600
+ for (const edge of [
601
+ ...((template?.layout === board.layout ? template.edges : undefined) ??
602
+ []),
603
+ ...(board.edges ?? []),
604
+ ]) {
605
+ addBoardUsage(boardsByEdgeType, edge.typeId, board.id);
606
+ }
607
+ for (const vertex of [
608
+ ...((template?.layout === board.layout
609
+ ? template.vertices
610
+ : undefined) ?? []),
611
+ ...(board.vertices ?? []),
612
+ ]) {
613
+ addBoardUsage(boardsByVertexType, vertex.typeId, board.id);
614
+ }
615
+ }
616
+ }
617
+
618
+ const pushWarnings = (
619
+ kind: "space" | "edge" | "vertex",
620
+ boardsByType: Map<string, Set<string>>,
621
+ helperName: string,
622
+ ) => {
623
+ for (const [typeId, boardIds] of boardsByType.entries()) {
624
+ if (boardIds.size < 2) {
625
+ continue;
626
+ }
627
+ warnings.push(
628
+ `Ambiguous ${kind}.typeId '${typeId}' is authored on multiple boards (${Array.from(boardIds).sort().join(", ")}). Prefer ${helperName} for board-scoped lookups.`,
629
+ );
630
+ }
631
+ };
632
+
633
+ pushWarnings(
634
+ "space",
635
+ boardsBySpaceType,
636
+ "boardHelpers.spaceIdsByBoardId / boardHelpers.spaceTypeIdByBoardId",
637
+ );
638
+ pushWarnings(
639
+ "edge",
640
+ boardsByEdgeType,
641
+ "boardHelpers.edgeIdsByBoardIdAndTypeId",
642
+ );
643
+ pushWarnings(
644
+ "vertex",
645
+ boardsByVertexType,
646
+ "boardHelpers.vertexIdsByBoardIdAndTypeId",
647
+ );
648
+
649
+ return warnings;
650
+ }
651
+
652
+ export function validateManifestAuthoring(
653
+ manifest: GameTopologyManifest,
654
+ ): ManifestAuthoringValidationResult {
655
+ const errors: string[] = [];
656
+
657
+ errors.push(
658
+ ...collectDuplicateIdIssues({
659
+ entries: manifest.cardSets.map((cardSet, index) => ({
660
+ id: cardSet.id,
661
+ path: `manifest.cardSets[${index}].id`,
662
+ })),
663
+ label: "card set id",
664
+ }),
665
+ );
666
+ errors.push(
667
+ ...collectDuplicateIdIssues({
668
+ entries: manifest.cardSets.flatMap((cardSet, cardSetIndex) =>
669
+ cardSet.type === "manual"
670
+ ? cardSet.cards.flatMap((card, cardIndex) =>
671
+ renderCardInstanceIds(card).map((cardId) => ({
672
+ id: cardId,
673
+ path: `manifest.cardSets[${cardSetIndex}].cards[${cardIndex}].type`,
674
+ })),
675
+ )
676
+ : [],
677
+ ),
678
+ label: "card runtime id",
679
+ }),
680
+ );
681
+ errors.push(
682
+ ...collectDuplicateIdIssues({
683
+ entries: (manifest.zones ?? []).map((zone: ZoneSpec, index) => ({
684
+ id: zone.id,
685
+ path: `manifest.zones[${index}].id`,
686
+ })),
687
+ label: "zone id",
688
+ }),
689
+ );
690
+ errors.push(
691
+ ...collectDuplicateIdIssues({
692
+ entries: (manifest.boardTemplates ?? []).map((boardTemplate, index) => ({
693
+ id: boardTemplate.id,
694
+ path: `manifest.boardTemplates[${index}].id`,
695
+ })),
696
+ label: "board template id",
697
+ }),
698
+ );
699
+ errors.push(
700
+ ...validateBoardTemplateDuplicates(manifest.boardTemplates ?? []),
701
+ );
702
+ errors.push(
703
+ ...collectDuplicateIdIssues({
704
+ entries: (manifest.boards ?? []).map((board, index) => ({
705
+ id: board.id,
706
+ path: `manifest.boards[${index}].id`,
707
+ })),
708
+ label: "board id",
709
+ }),
710
+ );
711
+ errors.push(...validateBoardDuplicates(manifest.boards ?? []));
712
+ errors.push(
713
+ ...validateTypeSlotDuplicates({
714
+ pieceTypes: manifest.pieceTypes ?? [],
715
+ dieTypes: manifest.dieTypes ?? [],
716
+ }),
717
+ );
718
+ errors.push(
719
+ ...collectDuplicateIdIssues({
720
+ entries: (manifest.pieceTypes ?? []).map((pieceType, index) => ({
721
+ id: pieceType.id,
722
+ path: `manifest.pieceTypes[${index}].id`,
723
+ })),
724
+ label: "piece type id",
725
+ }),
726
+ );
727
+ errors.push(
728
+ ...collectDuplicateIdIssues({
729
+ entries: expandSeedIds(manifest.pieceSeeds ?? []).map(
730
+ (pieceId, index) => ({
731
+ id: pieceId,
732
+ path: `manifest.pieceSeeds[*][${index}]`,
733
+ }),
734
+ ),
735
+ label: "piece runtime id",
736
+ }),
737
+ );
738
+ errors.push(
739
+ ...collectDuplicateIdIssues({
740
+ entries: (manifest.dieTypes ?? []).map((dieType, index) => ({
741
+ id: dieType.id,
742
+ path: `manifest.dieTypes[${index}].id`,
743
+ })),
744
+ label: "die type id",
745
+ }),
746
+ );
747
+ errors.push(
748
+ ...collectDuplicateIdIssues({
749
+ entries: expandSeedIds(manifest.dieSeeds ?? []).map((dieId, index) => ({
750
+ id: dieId,
751
+ path: `manifest.dieSeeds[*][${index}]`,
752
+ })),
753
+ label: "die runtime id",
754
+ }),
755
+ );
756
+ errors.push(
757
+ ...collectDuplicateIdIssues({
758
+ entries: (manifest.resources ?? []).map((resource, index) => ({
759
+ id: resource.id,
760
+ path: `manifest.resources[${index}].id`,
761
+ })),
762
+ label: "resource id",
763
+ }),
764
+ );
765
+ errors.push(
766
+ ...collectDuplicateIdIssues({
767
+ entries: (manifest.setupOptions ?? []).map((option, index) => ({
768
+ id: option.id,
769
+ path: `manifest.setupOptions[${index}].id`,
770
+ })),
771
+ label: "setup option id",
772
+ }),
773
+ );
774
+ errors.push(
775
+ ...validateSetupOptionChoiceDuplicates(manifest.setupOptions ?? []),
776
+ );
777
+ errors.push(
778
+ ...collectDuplicateIdIssues({
779
+ entries: (manifest.setupProfiles ?? []).map((profile, index) => ({
780
+ id: profile.id,
781
+ path: `manifest.setupProfiles[${index}].id`,
782
+ })),
783
+ label: "setup profile id",
784
+ }),
785
+ );
786
+ errors.push(...validateSlotHostsAndHomes(manifest));
787
+ errors.push(...validatePlayerScopedSeedHomes(manifest));
788
+ errors.push(...validateSetupProfileReferences(manifest));
789
+ errors.push(...validateHexBoardVertexRefs(manifest));
790
+
791
+ return {
792
+ errors,
793
+ warnings: collectAmbiguousBoardTypeWarnings(manifest),
794
+ };
795
+ }