Instrument for PhET-iO

[zepumph]

To help work on eliminating TTypes https://github.com/phetsims/phet-io/issues/1112, we are going to use blast as a guinea pig

How to Instrument a PhET Simulation for PhET-iO

Overview of instrumentation steps:

• Copy this checklist to the issue description (top issue comment) for tracking. Make sure to use a permanent link like /blob/<SHA>/ so that the specific guide you used is preserved.
• Understand the goal
• Code review
• Use Property instead of PropertySet
• Import Tandem to main.js
• Create root tandem
• Pass tandems to sim screens
• Pass tandems to model and view
• Pass tandems to all constructors defined by the simulation
  • See also Testing while adding Tandem instances. Test with ?phetioValidateTandems=false since some common code-components don't yet have tandems.
• Pass tandem instances to common code components
  • See also Testing while adding Tandem instances.
• Create static tandems where appropriate.
• Replace types with tandemized equivalents
• Instrument any uninstrumented common-code components used by the sim
• Instrument new component types defined by the sim
• Add simulation specific support
• Support dynamic state
• Make sure Joist dt values are used instead of Date.now() or other Date functions. This is necessary for reproducible playback via input events.
• Are random numbers using phet.joist.random, and all doing so after modules are declared (non-statically)? For instance, the following methods (and perhaps others) should not be used: Math.random, _.shuffle, _.sample, _.random
• undefined values cannot be saved by phet-io, sims should be written to use null instead
• Verify that the simulation works in all of the phet-io wrappers
• Add this sim to the list of phet-io sims in chipper/data/test-phetio
• Build with grunt --brand=phet-io and test the built version by launching build/wrappers/index and testing all the links
• Set up a task to have the newly instrumented sim tested by the QA team
• Update these instructions if you find them to be incomplete, inconsistent or incorrect
• After publishing, add your instrumented simulation to the spreadsheet here: https://docs.google.com/spreadsheets/d/1pU9izdNQkd9vr8TvLAfXe_v68yh-7potH-y712FBPr8/edit#gid=0

[samreid]

Let's abandon further phet-io instrumentation for this repo, closing.