@adriansteffan/reactive 0.1.2 → 0.1.3

package/template/simulate.ts

@@ -1,15 +1,35 @@
-import { orchestrateSimulation, simulateParticipant, setBackendUrl } from '@adriansteffan/reactive';
-import { experiment, simulationConfig } from './src/Experiment';
+import { orchestrateSimulation, simulateParticipant, setBackendUrl, seedDistributions } from '@adriansteffan/reactive';
 
 // Each simulated participant runs as a separate subprocess to get fresh module-level
 // randomization (e.g., group assignment). The orchestrator spawns workers that re-run
 // this script with _REACTIVE_WORKER_INDEX set.
+//
+// Experiment.tsx is imported dynamically so that seeding happens before module-level
+// code runs. If participants is a factory function, it is called with the base seed
+// for deterministic generation, then re-seeded per-worker for the simulation.
 if (process.env._REACTIVE_WORKER_INDEX) {
   const index = parseInt(process.env._REACTIVE_WORKER_INDEX);
-  const participants = simulationConfig.participants;
-  const participant = Array.isArray(participants) ? participants[index] : participants.generator(index);
+  const seed = process.env._REACTIVE_SIMULATION_SEED;
+  if (seed) seedDistributions(parseInt(seed) + index);
   setBackendUrl(process.env._REACTIVE_BACKEND_URL!);
+
+  const { experiment, simulationConfig } = await import('./src/Experiment');
+  const participants = simulationConfig.participants;
+
+  let participant;
+  if (typeof participants === 'function') {
+    if (seed) seedDistributions(parseInt(seed));
+    const allParticipants = participants();
+    if (seed) seedDistributions(parseInt(seed) + index);
+    participant = allParticipants[index];
+  } else if (Array.isArray(participants)) {
+    participant = participants[index];
+  } else {
+    participant = participants.generator(index);
+  }
+
   await simulateParticipant(experiment, participant);
 } else {
+  const { simulationConfig } = await import('./src/Experiment');
   await orchestrateSimulation(simulationConfig, import.meta.filename);
 }

package/template/src/Experiment.tsx

@@ -1,6 +1,6 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import { useState, useRef } from 'react';
-import { ExperimentRunner, BaseComponentProps, ExperimentConfig, registerSimulation, registerFlattener } from '@adriansteffan/reactive';
+import { ExperimentRunner, BaseComponentProps, ExperimentConfig, registerSimulation, registerFlattener, sampleParticipants } from '@adriansteffan/reactive';
 
 
 const config: ExperimentConfig = { showProgressBar: true };
@@ -165,13 +165,11 @@ export default function Experiment() {
 
 // --- Simulation config ---
 // Define how simulated participants are generated.
-// Each participant is an object whose properties are available in simulator decision functions.
+// Use a factory function for participants: the framework seeds it with the base seed,
+// so every worker generates the same participant list regardless of its per-worker seed.
 export const simulationConfig = {
-  participants: {
-    generator: (i: number) => ({
-      id: i,
-      nickname: `participant_${i}`,
-    }),
-    count: 10,
-  },
+  seed: 42,
+  participants: () => sampleParticipants('sobol', 10, {
+    needForCognition: { distribution: 'normal', mean: 3.5, sd: 0.8 },
+  }).map((p, i) => ({ ...p, id: i, nickname: `participant_${i}` })),
 };