Type Alias Action

Type Declaration

• {
      kind: "setAttribute";
      attr: ParticleAttribute;
      mode: SetAttributeMode;
      value: Expr;
  }

  Compose value into a particle attribute via the chosen SetAttributeMode.

• { kind: "setVariable"; name: string; value: Expr }

  Assign to a local variable declared in variables.

• { kind: "if"; cond: Expr; then: Action[]; else?: Action[] }

  Control-flow branch: run then if cond is true, else else_ (if any).

• { kind: "patchDeposit"; field: number; coord: Expr; amount: Expr }

  Atomically adds amount (f32) into a patch (grid) field at the world-space point coord (xz ground plane). Used by the agent layer for turtles depositing into a diffusion grid (pheromone trails). field indexes config.patchFields; the deposit lands in the nearest cell. Concurrent deposits from many agents compose via atomic add (fixed-point internally).

• { kind: "scratchSet"; slot: Expr; value: Expr }

  Write value into this agent's scratch slot slot (rounded + clamped). Requires config.scratch; UPDATE context only.

• { kind: "loop"; index: string; count: Expr; body: Action[] }

  Bounded for loop. Runs body count times with a loop counter exposed as a local variable named index (an f32, 0, 1, …, count-1) that the body reads via expr.variable(index). The first iteration construct in the IR — for iterating a scratch array (measure/reverse/copy a tour). count may be an expression; keep it bounded (GPU occupancy). UPDATE context.