GameboardLayoutPlacementDiagnostics
Defined in: packages/declarative-hex-worlds/src/coordinates/layout.ts:400
Diagnostics reported when a single-placement layout call finds fewer
candidate sites than requested (including zero). Surfaces the fully
resolved criteria (post archetype merge) so archetype-inherited fields the
caller never set — e.g. the landmark archetype’s edgePadding: 1 — are
visible instead of silently emptying the candidate set.
Properties
Section titled “Properties”archetypeId?
Section titled “archetypeId?”
optionalarchetypeId?:GameboardLayoutArchetypeId
Defined in: packages/declarative-hex-worlds/src/coordinates/layout.ts:419
Archetype id used to resolve defaults, if any.
candidateCount
Section titled “candidateCount”candidateCount:
number
Defined in: packages/declarative-hex-worlds/src/coordinates/layout.ts:406
Number of candidate sites that satisfied criteria, before count limits.
rejectedCount
Section titled “rejectedCount”rejectedCount:
number
Defined in: packages/declarative-hex-worlds/src/coordinates/layout.ts:408
Number of rejected sites.
rejectionCounts
Section titled “rejectionCounts”rejectionCounts:
Readonly<Partial<Record<GameboardLayoutSiteRejectionCode,number>>>
Defined in: packages/declarative-hex-worlds/src/coordinates/layout.ts:410
Rejection counts grouped by code — names which filter emptied the set.
requestedCount
Section titled “requestedCount”requestedCount:
number
Defined in: packages/declarative-hex-worlds/src/coordinates/layout.ts:402
Number of placements requested via count.
resolvedCriteria
Section titled “resolvedCriteria”resolvedCriteria:
GameboardLayoutCriteria
Defined in: packages/declarative-hex-worlds/src/coordinates/layout.ts:417
Fully resolved criteria used for site selection, i.e. archetype defaults
merged with caller-supplied overrides via mergeLayoutCriteria. Fields
present here but absent from the caller’s criteria were inherited from
the archetype.
seed:
string
Defined in: packages/declarative-hex-worlds/src/coordinates/layout.ts:421
Seed used for deterministic tie-breaking.
selectedCount
Section titled “selectedCount”selectedCount:
number
Defined in: packages/declarative-hex-worlds/src/coordinates/layout.ts:404
Number of placements actually selected.