declarative-hex-worlds

---

declarative-hex-worlds / src/simulation

src/simulation

Headless scenario simulation scripts and deterministic reports for movement, patrols, commands, quest progression, and integration-test evidence.

The public ./simulation barrel composes the concern-specific modules:

• ./script — stable public script re-export path.
• ./script-types — script + step types, schema constants, runtime result records, and patrol script planning DTOs.
• ./script-validators — authored-script validators and shared scenario-index helpers.
• ./engine — runtime step dispatch, the runGameboardScenarioSimulation* entry points, and patrol route-to-step helpers.
• ./report — report DTOs, result/record shapes, and the createGameboardScenarioSimulationReport renderer.
• ./assertions — expectation primitives and the evaluate/assert helpers consumed by the report layer.

The split landed in PRD D3 (H-3). Public surface is unchanged.

References

assertGameboardScenarioSimulationExpectations

Re-exports assertGameboardScenarioSimulationExpectations

---

createGameboardPatrolSimulationScript

Re-exports createGameboardPatrolSimulationScript

---

CreateGameboardPatrolSimulationScriptOptions

Re-exports CreateGameboardPatrolSimulationScriptOptions

---

createGameboardPatrolSimulationSteps

Re-exports createGameboardPatrolSimulationSteps

---

CreateGameboardPatrolSimulationStepsOptions

Re-exports CreateGameboardPatrolSimulationStepsOptions

---

createGameboardScenarioSimulationReport

Re-exports createGameboardScenarioSimulationReport

---

evaluateGameboardScenarioSimulationExpectations

Re-exports evaluateGameboardScenarioSimulationExpectations

---

GAMEBOARD_SCENARIO_SIMULATION_SCHEMA_VERSION

Re-exports GAMEBOARD_SCENARIO_SIMULATION_SCHEMA_VERSION

---

GAMEBOARD_SCENARIO_SIMULATION_STEP_ACTIONS

Re-exports GAMEBOARD_SCENARIO_SIMULATION_STEP_ACTIONS

---

GameboardPatrolSimulationActorAssignment

Re-exports GameboardPatrolSimulationActorAssignment

---

GameboardPatrolSimulationAssignmentPlan

Re-exports GameboardPatrolSimulationAssignmentPlan

---

GameboardPatrolSimulationScriptPlan

Re-exports GameboardPatrolSimulationScriptPlan

---

GameboardPatrolSimulationStepsPlan

Re-exports GameboardPatrolSimulationStepsPlan

---

GameboardScenarioSimulationActorExpectation

Re-exports GameboardScenarioSimulationActorExpectation

---

GameboardScenarioSimulationActorRecord

Re-exports GameboardScenarioSimulationActorRecord

---

GameboardScenarioSimulationActorTargetCommandStep

Re-exports GameboardScenarioSimulationActorTargetCommandStep

---

GameboardScenarioSimulationActorTargetRecord

Re-exports GameboardScenarioSimulationActorTargetRecord

---

GameboardScenarioSimulationActorTargetsExpectation

Re-exports GameboardScenarioSimulationActorTargetsExpectation

---

GameboardScenarioSimulationActorTargetsRecord

Re-exports GameboardScenarioSimulationActorTargetsRecord

---

GameboardScenarioSimulationActorTargetsStep

Re-exports GameboardScenarioSimulationActorTargetsStep

---

GameboardScenarioSimulationCommandExpectation

Re-exports GameboardScenarioSimulationCommandExpectation

---

GameboardScenarioSimulationCommandHandlerPreset

Re-exports GameboardScenarioSimulationCommandHandlerPreset

---

GameboardScenarioSimulationCommandRecord

Re-exports GameboardScenarioSimulationCommandRecord

---

GameboardScenarioSimulationCommandStep

Re-exports GameboardScenarioSimulationCommandStep

---

GameboardScenarioSimulationExpectationFailure

Re-exports GameboardScenarioSimulationExpectationFailure

---

GameboardScenarioSimulationExpectations

Re-exports GameboardScenarioSimulationExpectations

---

GameboardScenarioSimulationMovementExpectation

Re-exports GameboardScenarioSimulationMovementExpectation

---

GameboardScenarioSimulationMovementRecord

Re-exports GameboardScenarioSimulationMovementRecord

---

GameboardScenarioSimulationMutationExpectation

Re-exports GameboardScenarioSimulationMutationExpectation

---

GameboardScenarioSimulationMutationRecord

Re-exports GameboardScenarioSimulationMutationRecord

---

GameboardScenarioSimulationPatrolExpectation

Re-exports GameboardScenarioSimulationPatrolExpectation

---

GameboardScenarioSimulationPatrolRecord

Re-exports GameboardScenarioSimulationPatrolRecord

---

GameboardScenarioSimulationPlacementExpectation

Re-exports GameboardScenarioSimulationPlacementExpectation

---

GameboardScenarioSimulationPlacementRecord

Re-exports GameboardScenarioSimulationPlacementRecord

---

GameboardScenarioSimulationQuestExpectation

Re-exports GameboardScenarioSimulationQuestExpectation

---

GameboardScenarioSimulationQuestRecord

Re-exports GameboardScenarioSimulationQuestRecord

---

GameboardScenarioSimulationRemoveActorStep

Re-exports GameboardScenarioSimulationRemoveActorStep

---

GameboardScenarioSimulationRemovePlacementStep

Re-exports GameboardScenarioSimulationRemovePlacementStep

---

GameboardScenarioSimulationReport

Re-exports GameboardScenarioSimulationReport

---

GameboardScenarioSimulationResult

Re-exports GameboardScenarioSimulationResult

---

GameboardScenarioSimulationRunSystemsStep

Re-exports GameboardScenarioSimulationRunSystemsStep

---

GameboardScenarioSimulationScript

Re-exports GameboardScenarioSimulationScript

---

GameboardScenarioSimulationScriptValidationConfig

Re-exports GameboardScenarioSimulationScriptValidationConfig

---

GameboardScenarioSimulationScriptValidationResult

Re-exports GameboardScenarioSimulationScriptValidationResult

---

GameboardScenarioSimulationSpawnActorStep

Re-exports GameboardScenarioSimulationSpawnActorStep

---

GameboardScenarioSimulationSpawnPlacementStep

Re-exports GameboardScenarioSimulationSpawnPlacementStep

---

GameboardScenarioSimulationStep

Re-exports GameboardScenarioSimulationStep

---

GameboardScenarioSimulationStepBase

Re-exports GameboardScenarioSimulationStepBase

---

GameboardScenarioSimulationStepReport

Re-exports GameboardScenarioSimulationStepReport

---

GameboardScenarioSimulationStepResult

Re-exports GameboardScenarioSimulationStepResult

---

GameboardScenarioSimulationUpdateActorStep

Re-exports GameboardScenarioSimulationUpdateActorStep

---

GameboardScenarioSimulationUpdatePlacementStep

Re-exports GameboardScenarioSimulationUpdatePlacementStep

---

inspectGameboardScenarioSimulationScript

Re-exports inspectGameboardScenarioSimulationScript

---

runGameboardScenarioSimulation

Re-exports runGameboardScenarioSimulation

---

RunGameboardScenarioSimulationOptions

Re-exports RunGameboardScenarioSimulationOptions

---

runGameboardScenarioSimulationScript

Re-exports runGameboardScenarioSimulationScript

---

validateGameboardScenarioSimulationScript

Re-exports validateGameboardScenarioSimulationScript