Auto-generate SimOptions config for each simulator

[jkomoros]

Currently creators of a simulator have to generate both their SIMULATORSimOptions typescript type and their optionsConfig, and keep them in sync.

Ideally we'd have some tooling that would inspect the optionsConfig and then generate a SIMULATORSimOptions type, keeping hte optionsConfig canonical.

Then we could generate a file in simulators/types/SIMULATORNAME.ts for each one.

Then the SimOptions type can be a discrimnated union, where we include the proper simoptions type for each Simulator.

The optionsConfig is not necessarily JSON (it can include other constants, and like e.g. a hide() function). We'd probably need to swap in a temporary any typed SimOptions, and then load up the files, extract the values, and then it should be pretty simple to declaratively generate a Typescript type based on the options config.

See also #71

[jkomoros]

• [x] Make it so from a fresh checkout, wiht npm run build:clean:generated also run, npm run build:full works, and then separately verify npm run start:clean works.
• [x] Make it so npm run start:clean can be factored out to not do regeneration back and forth for bisect. (maybe create a new npm run start:bisect
• [x] Automatically type DistributionOptions when detected
• [x] Generate the src/simulators/types/*.GENERATED.ts files for each item
• [x] Generate src/simulator-types.ts automatically
• [x] Document that schema checking works in VSCode
• [x] Some way to generate complex sub-options like schelling-org automatically
• [x] Run npm run generate:schema automatically
• [x] Get rid of gulp usage and move to all src/tools/ node scripts
• [x] Add an import to the generated SimOptions type if it's not included in the main simulator script (although a better option is to have people just copy paste another simulator file and update any places that it's referred to)
• [x] Add a generate:types:clean command
• [x] Add a comment at the top of optionsConfig to remind people to re run npm run generate when it changes
• [x] Only generate schema if any type file or types-simulator.ts is newer than the schema (this requires us not emitting content if it matches the current contents so file modification times don't change unnecessarily).
• [x] Make sure the workflow of creating a new simulator works (especially while there is not yet a .GENERATED. file for it). (Maybe just have npm run generate)
• [x] Only generate a types cache entry for files who have been modified more recently than their cache entry
• [x] Make the cache entry src/simulators/types/.cache
• [x] Create a generate:types-stubs command, that runs when start runs.
• [x] Have types.ts import from dynamic types and re-export them and also for all of the individual types (verify schema generation doesn't break)
• [x] make it so npm run start from a fresh checkout works
• [x] Have generate:types handle if the javascript isn't generated (tsc hasn't been run)
• [x] Document the All rendering code should be after 'export default' in your simulator file requirement
• [x] Figure out ways to auto-generate even the SchellingOrg simulator types (that is, with multiple sub-types)
• [x] Document in README that you can skip the auto-generation by having a file in types yourself.
• [x] Create a SimOptions and NormalizedSimOptions (where ones with default and/or backfill (?)) are marked as non-optional
• [x] Every generated file should have at the top a comment saying which command generated it

[jkomoros]

72 uses these schemas

[jkomoros]

In branch auto-generate-simulator-types

[jkomoros]

All remaining issues now tracked in sub issues