@typeonce/ritmo-devtools 0.14.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/CHANGELOG.md +241 -0
  2. package/README.md +296 -55
  3. package/dist/Desync.d.ts +17 -3
  4. package/dist/Desync.d.ts.map +1 -1
  5. package/dist/Desync.js +17 -15
  6. package/dist/Desync.js.map +1 -1
  7. package/dist/Determinism.d.ts +17 -6
  8. package/dist/Determinism.d.ts.map +1 -1
  9. package/dist/Determinism.js +11 -3
  10. package/dist/Determinism.js.map +1 -1
  11. package/dist/Format.d.ts +43 -8
  12. package/dist/Format.d.ts.map +1 -1
  13. package/dist/Format.js +63 -31
  14. package/dist/Format.js.map +1 -1
  15. package/dist/Fuzz.d.ts +268 -0
  16. package/dist/Fuzz.d.ts.map +1 -0
  17. package/dist/Fuzz.js +355 -0
  18. package/dist/Fuzz.js.map +1 -0
  19. package/dist/Invariant.d.ts +6 -2
  20. package/dist/Invariant.d.ts.map +1 -1
  21. package/dist/Invariant.js.map +1 -1
  22. package/dist/PlaywrightEngine.d.ts +29 -0
  23. package/dist/PlaywrightEngine.d.ts.map +1 -0
  24. package/dist/PlaywrightEngine.js +193 -0
  25. package/dist/PlaywrightEngine.js.map +1 -0
  26. package/dist/Replay.d.ts +40 -22
  27. package/dist/Replay.d.ts.map +1 -1
  28. package/dist/Replay.js +20 -27
  29. package/dist/Replay.js.map +1 -1
  30. package/dist/Session.d.ts +214 -17
  31. package/dist/Session.d.ts.map +1 -1
  32. package/dist/Session.js +563 -57
  33. package/dist/Session.js.map +1 -1
  34. package/dist/Verify.d.ts +147 -0
  35. package/dist/Verify.d.ts.map +1 -0
  36. package/dist/Verify.js +151 -0
  37. package/dist/Verify.js.map +1 -0
  38. package/dist/cli.js +136 -8
  39. package/dist/cli.js.map +1 -1
  40. package/dist/index.d.ts +3 -2
  41. package/dist/index.d.ts.map +1 -1
  42. package/dist/index.js +3 -2
  43. package/dist/index.js.map +1 -1
  44. package/dist/internal/dependencyScan.d.ts +44 -0
  45. package/dist/internal/dependencyScan.d.ts.map +1 -0
  46. package/dist/internal/dependencyScan.js +313 -0
  47. package/dist/internal/dependencyScan.js.map +1 -0
  48. package/dist/internal/fuzzNetwork.d.ts +56 -0
  49. package/dist/internal/fuzzNetwork.d.ts.map +1 -0
  50. package/dist/internal/fuzzNetwork.js +96 -0
  51. package/dist/internal/fuzzNetwork.js.map +1 -0
  52. package/dist/internal/values.d.ts +9 -1
  53. package/dist/internal/values.d.ts.map +1 -1
  54. package/dist/internal/values.js +11 -1
  55. package/dist/internal/values.js.map +1 -1
  56. package/dist/internal/verifyRunner.d.ts +19 -0
  57. package/dist/internal/verifyRunner.d.ts.map +1 -0
  58. package/dist/internal/verifyRunner.js +47 -0
  59. package/dist/internal/verifyRunner.js.map +1 -0
  60. package/dist/internal/version.d.ts +1 -1
  61. package/dist/internal/version.js +1 -1
  62. package/package.json +28 -3
  63. package/src/Desync.ts +34 -17
  64. package/src/Determinism.ts +46 -11
  65. package/src/Format.ts +99 -34
  66. package/src/Fuzz.ts +544 -0
  67. package/src/Invariant.ts +6 -2
  68. package/src/PlaywrightEngine.ts +229 -0
  69. package/src/Replay.ts +87 -43
  70. package/src/Session.ts +806 -72
  71. package/src/Verify.ts +273 -0
  72. package/src/cli.ts +131 -8
  73. package/src/index.ts +3 -2
  74. package/src/internal/dependencyScan.ts +356 -0
  75. package/src/internal/fuzzNetwork.ts +130 -0
  76. package/src/internal/values.ts +20 -1
  77. package/src/internal/verifyRunner.ts +46 -0
  78. package/src/internal/version.ts +1 -1
  79. package/dist/Monitor.d.ts +0 -101
  80. package/dist/Monitor.d.ts.map +0 -1
  81. package/dist/Monitor.js +0 -602
  82. package/dist/Monitor.js.map +0 -1
  83. package/dist/internal/monitor.d.ts +0 -126
  84. package/dist/internal/monitor.d.ts.map +0 -1
  85. package/dist/internal/monitor.js +0 -279
  86. package/dist/internal/monitor.js.map +0 -1
  87. package/src/Monitor.ts +0 -713
  88. package/src/internal/monitor.ts +0 -370
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dependencyScan.js","sourceRoot":"","sources":["../../src/internal/dependencyScan.ts"],"names":[],"mappings":";;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC9G,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAEvD,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAA;AAEhD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,wBAAwB,EAAE,0BAA0B,EAAE,iCAAiC,CAAU,CAAA;AAkCvH,MAAM,UAAU,GAAG,0BAA0B,CAAA;AAC7C,MAAM,SAAS,GAAG,GAAG,CAAA;AACrB,MAAM,OAAO,GAAG,cAAc,CAAA;AAE9B,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAEtE,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAW,EAAE;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC,CAAA;AAED,+GAA+G;AAC/G,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,IAAY,EAAsB,EAAE;IACrE,KAAK,IAAI,SAAS,GAAG,IAAI,GAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,IAAI,CAAC,CAAA;QACvD,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,YAAY,CAAC,SAAS,CAAC,CAAA;QAC/E,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,SAAS;YAAE,OAAO,SAAS,CAAA;IACxD,CAAC;AACH,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,KAAc,EAAsB,EAAE;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACvD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACtC,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC9E,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;YAClC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAA;QACvC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,wHAAwH;AACxH,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAU,EAAE;IACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAA;IAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IACzE,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;WAC5B,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;WACrE,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IACvE,OAAO,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AAChC,CAAC,CAAA;AAED,MAAM,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAEjE,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,IAAY,EAAsB,EAAE,CAChE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAA;AAQjE,8DAA8D;AAC9D,MAAM,YAAY,GAAG,KAAK,EAAE,IAAY,EAAiC,EAAE;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACjC,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAA;IAC9G,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC7C,MAAM,MAAM,GAAY,MAAM,MAAM,kCAAC,aAAa,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAC,CAAA;IACjF,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAClE,6EAA6E;IAC7E,OAAO,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAoB,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1E,CAAC,CAAA;AAED,oFAAoF;AACpF,MAAM,OAAO,GAAG,KAAK,EAAE,QAAkB,EAAE,KAAa,EAAkC,EAAE;IAC1F,IAAI,GAAG,GAA0B,EAAE,CAAA;IACnC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;QAC5B,KAAK,EAAE,KAAK;QACZ,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC;QACnB,gEAAgE;QAChE,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,qBAAqB;gBAC3B,QAAQ;oBACN,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAA;gBAChC,CAAC;aACF,CAAC;KACH,CAAC,CAAA;IACF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AACvI,CAAC,CAAA;AASD,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAyC,EAAE;IACjF,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IAChF,MAAM,GAAG,GAAsB,EAAE,CAAA;IACjC,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,UAAU,CAAC,UAAU,CAAC,KAAK,QAAQ;YAAE,SAAQ;QAC3H,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAA;QACtE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACvF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACnF,IAAI,CAAE,KAA+B,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,SAAS;YAAE,SAAQ;QACpF,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ;YAAE,SAAQ;QACtF,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAY,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAChH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,KAA4B,EAAuD,EAAE;IACjI,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;IAC5D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;QAC/C,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;YACnC,SAAS,EAAE,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;YAClC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YAC/D,cAAc,EAAE,EAAE;SACnB,CAAC,CAAC,CAAA;QACH,MAAM,WAAW,GAAsB,EAAE,CAAA;QACzC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,SAAS,EAAE,CAAC;YAC7D,MAAM,GAAG,GAAG,SAAS,CACnB,OAAO,CAAC,QAAQ,EAChB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,yBAAyB,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC,EAC9H,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CACpD,CAAA;YACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;YACjD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;YAChI,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;QAC7B,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACpC,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,CAAC;AACH,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAC7C,OAAO,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC,CAAA;AAED,kHAAkH;AAClH,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,KAAgC,EAA0B,EAAE;IAC1G,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;IAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAChC,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;IAC7D,MAAM,GAAG,GAAmB,EAAE,CAAA;IAC9B,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,UAAU,IAAI,MAAM,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QACrD,IAAI,SAAS,GAAG,MAAM,CAAA;QACtB,KAAK,IAAI,KAAK,GAAG,MAAM,EAAE,KAAK,GAAG,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;YAC9C,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1B,IAAI,EAAE,CAAA;gBACN,MAAM,GAAG,CAAC,CAAA;gBACV,SAAS,GAAG,KAAK,GAAG,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAA;QAChE,MAAM,GAAG,GAAG,CAAA;QACZ,GAAG,CAAC,IAAI,CAAC;YACP,IAAI;YACJ,IAAI;YACJ,MAAM;YACN,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SAC5G,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED,0EAA0E;AAC1E,MAAM,SAAS,GAAG,CAAC,KAAsC,EAAE,IAAY,EAAsB,EAAE;IAC7F,MAAM,OAAO,GAAkB,EAAE,CAAA;IACjC,IAAI,IAAwB,CAAA;IAC5B,KAAK,IAAI,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrE,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACzB,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;YAC3B,MAAK;QACP,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACvB,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAA;QAC1D,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;YAC1F,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;YACvB,MAAK;QACP,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,CAAC,KAAK,SAAS;YAAE,MAAK;IAC7C,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,OAAO;QAAE,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC3D,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,EAAE,KAAa,EAAE,GAAW,EAA6C,EAAE;IACjG,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACpC,IAAI,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,KAAK,gBAAgB,EAAE,CAAC,CAAA;QACvH,YAAY,CAAC,QAAQ,CAAC,CAAA;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,KAAK,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;IACtJ,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC5C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;IACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,yCAAyC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAA;IAC7I,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAA;IAC5D,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,2CAA2C,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC,CAAA;IAC3K,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;IACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;IAEjJ,IAAI,KAA4B,CAAA;IAChC,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAA;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACnH,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAA;IAChE,IAAI,CAAC,WAAW,CAAC,EAAE;QAAE,OAAO,WAAW,CAAA;IAEvC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAA;IACnD,KAAK,MAAM,UAAU,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAA;IAC7D,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAA;IACnD,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAA;IAC/D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAsD,CAAC,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IAChH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,OAAO,CAAA;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;QAC5D,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACvE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACzB,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC;SACzB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACvE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;IACnF,OAAO,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;AACzG,CAAC,CAAA;AAED,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,IAAY,EAAU,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;AAEnG,yFAAyF;AACzF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAc,EAAU,EAAE;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC5E,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;QACzE,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QACxG,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,gBAAgB,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAA;IACtM,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC;QAClB,CAAC,CAAC,8QAA8Q;QAChR,CAAC,CAAC,8KAA8K,CAAC,CAAA;IACnL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC,CAAA"}
@@ -0,0 +1,56 @@
1
+ import type * as Clock from "@typeonce/ritmo/Clock";
2
+ import type * as Descriptor from "@typeonce/ritmo/Descriptor";
3
+ import { Netcode } from "@typeonce/ritmo-netcode";
4
+ import type { Invariant } from "../Invariant.ts";
5
+ import type * as Replay from "../Replay.ts";
6
+ /** What one networked simulation came to: as `Fuzz`'s single-runtime outcome, without a replay. */
7
+ export type NetworkOutcome<Violation> = {
8
+ readonly kind: "passed";
9
+ } | {
10
+ readonly kind: "violated";
11
+ readonly violation: Violation;
12
+ readonly frame: number;
13
+ } | {
14
+ readonly kind: "invalid";
15
+ readonly message: string;
16
+ };
17
+ export interface NetworkPlan {
18
+ /** The seats' service, codec, count, and idle input. */
19
+ readonly name: string;
20
+ readonly codec: Descriptor.Codec<any, any>;
21
+ readonly count: number;
22
+ readonly idle: unknown;
23
+ /** The game's factory, and the schedules it is fuzzed with. */
24
+ readonly make: (playback: Replay.Playback) => {
25
+ readonly runtime: unknown;
26
+ readonly schedules: Readonly<Record<string, unknown>>;
27
+ };
28
+ readonly schedule: string;
29
+ readonly setup: string | undefined;
30
+ readonly invariants: ReadonlyArray<Invariant>;
31
+ readonly step: Clock.Step;
32
+ readonly seed: number;
33
+ readonly latencyMS: number;
34
+ readonly jitterMS: number;
35
+ readonly loss: number;
36
+ readonly settle: number;
37
+ readonly inputDelay: number | undefined;
38
+ readonly maxRollback: number | undefined;
39
+ readonly checksumEvery: number | undefined;
40
+ }
41
+ export type NetworkViolation = {
42
+ readonly _tag: "SessionFailed";
43
+ readonly seat: number;
44
+ readonly error: Netcode.SessionError<unknown>;
45
+ } | {
46
+ readonly _tag: "InvariantViolated";
47
+ readonly invariant: string;
48
+ readonly message: string;
49
+ } | {
50
+ readonly _tag: "Defect";
51
+ readonly invariant: string | undefined;
52
+ readonly error: unknown;
53
+ };
54
+ /** Plays `timeline` (per frame, the seats input's value: every seat's local input) on one peer per seat, then `settle` idle frames. */
55
+ export declare const play: (plan: NetworkPlan, timeline: ReadonlyArray<ReadonlyArray<unknown>>) => NetworkOutcome<NetworkViolation>;
56
+ //# sourceMappingURL=fuzzNetwork.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fuzzNetwork.d.ts","sourceRoot":"","sources":["../../src/internal/fuzzNetwork.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,KAAK,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,KAAK,UAAU,MAAM,4BAA4B,CAAA;AAE7D,OAAO,EAAqB,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,KAAK,MAAM,MAAM,cAAc,CAAA;AAE3C,mGAAmG;AACnG,MAAM,MAAM,cAAc,CAAC,SAAS,IAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,KAAK;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAA;IAClI,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;IAC7C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3C;AAQD,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;CAAE,GACxG;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5F;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEhG,uIAAuI;AACvI,eAAO,MAAM,IAAI,SAAU,WAAW,YAAY,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,KAAG,cAAc,CAAC,gBAAgB,CAyExH,CAAA"}
@@ -0,0 +1,96 @@
1
+ /**
2
+ * The network half of `Fuzz.run`: one simulation of every seat as its own
3
+ * peer, each a fresh runtime from the game's factory, joined by a seeded
4
+ * `MemoryNetworkLink` on one test clock and driven by `Netcode.rollback`
5
+ * sessions. Deterministic for a timeline and a network seed, so shrinking
6
+ * can run it again.
7
+ */
8
+ import { HostClock } from "@typeonce/ritmo";
9
+ import { MemoryNetworkLink, Netcode } from "@typeonce/ritmo-netcode";
10
+ /** Plays `timeline` (per frame, the seats input's value: every seat's local input) on one peer per seat, then `settle` idle frames. */
11
+ export const play = (plan, timeline) => {
12
+ const hostClock = HostClock.test();
13
+ const links = MemoryNetworkLink.make({ peers: plan.count, hostClock, seed: plan.seed, latencyMS: plan.latencyMS, jitterMS: plan.jitterMS, loss: plan.loss });
14
+ if (!links.ok)
15
+ return { kind: "invalid", message: `network.${links.error.field} is out of range: ${links.error.value}` };
16
+ const peers = [];
17
+ for (let seat = 0; seat < plan.count; seat++) {
18
+ const seats = Netcode.seats(plan.codec, { count: plan.count, idle: plan.idle });
19
+ if (!seats.ok)
20
+ return { kind: "invalid", message: `the seats' idle input: ${seats.error.reason}` };
21
+ const unknown = [];
22
+ const playback = {
23
+ source: (descriptor) => {
24
+ if (descriptor.name !== plan.name)
25
+ unknown.push(descriptor.name);
26
+ // `Fuzz.seats` checked that this service is a `Netcode.Source` of the seats' input.
27
+ return seats.value.source;
28
+ },
29
+ constant: () => undefined
30
+ };
31
+ const target = plan.make(playback);
32
+ if (unknown.length > 0)
33
+ return { kind: "invalid", message: `make asked playback.source for ${unknown.join(", ")}: over a network the simulation reads its input from the seats alone` };
34
+ const runtime = target.runtime;
35
+ const schedule = target.schedules[plan.schedule];
36
+ if (schedule === undefined)
37
+ return { kind: "invalid", message: `make returned no schedule ${plan.schedule}` };
38
+ // Only seat 0 sets up: every peer starts from its save.
39
+ if (seat === 0 && plan.setup !== undefined) {
40
+ const setup = target.schedules[plan.setup];
41
+ if (setup === undefined)
42
+ return { kind: "invalid", message: `make returned no schedule ${plan.setup}` };
43
+ const ticked = runtime.tryTick(setup);
44
+ if (!ticked.ok)
45
+ return { kind: "invalid", message: `setup failed with every input neutral: ${JSON.stringify(ticked.error)}` };
46
+ }
47
+ // `Fuzz.run`'s signature checked that the schedule rewinds and the runtime saves, as `Netcode.rollback` does.
48
+ const session = Netcode.rollback(runtime, {
49
+ simulate: schedule,
50
+ seats: seats.value,
51
+ seat,
52
+ links: [links.value[seat]],
53
+ hostClock,
54
+ step: plan.step,
55
+ keepSnapshots: true,
56
+ ...(plan.inputDelay === undefined ? {} : { inputDelay: plan.inputDelay }),
57
+ ...(plan.maxRollback === undefined ? {} : { maxRollback: plan.maxRollback }),
58
+ ...(plan.checksumEvery === undefined ? {} : { checksumEvery: plan.checksumEvery })
59
+ });
60
+ if (!session.ok)
61
+ return { kind: "invalid", message: `network.${session.error.field}: ${session.error.reason}` };
62
+ peers.push({ runtime, session: session.value });
63
+ }
64
+ const stepMS = plan.step.dt * 1000;
65
+ const frames = timeline.length + plan.settle;
66
+ for (let frame = 0; frame < frames; frame++) {
67
+ const values = timeline[frame]?.[0];
68
+ for (const [seat, { session }] of peers.entries()) {
69
+ let advanced;
70
+ try {
71
+ advanced = session.advance(values === undefined ? plan.idle : values[seat]);
72
+ }
73
+ catch (error) {
74
+ return { kind: "violated", violation: { _tag: "Defect", invariant: undefined, error }, frame: frame + 1 };
75
+ }
76
+ if (!advanced.ok)
77
+ return { kind: "violated", violation: { _tag: "SessionFailed", seat, error: advanced.error }, frame: frame + 1 };
78
+ }
79
+ for (const { runtime } of peers) {
80
+ for (const invariant of plan.invariants) {
81
+ let message;
82
+ try {
83
+ message = runtime.inspect(invariant.inspector);
84
+ }
85
+ catch (error) {
86
+ return { kind: "violated", violation: { _tag: "Defect", invariant: invariant.name, error }, frame: frame + 1 };
87
+ }
88
+ if (typeof message === "string")
89
+ return { kind: "violated", violation: { _tag: "InvariantViolated", invariant: invariant.name, message }, frame: frame + 1 };
90
+ }
91
+ }
92
+ hostClock.adjust(stepMS);
93
+ }
94
+ return { kind: "passed" };
95
+ };
96
+ //# sourceMappingURL=fuzzNetwork.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fuzzNetwork.js","sourceRoot":"","sources":["../../src/internal/fuzzNetwork.ts"],"names":[],"mappings":"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"}
@@ -1,8 +1,16 @@
1
- /** Value checks shared by sessions and the monitor. */
1
+ /** Value checks used by sessions. */
2
+ import type * as Debug from "@typeonce/ritmo/Debug";
2
3
  /**
3
4
  * The path of the first NaN or infinite number inside a value (`""` for the
4
5
  * value itself), or `undefined`. Walks arrays and object properties; stops at
5
6
  * `depth` levels and at objects already visited.
6
7
  */
7
8
  export declare const nonFinitePath: (value: unknown, depth?: number, seen?: Set<object>) => string | undefined;
9
+ /** The declared ranges (`meta` with `range`) of one descriptor's fields. */
10
+ export type FieldRanges = ReadonlyArray<readonly [field: string, min: number, max: number]>;
11
+ /** Every declared field range, by component and by resource name; descriptors without one are left out. */
12
+ export declare const rangesOf: (description: Debug.Description) => {
13
+ readonly component: ReadonlyMap<string, FieldRanges>;
14
+ readonly resource: ReadonlyMap<string, FieldRanges>;
15
+ };
8
16
  //# sourceMappingURL=values.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/internal/values.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD;;;;GAIG;AACH,eAAO,MAAM,aAAa,UAAW,OAAO,yBAAmB,GAAG,CAAC,MAAM,CAAC,KAAe,MAAM,GAAG,SASjG,CAAA"}
1
+ {"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/internal/values.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,KAAK,KAAK,KAAK,MAAM,uBAAuB,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,aAAa,UAAW,OAAO,yBAAmB,GAAG,CAAC,MAAM,CAAC,KAAe,MAAM,GAAG,SASjG,CAAA;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AAW3F,2GAA2G;AAC3G,eAAO,MAAM,QAAQ,gBAAiB,KAAK,CAAC,WAAW,KAAG;IACxD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACpD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CAC4C,CAAA"}
@@ -1,4 +1,3 @@
1
- /** Value checks shared by sessions and the monitor. */
2
1
  /**
3
2
  * The path of the first NaN or infinite number inside a value (`""` for the
4
3
  * value itself), or `undefined`. Walks arrays and object properties; stops at
@@ -17,4 +16,15 @@ export const nonFinitePath = (value, depth = 6, seen = new Set()) => {
17
16
  }
18
17
  return undefined;
19
18
  };
19
+ const rangesBy = (entries) => {
20
+ const ranges = new Map();
21
+ for (const { name, meta } of entries) {
22
+ const fields = Object.entries(meta).flatMap(([field, entry]) => entry.range === undefined ? [] : [[field, entry.range[0], entry.range[1]]]);
23
+ if (fields.length > 0)
24
+ ranges.set(name, fields);
25
+ }
26
+ return ranges;
27
+ };
28
+ /** Every declared field range, by component and by resource name; descriptors without one are left out. */
29
+ export const rangesOf = (description) => ({ component: rangesBy(description.components), resource: rangesBy(description.resources) });
20
30
  //# sourceMappingURL=values.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/internal/values.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,GAAgB,IAAI,GAAG,EAAE,EAAsB,EAAE;IAC5G,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACnG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;QAClD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAA;IAC7F,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA"}
1
+ {"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/internal/values.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,GAAgB,IAAI,GAAG,EAAE,EAAsB,EAAE;IAC5G,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACnG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;QAClD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAA;IAC7F,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAKD,MAAM,QAAQ,GAAG,CAAC,OAAoG,EAAoC,EAAE;IAC1J,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC7C,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAU,CAAC,CAAC,CAAA;QACpJ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACjD,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,2GAA2G;AAC3G,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,WAA8B,EAGrD,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * The page side of `PlaywrightEngine`: loaded in a browser by the Vite dev
3
+ * server it starts, it imports the game's entry and runs `Verify.trace` and
4
+ * `Verify.snapshotAt` there with the entry's `replayTarget`. What it returns
5
+ * crosses to Node as JSON, so it returns plain results and never throws a
6
+ * value Node cannot read.
7
+ */
8
+ import * as Result from "@typeonce/ritmo/Result";
9
+ import type * as Snapshot from "@typeonce/ritmo/Snapshot";
10
+ import type * as Replay from "../Replay.ts";
11
+ import * as Verify from "../Verify.ts";
12
+ /** What the page exposes to `PlaywrightEngine`. */
13
+ export interface Runner {
14
+ readonly trace: (file: Replay.ReplayFile) => Result.Result<Verify.Hashes, string>;
15
+ readonly snapshotAt: (file: Replay.ReplayFile, tick: number) => Result.Result<Snapshot.WorldSnapshot, string>;
16
+ }
17
+ /** Imports the entry at `url` (a dev server path) and checks it exports `replayTarget`. */
18
+ export declare const start: (url: string) => Promise<Result.Result<Runner, string>>;
19
+ //# sourceMappingURL=verifyRunner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verifyRunner.d.ts","sourceRoot":"","sources":["../../src/internal/verifyRunner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAA;AAChD,OAAO,KAAK,KAAK,QAAQ,MAAM,0BAA0B,CAAA;AAEzD,OAAO,KAAK,KAAK,MAAM,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AAEtC,mDAAmD;AACnD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjF,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;CAC9G;AAID,2FAA2F;AAC3F,eAAO,MAAM,KAAK,QAAe,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuB9E,CAAA"}
@@ -0,0 +1,47 @@
1
+ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
2
+ if (typeof path === "string" && /^\.\.?\//.test(path)) {
3
+ return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
4
+ return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
5
+ });
6
+ }
7
+ return path;
8
+ };
9
+ /**
10
+ * The page side of `PlaywrightEngine`: loaded in a browser by the Vite dev
11
+ * server it starts, it imports the game's entry and runs `Verify.trace` and
12
+ * `Verify.snapshotAt` there with the entry's `replayTarget`. What it returns
13
+ * crosses to Node as JSON, so it returns plain results and never throws a
14
+ * value Node cannot read.
15
+ */
16
+ import * as Result from "@typeonce/ritmo/Result";
17
+ import * as Verify from "../Verify.js";
18
+ const describe = (error) => error instanceof Error ? `${error.message}\n${error.stack ?? ""}` : JSON.stringify(error);
19
+ /** Imports the entry at `url` (a dev server path) and checks it exports `replayTarget`. */
20
+ export const start = async (url) => {
21
+ let loaded;
22
+ try {
23
+ loaded = await import(__rewriteRelativeImportExtension(/* @vite-ignore */ url));
24
+ }
25
+ catch (error) {
26
+ return Result.failure(`the entry did not load in the browser: ${describe(error)}`);
27
+ }
28
+ const make = typeof loaded === "object" && loaded !== null ? Reflect.get(loaded, "replayTarget") : undefined;
29
+ if (typeof make !== "function")
30
+ return Result.failure("the entry must export replayTarget: (playback) => { runtime, schedules, hostClock } (see the Verify module)");
31
+ // The CLI checked the same entry in Node, where its type is checked too.
32
+ const target = make;
33
+ const guard = (run) => {
34
+ try {
35
+ const result = run();
36
+ return result.ok ? result : Result.failure(`the replay did not open: ${JSON.stringify(result.error)}`);
37
+ }
38
+ catch (error) {
39
+ return Result.failure(`the game threw: ${describe(error)}`);
40
+ }
41
+ };
42
+ return Result.success({
43
+ trace: (file) => guard(() => Verify.trace(target, file)),
44
+ snapshotAt: (file, tick) => guard(() => Verify.snapshotAt(target, file, tick))
45
+ });
46
+ };
47
+ //# sourceMappingURL=verifyRunner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verifyRunner.js","sourceRoot":"","sources":["../../src/internal/verifyRunner.ts"],"names":[],"mappings":";;;;;;;;AAAA;;;;;;GAMG;AACH,OAAO,KAAK,MAAM,MAAM,wBAAwB,CAAA;AAIhD,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AAQtC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AAEtI,2FAA2F;AAC3F,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,EAAE,GAAW,EAA0C,EAAE;IACjF,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,kCAAC,kBAAkB,CAAC,GAAG,EAAC,CAAA;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,MAAM,CAAC,OAAO,CAAC,0CAA0C,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,IAAI,GAAY,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACrH,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,6GAA6G,CAAC,CAAA;IACpK,yEAAyE;IACzE,MAAM,MAAM,GAAG,IAA8D,CAAA;IAC7E,MAAM,KAAK,GAAG,CAAI,GAAoC,EAA4B,EAAE;QAClF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,GAAG,EAAE,CAAA;YACpB,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACxG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,MAAM,CAAC,OAAO,CAAC,mBAAmB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC,CAAA;IACD,OAAO,MAAM,CAAC,OAAO,CAAC;QACpB,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;KAC/E,CAAC,CAAA;AACJ,CAAC,CAAA"}
@@ -3,5 +3,5 @@
3
3
  * `package.json` by `scripts/sync-version.ts` (run by \`pnpm version-packages\`)
4
4
  * and checked by a test.
5
5
  */
6
- export declare const libraryVersion = "0.14.0";
6
+ export declare const libraryVersion = "0.15.0";
7
7
  //# sourceMappingURL=version.d.ts.map
@@ -3,5 +3,5 @@
3
3
  * `package.json` by `scripts/sync-version.ts` (run by \`pnpm version-packages\`)
4
4
  * and checked by a test.
5
5
  */
6
- export const libraryVersion = "0.14.0";
6
+ export const libraryVersion = "0.15.0";
7
7
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@typeonce/ritmo-devtools",
3
- "version": "0.14.0",
4
- "description": "Headless debug sessions, trace history, text reports, and a live browser monitor for Ritmo runtimes",
3
+ "version": "0.15.0",
4
+ "description": "Headless debug sessions, trace history, text reports, replays, and fuzzing for Ritmo runtimes",
5
5
  "author": "Sandro Maglione",
6
6
  "license": "MIT",
7
7
  "repository": {
@@ -51,7 +51,32 @@
51
51
  "provenance": true
52
52
  },
53
53
  "dependencies": {
54
- "@typeonce/ritmo": "^0.14.0"
54
+ "@typeonce/ritmo": "^0.15.0",
55
+ "@typeonce/ritmo-netcode": "^0.15.0"
56
+ },
57
+ "peerDependencies": {
58
+ "oxlint": ">=1.86.0",
59
+ "playwright": ">=1.40",
60
+ "rolldown": ">=1.0.0-rc.12",
61
+ "vite": ">=6"
62
+ },
63
+ "peerDependenciesMeta": {
64
+ "oxlint": {
65
+ "optional": true
66
+ },
67
+ "playwright": {
68
+ "optional": true
69
+ },
70
+ "rolldown": {
71
+ "optional": true
72
+ },
73
+ "vite": {
74
+ "optional": true
75
+ }
76
+ },
77
+ "devDependencies": {
78
+ "playwright": "^1.64.1",
79
+ "vite": "^8.0.3"
55
80
  },
56
81
  "engines": {
57
82
  "node": ">=22.15"
package/src/Desync.ts CHANGED
@@ -5,9 +5,11 @@
5
5
  * A `Netcode` session made with `keepSnapshots: true` fails with `Desynced`
6
6
  * carrying this peer's save of the tick whose checksums differ; the other
7
7
  * peer's session carries its own. `compare(mine, theirs)` lists every
8
- * difference, entities by id and values by path, so an agent can see which
8
+ * difference, entities by id (and label, given `labels`) and values by path, so an agent can see which
9
9
  * component or resource went apart first, then find the system that wrote
10
10
  * it with a `Session`'s `why` on a headless rerun.
11
+ * The same goes for the two saves a `Netcode.syncTest`'s `RewindDiffers`
12
+ * carries (`keepSnapshots: true`): the first run's and the one after a rewind.
11
13
  *
12
14
  * @module Desync
13
15
  * @docGroup devtools
@@ -17,7 +19,7 @@
17
19
  * const left = sessions[0].advance(input)
18
20
  * const right = sessions[1].advance(input)
19
21
  * if (!left.ok && left.error._tag === "Desynced" && !right.ok && right.error._tag === "Desynced") {
20
- * console.log(Desync.compare(left.error.snapshot!, right.error.snapshot!))
22
+ * console.log(Desync.compare(left.error.snapshot!, right.error.snapshot!, { labels: runtime.inspect(Labels) }))
21
23
  * }
22
24
  * ```
23
25
  */
@@ -30,6 +32,8 @@ import * as Rendered from "./Rendered.ts"
30
32
  export interface Difference {
31
33
  /** `nextEntity`, `entity 12`, `entity 12 Game/Position.x`, `resource Game/Score`, `machine Game/Round`, `relation Game/ChildOf`, or `scope Game/Wave`. */
32
34
  readonly path: string
35
+ /** The entity the difference is in, when it is in one. */
36
+ readonly entity: number | undefined
33
37
  readonly mine: unknown
34
38
  readonly theirs: unknown
35
39
  }
@@ -38,46 +42,59 @@ const isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>
38
42
  typeof value === "object" && value !== null && !Array.isArray(value)
39
43
 
40
44
  /** The leaves where two values differ, under `path`. */
41
- const differences = (path: string, mine: unknown, theirs: unknown, into: Array<Difference>): void => {
45
+ const differences = (path: string, entity: number | undefined, mine: unknown, theirs: unknown, into: Array<Difference>): void => {
42
46
  if (Format.sameValue(mine, theirs)) return
43
47
  if (isRecord(mine) && isRecord(theirs)) {
44
48
  for (const key of [...new Set([...Object.keys(mine), ...Object.keys(theirs)])].sort()) {
45
- differences(`${path}.${key}`, mine[key], theirs[key], into)
49
+ differences(`${path}.${key}`, entity, mine[key], theirs[key], into)
46
50
  }
47
51
  return
48
52
  }
49
53
  if (Array.isArray(mine) && Array.isArray(theirs) && mine.length === theirs.length) {
50
- mine.forEach((item, index) => differences(`${path}[${index}]`, item, theirs[index], into))
54
+ mine.forEach((item, index) => differences(`${path}[${index}]`, entity, item, theirs[index], into))
51
55
  return
52
56
  }
53
- into.push({ path, mine, theirs })
57
+ into.push({ path, entity, mine, theirs })
54
58
  }
55
59
 
56
60
  /** Each named entry of two records, compared under `kind name`. */
57
- const byName = (kind: string, mine: Readonly<Record<string, unknown>>, theirs: Readonly<Record<string, unknown>>, into: Array<Difference>): void => {
61
+ const byName = (kind: string, entity: number | undefined, mine: Readonly<Record<string, unknown>>, theirs: Readonly<Record<string, unknown>>, into: Array<Difference>): void => {
58
62
  for (const name of [...new Set([...Object.keys(mine), ...Object.keys(theirs)])].sort()) {
59
- differences(`${kind} ${name}`, mine[name], theirs[name], into)
63
+ differences(`${kind} ${name}`, entity, mine[name], theirs[name], into)
60
64
  }
61
65
  }
62
66
 
67
+ /** How `compare` prints. */
68
+ export interface CompareOptions {
69
+ /**
70
+ * Names entities in the text (`player e12 Game/Position.x`): the map the
71
+ * session's `labels` inspector returns, read with `runtime.inspect(Labels)`
72
+ * on either peer. Without it entities print as `e12`.
73
+ */
74
+ readonly labels?: Format.Labels
75
+ }
76
+
63
77
  /** Every difference between two saves, in a stable order: the next id, entities by id, then resources, machines, relations, and scopes by name. */
64
- export const compare = (mine: Snapshot.WorldSnapshot, theirs: Snapshot.WorldSnapshot): Rendered.Rendered<ReadonlyArray<Difference>> => {
78
+ export const compare = (mine: Snapshot.WorldSnapshot, theirs: Snapshot.WorldSnapshot, options: CompareOptions = {}): Rendered.Rendered<ReadonlyArray<Difference>> => {
65
79
  const found: Array<Difference> = []
66
- differences("nextEntity", mine.nextEntity, theirs.nextEntity, found)
80
+ differences("nextEntity", undefined, mine.nextEntity, theirs.nextEntity, found)
67
81
  const mineById = new Map(mine.entities.map((entity) => [entity.id, entity.components] as const))
68
82
  const theirsById = new Map(theirs.entities.map((entity) => [entity.id, entity.components] as const))
69
83
  for (const id of [...new Set([...mineById.keys(), ...theirsById.keys()])].sort((a, b) => a - b)) {
70
84
  const left = mineById.get(id)
71
85
  const right = theirsById.get(id)
72
- if (left === undefined || right === undefined) found.push({ path: `entity ${id}`, mine: left, theirs: right })
73
- else byName(`entity ${id}`, left, right, found)
86
+ if (left === undefined || right === undefined) found.push({ path: `entity ${id}`, entity: id, mine: left, theirs: right })
87
+ else byName(`entity ${id}`, id, left, right, found)
74
88
  }
75
- byName("resource", mine.resources, theirs.resources, found)
76
- byName("machine", mine.machines, theirs.machines, found)
77
- byName("relation", mine.relations, theirs.relations, found)
78
- byName("scope", mine.scopes, theirs.scopes, found)
89
+ byName("resource", undefined, mine.resources, theirs.resources, found)
90
+ byName("machine", undefined, mine.machines, theirs.machines, found)
91
+ byName("relation", undefined, mine.relations, theirs.relations, found)
92
+ byName("scope", undefined, mine.scopes, theirs.scopes, found)
93
+ // `entity 12 ...` prints as `player e12 ...`, like every entity in devtools text.
94
+ const where = ({ path, entity }: Difference) =>
95
+ entity === undefined ? path : `${Format.entity(entity, options.labels)}${path.slice(`entity ${entity}`.length)}`
79
96
  const text = found.length === 0
80
97
  ? "The saves are equal."
81
- : [`${found.length} difference${found.length === 1 ? "" : "s"} (mine -> theirs):`, ...found.map(({ path, mine, theirs }) => ` ${path}: ${Format.value(mine)} -> ${Format.value(theirs)}`)].join("\n")
98
+ : [`${found.length} difference${found.length === 1 ? "" : "s"} (mine -> theirs):`, ...found.map((difference) => ` ${where(difference)}: ${Format.value(difference.mine)} -> ${Format.value(difference.theirs)}`)].join("\n")
82
99
  return Rendered.make(found, text)
83
100
  }
@@ -8,7 +8,12 @@
8
8
  * system or schedule marker after which the worlds differ. If that rerun
9
9
  * does not reproduce it, `after` is undefined: the original mismatch still
10
10
  * fails the check. This checks repeatability on the current JS engine, not
11
- * equality between platforms or every possible input sequence.
11
+ * equality between platforms (`Verify.acrossEngines` plays a replay in real
12
+ * browsers for that) or every possible input sequence.
13
+ *
14
+ * A difference inside an entity names it (`entity`), and with `labels` (the
15
+ * session's labels inspector) also its label, read on the first world at the
16
+ * differing frame.
12
17
  *
13
18
  * @example
14
19
  * ```ts
@@ -21,13 +26,21 @@
21
26
  * @docGroup devtools
22
27
  */
23
28
  import type { Debug, HostClock } from "@typeonce/ritmo"
29
+ import type * as Inspector from "@typeonce/ritmo/Inspector"
24
30
  import type { Schema } from "@typeonce/ritmo/Schema"
25
31
  import type { AnyScheduleOrder, ExecutableScheduleDefinition } from "@typeonce/ritmo/Schedule"
26
- import type { Target as SessionTarget } from "./Session.ts"
32
+ import type { LabelsInspector, Target as SessionTarget, ValidateLabels } from "./Session.ts"
27
33
 
28
34
  /** A fresh debug runtime, already set up, and its runnable schedules. */
29
- export interface Target<S extends Schema.Any, Root, Names extends string> {
30
- readonly runtime: Pick<SessionTarget<S, Root>, "debug" | "tryTick">
35
+ export interface Target<
36
+ S extends Schema.Any,
37
+ Root,
38
+ Names extends string,
39
+ Services extends Record<string, unknown> = Record<string, unknown>,
40
+ Resources extends object = object,
41
+ Machines extends Record<string, unknown> = Record<string, unknown>
42
+ > {
43
+ readonly runtime: SessionTarget<S, Root, Services, Resources, Machines>
31
44
  readonly schedules: Readonly<Record<Names, ExecutableScheduleDefinition<S, any, Root, any, any, AnyScheduleOrder>>>
32
45
  }
33
46
 
@@ -37,9 +50,11 @@ export interface Context {
37
50
  }
38
51
 
39
52
  /** Selects one schedule and a finite, whole number of frames to compare. */
40
- export interface Options<Names extends string> extends Context {
53
+ export interface Options<Names extends string, Labels extends LabelsInspector = never> extends Context {
41
54
  readonly schedule: Names
42
55
  readonly frames: number
56
+ /** Names the differing entity (`label`): the `labels` inspector a `Session` takes. */
57
+ readonly labels?: Labels
43
58
  }
44
59
 
45
60
  /** A mismatch names the first value; execution errors remain explicit failures. */
@@ -54,6 +69,10 @@ export type CheckResult =
54
69
  readonly first: unknown
55
70
  readonly second: unknown
56
71
  readonly after: string | undefined
72
+ /** The id of the entity the difference is in, when it is in one. */
73
+ readonly entity: number | undefined
74
+ /** That entity's label from `labels`, when it has one. */
75
+ readonly label: string | undefined
57
76
  }
58
77
  | {
59
78
  readonly ok: false
@@ -111,9 +130,17 @@ const difference = (first: Captured, second: Captured, path = "world"): Differen
111
130
  * equals NaN). Maps and sets include iteration order. Functions compare by
112
131
  * identity; weak collections and promises fail explicitly as uninspectable.
113
132
  */
114
- export const check = <S extends Schema.Any, Root, const Names extends string>(
115
- make: (context: Context) => Target<S, Root, Names>,
116
- options: Options<NoInfer<Names>>
133
+ export const check = <
134
+ S extends Schema.Any,
135
+ Root,
136
+ const Names extends string,
137
+ Services extends Record<string, unknown>,
138
+ Resources extends object,
139
+ Machines extends Record<string, unknown>,
140
+ const Labels extends LabelsInspector<Root> = never
141
+ >(
142
+ make: (context: Context) => Target<S, Root, Names, Services, Resources, Machines>,
143
+ options: Options<NoInfer<Names>, Labels> & ValidateLabels<Labels, Services, Resources, Machines>
117
144
  ): CheckResult => {
118
145
  if (!Number.isSafeInteger(options.frames) || options.frames < 0) {
119
146
  return { ok: false, frame: 0, reason: "invalid-options", run: "first", error: "frames must be a finite whole number, 0 or more" }
@@ -138,17 +165,25 @@ export const check = <S extends Schema.Any, Root, const Names extends string>(
138
165
  if (!result.ok) return { ok: false, frame, reason: "failure", run, error: result.error }
139
166
  }
140
167
  run = "first"
141
- const left = capture(first.runtime.debug.dump())
168
+ const leftDump = first.runtime.debug.dump()
169
+ const left = capture(leftDump)
142
170
  if (frame > 0) {
143
171
  run = "second"
144
172
  const result = second.runtime.tryTick(b)
145
173
  if (!result.ok) return { ok: false, frame, reason: "failure", run, error: result.error }
146
174
  }
147
175
  run = "second"
148
- const found = difference(left, capture(second.runtime.debug.dump()))
176
+ const rightDump = second.runtime.debug.dump()
177
+ const found = difference(left, capture(rightDump))
149
178
  if (found !== undefined) {
179
+ const index = /^world\["entities"\]\["(\d+)"\]/.exec(found.path)?.[1]
180
+ const entity = index === undefined ? undefined : (leftDump.entities[Number(index)] ?? rightDump.entities[Number(index)])?.id
181
+ const labels = options.labels as LabelsInspector | undefined
182
+ const label = entity === undefined || labels === undefined
183
+ ? undefined
184
+ : (first.runtime.inspect as (inspector: Inspector.Inspector.Any) => ReadonlyMap<number, string>)(labels).get(entity)
150
185
  const after = frame === 0 ? undefined : locate(make, context, options.schedule, frame)
151
- return { ok: false, frame, reason: "difference", difference: found.path, first: found.first, second: found.second, after }
186
+ return { ok: false, frame, reason: "difference", difference: found.path, first: found.first, second: found.second, after, entity, label }
152
187
  }
153
188
  }
154
189
  return { ok: true, frames: options.frames }