Skip to content

AGENTS.md

Latest commit

 

History

History
26 lines (17 loc) · 2.18 KB

AGENTS.md

File metadata and controls

26 lines (17 loc) · 2.18 KB
Raw

Lasers

SceneryStack port of PhET legacy Java Lasers, SVN r75234. Read ../.github/AGENTS.md for shared guidance and ../Baton/skills/ for topic references. Provenance and behavior inventory: doc/upstream.md.

Architecture

Two independent screens wrap common/model/LaserModel.ts and common/view/LaserScreenView.ts. Model time is seconds; apparatus positions retain the upstream 300 × 120 coordinate system. Energy is measured relative to the -13.6 eV ground level. PHYSICS constants document the upstream educational time scale. Particle rendering never advances physics.

Model randomness is seeded and integration uses fixed 1/120 s substeps. Atom/photon records are owned by the model; aggregate populations are observable Properties. Models dispose all Properties and their level-change listener. Views live for the simulation lifetime.

Screen Folder Content
One Atom src/one-atom/ Stationary atom; two levels by default; seed beam; no pump or mirrors at start
Multiple Atoms src/multiple-atoms/ 30 moving atoms; three levels; pump beam; no seed control at start

Commands

Use Node 26. Run npm run lint, npm run check, npm test, npm run build; browser tests use FUZZ_PORT=5187 npx playwright test tests/browser. Fuzz with FUZZ_PORT=5187 npm run test:fuzz. Vitest uses happy-dom and the template leak harness.

Notes

  • tests/generators.test.ts: omitted because template-only rename/scaffold scripts are removed after bootstrap.
  • assets/: contains an openly licensed laser photograph with a visible glowing discharge tube (see assets/README.md) and PhET-authored reference sprites. The live apparatus uses SVG geometry (src/common/view/LaserArtwork.ts), including an SVG wavelength spectrum (WavelengthControl.ts).
  • src/LasersColors.ts: black default background and white projector background; panel colors, labels, apparatus gradients and spectral visibility adapt to the active profile.
  • doc/licenses/: retained upstream license text.
  • src/common/model/LaserModel.ts: owned mutable particle records and seeded RNG avoid allocating Properties for hundreds of short-lived photons; aggregate readouts remain observable.