@scratch/scratch-vm 11.0.0-beta.1

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 (175) hide show
  1. package/.jsdoc.json +20 -0
  2. package/.nvmrc +1 -0
  3. package/CHANGELOG.md +7004 -0
  4. package/LICENSE +12 -0
  5. package/README.md +120 -0
  6. package/TRADEMARK +1 -0
  7. package/commitlint.config.js +4 -0
  8. package/docs/extensions.md +527 -0
  9. package/package.json +103 -0
  10. package/release.config.js +13 -0
  11. package/src/blocks/scratch3_control.js +206 -0
  12. package/src/blocks/scratch3_core_example.js +69 -0
  13. package/src/blocks/scratch3_data.js +257 -0
  14. package/src/blocks/scratch3_event.js +137 -0
  15. package/src/blocks/scratch3_looks.js +612 -0
  16. package/src/blocks/scratch3_motion.js +288 -0
  17. package/src/blocks/scratch3_operators.js +154 -0
  18. package/src/blocks/scratch3_procedures.js +79 -0
  19. package/src/blocks/scratch3_sensing.js +336 -0
  20. package/src/blocks/scratch3_sound.js +350 -0
  21. package/src/dispatch/central-dispatch.js +143 -0
  22. package/src/dispatch/shared-dispatch.js +235 -0
  23. package/src/dispatch/worker-dispatch.js +110 -0
  24. package/src/engine/adapter.js +176 -0
  25. package/src/engine/block-utility.js +242 -0
  26. package/src/engine/blocks-execute-cache.js +19 -0
  27. package/src/engine/blocks-runtime-cache.js +78 -0
  28. package/src/engine/blocks.js +1299 -0
  29. package/src/engine/comment.js +56 -0
  30. package/src/engine/execute.js +580 -0
  31. package/src/engine/monitor-record.js +23 -0
  32. package/src/engine/mutation-adapter.js +48 -0
  33. package/src/engine/profiler.js +390 -0
  34. package/src/engine/runtime.js +2686 -0
  35. package/src/engine/scratch-blocks-constants.js +27 -0
  36. package/src/engine/sequencer.js +361 -0
  37. package/src/engine/stage-layering.js +29 -0
  38. package/src/engine/target.js +799 -0
  39. package/src/engine/thread.js +404 -0
  40. package/src/engine/variable.js +70 -0
  41. package/src/extension-support/argument-type.js +47 -0
  42. package/src/extension-support/block-type.js +50 -0
  43. package/src/extension-support/define-messages.js +18 -0
  44. package/src/extension-support/extension-manager.js +440 -0
  45. package/src/extension-support/extension-metadata.js +64 -0
  46. package/src/extension-support/extension-worker.js +59 -0
  47. package/src/extension-support/reporter-scope.js +18 -0
  48. package/src/extension-support/target-type.js +17 -0
  49. package/src/extensions/scratch3_boost/index.js +2113 -0
  50. package/src/extensions/scratch3_ev3/index.js +1355 -0
  51. package/src/extensions/scratch3_gdx_for/index.js +981 -0
  52. package/src/extensions/scratch3_gdx_for/scratch-link-device-adapter.js +44 -0
  53. package/src/extensions/scratch3_makeymakey/index.js +396 -0
  54. package/src/extensions/scratch3_microbit/index.js +984 -0
  55. package/src/extensions/scratch3_music/assets/drums/1-snare.mp3 +0 -0
  56. package/src/extensions/scratch3_music/assets/drums/10-wood-block.mp3 +0 -0
  57. package/src/extensions/scratch3_music/assets/drums/11-cowbell.mp3 +0 -0
  58. package/src/extensions/scratch3_music/assets/drums/12-triangle.mp3 +0 -0
  59. package/src/extensions/scratch3_music/assets/drums/13-bongo.mp3 +0 -0
  60. package/src/extensions/scratch3_music/assets/drums/14-conga.mp3 +0 -0
  61. package/src/extensions/scratch3_music/assets/drums/15-cabasa.mp3 +0 -0
  62. package/src/extensions/scratch3_music/assets/drums/16-guiro.mp3 +0 -0
  63. package/src/extensions/scratch3_music/assets/drums/17-vibraslap.mp3 +0 -0
  64. package/src/extensions/scratch3_music/assets/drums/18-cuica.mp3 +0 -0
  65. package/src/extensions/scratch3_music/assets/drums/2-bass-drum.mp3 +0 -0
  66. package/src/extensions/scratch3_music/assets/drums/3-side-stick.mp3 +0 -0
  67. package/src/extensions/scratch3_music/assets/drums/4-crash-cymbal.mp3 +0 -0
  68. package/src/extensions/scratch3_music/assets/drums/5-open-hi-hat.mp3 +0 -0
  69. package/src/extensions/scratch3_music/assets/drums/6-closed-hi-hat.mp3 +0 -0
  70. package/src/extensions/scratch3_music/assets/drums/7-tambourine.mp3 +0 -0
  71. package/src/extensions/scratch3_music/assets/drums/8-hand-clap.mp3 +0 -0
  72. package/src/extensions/scratch3_music/assets/drums/9-claves.mp3 +0 -0
  73. package/src/extensions/scratch3_music/assets/instruments/1-piano/108.mp3 +0 -0
  74. package/src/extensions/scratch3_music/assets/instruments/1-piano/24.mp3 +0 -0
  75. package/src/extensions/scratch3_music/assets/instruments/1-piano/36.mp3 +0 -0
  76. package/src/extensions/scratch3_music/assets/instruments/1-piano/48.mp3 +0 -0
  77. package/src/extensions/scratch3_music/assets/instruments/1-piano/60.mp3 +0 -0
  78. package/src/extensions/scratch3_music/assets/instruments/1-piano/72.mp3 +0 -0
  79. package/src/extensions/scratch3_music/assets/instruments/1-piano/84.mp3 +0 -0
  80. package/src/extensions/scratch3_music/assets/instruments/1-piano/96.mp3 +0 -0
  81. package/src/extensions/scratch3_music/assets/instruments/10-clarinet/48.mp3 +0 -0
  82. package/src/extensions/scratch3_music/assets/instruments/10-clarinet/60.mp3 +0 -0
  83. package/src/extensions/scratch3_music/assets/instruments/11-saxophone/36.mp3 +0 -0
  84. package/src/extensions/scratch3_music/assets/instruments/11-saxophone/60.mp3 +0 -0
  85. package/src/extensions/scratch3_music/assets/instruments/11-saxophone/84.mp3 +0 -0
  86. package/src/extensions/scratch3_music/assets/instruments/12-flute/60.mp3 +0 -0
  87. package/src/extensions/scratch3_music/assets/instruments/12-flute/72.mp3 +0 -0
  88. package/src/extensions/scratch3_music/assets/instruments/13-wooden-flute/60.mp3 +0 -0
  89. package/src/extensions/scratch3_music/assets/instruments/13-wooden-flute/72.mp3 +0 -0
  90. package/src/extensions/scratch3_music/assets/instruments/14-bassoon/36.mp3 +0 -0
  91. package/src/extensions/scratch3_music/assets/instruments/14-bassoon/48.mp3 +0 -0
  92. package/src/extensions/scratch3_music/assets/instruments/14-bassoon/60.mp3 +0 -0
  93. package/src/extensions/scratch3_music/assets/instruments/15-choir/48.mp3 +0 -0
  94. package/src/extensions/scratch3_music/assets/instruments/15-choir/60.mp3 +0 -0
  95. package/src/extensions/scratch3_music/assets/instruments/15-choir/72.mp3 +0 -0
  96. package/src/extensions/scratch3_music/assets/instruments/16-vibraphone/60.mp3 +0 -0
  97. package/src/extensions/scratch3_music/assets/instruments/16-vibraphone/72.mp3 +0 -0
  98. package/src/extensions/scratch3_music/assets/instruments/17-music-box/60.mp3 +0 -0
  99. package/src/extensions/scratch3_music/assets/instruments/18-steel-drum/60.mp3 +0 -0
  100. package/src/extensions/scratch3_music/assets/instruments/19-marimba/60.mp3 +0 -0
  101. package/src/extensions/scratch3_music/assets/instruments/2-electric-piano/60.mp3 +0 -0
  102. package/src/extensions/scratch3_music/assets/instruments/20-synth-lead/60.mp3 +0 -0
  103. package/src/extensions/scratch3_music/assets/instruments/21-synth-pad/60.mp3 +0 -0
  104. package/src/extensions/scratch3_music/assets/instruments/3-organ/60.mp3 +0 -0
  105. package/src/extensions/scratch3_music/assets/instruments/4-guitar/60.mp3 +0 -0
  106. package/src/extensions/scratch3_music/assets/instruments/5-electric-guitar/60.mp3 +0 -0
  107. package/src/extensions/scratch3_music/assets/instruments/6-bass/36.mp3 +0 -0
  108. package/src/extensions/scratch3_music/assets/instruments/6-bass/48.mp3 +0 -0
  109. package/src/extensions/scratch3_music/assets/instruments/7-pizzicato/60.mp3 +0 -0
  110. package/src/extensions/scratch3_music/assets/instruments/8-cello/36.mp3 +0 -0
  111. package/src/extensions/scratch3_music/assets/instruments/8-cello/48.mp3 +0 -0
  112. package/src/extensions/scratch3_music/assets/instruments/8-cello/60.mp3 +0 -0
  113. package/src/extensions/scratch3_music/assets/instruments/9-trombone/36.mp3 +0 -0
  114. package/src/extensions/scratch3_music/assets/instruments/9-trombone/48.mp3 +0 -0
  115. package/src/extensions/scratch3_music/assets/instruments/9-trombone/60.mp3 +0 -0
  116. package/src/extensions/scratch3_music/index.js +1333 -0
  117. package/src/extensions/scratch3_music/manifest.js +63 -0
  118. package/src/extensions/scratch3_pen/index.js +770 -0
  119. package/src/extensions/scratch3_speech2text/index.js +700 -0
  120. package/src/extensions/scratch3_text2speech/index.js +766 -0
  121. package/src/extensions/scratch3_translate/index.js +286 -0
  122. package/src/extensions/scratch3_video_sensing/debug.js +13 -0
  123. package/src/extensions/scratch3_video_sensing/index.js +594 -0
  124. package/src/extensions/scratch3_video_sensing/library.js +384 -0
  125. package/src/extensions/scratch3_video_sensing/math.js +76 -0
  126. package/src/extensions/scratch3_video_sensing/view.js +509 -0
  127. package/src/extensions/scratch3_wedo2/index.js +1616 -0
  128. package/src/import/load-costume.js +416 -0
  129. package/src/import/load-sound.js +116 -0
  130. package/src/index.js +10 -0
  131. package/src/io/ble.js +256 -0
  132. package/src/io/bt.js +202 -0
  133. package/src/io/clock.js +39 -0
  134. package/src/io/cloud.js +169 -0
  135. package/src/io/keyboard.js +146 -0
  136. package/src/io/mouse.js +145 -0
  137. package/src/io/mouseWheel.js +28 -0
  138. package/src/io/userData.js +24 -0
  139. package/src/io/video.js +210 -0
  140. package/src/playground/benchmark.css +83 -0
  141. package/src/playground/benchmark.js +753 -0
  142. package/src/playground/index.html +111 -0
  143. package/src/playground/suite.css +78 -0
  144. package/src/playground/suite.html +25 -0
  145. package/src/playground/suite.js +544 -0
  146. package/src/playground/video-sensing.html +18 -0
  147. package/src/playground/video-sensing.js +133 -0
  148. package/src/serialization/deserialize-assets.js +178 -0
  149. package/src/serialization/sb2.js +1295 -0
  150. package/src/serialization/sb2_specmap.js +1818 -0
  151. package/src/serialization/sb3.js +1320 -0
  152. package/src/serialization/serialize-assets.js +60 -0
  153. package/src/sprites/rendered-target.js +1115 -0
  154. package/src/sprites/sprite.js +177 -0
  155. package/src/util/base64-util.js +48 -0
  156. package/src/util/cast.js +218 -0
  157. package/src/util/clone.js +17 -0
  158. package/src/util/color.js +204 -0
  159. package/src/util/fetch-with-timeout.js +53 -0
  160. package/src/util/get-monitor-id.js +33 -0
  161. package/src/util/jsonrpc.js +114 -0
  162. package/src/util/log.js +4 -0
  163. package/src/util/math-util.js +122 -0
  164. package/src/util/maybe-format-message.js +18 -0
  165. package/src/util/new-block-ids.js +33 -0
  166. package/src/util/rateLimiter.js +73 -0
  167. package/src/util/scratch-link-websocket.js +133 -0
  168. package/src/util/string-util.js +94 -0
  169. package/src/util/task-queue.js +203 -0
  170. package/src/util/timer.js +103 -0
  171. package/src/util/uid.js +29 -0
  172. package/src/util/variable-util.js +48 -0
  173. package/src/util/xml-escape.js +33 -0
  174. package/src/virtual-machine.js +1586 -0
  175. package/webpack.config.js +134 -0
package/src/playground/index.html ADDED
@@ -0,0 +1,111 @@
1
+ <!doctype html>
2
+
3
+ <html lang="en">
4
+ <head>
5
+ <meta charset="utf-8">
6
+ <title>Scratch VM Benchmark</title>
7
+ <link rel="stylesheet" href="./benchmark.css" type="text/css" media="screen">
8
+ <script>
9
+ // Track loading time with timestamps and if possible the performance
10
+ // api.
11
+
12
+ // Start tracking loading of Scratch before the body dom is evaluated.
13
+ window.ScratchVMLoadStart = Date.now();
14
+ if (window.performance) {
15
+ // Mark for browser performance inspectors and if we want to use
16
+ // other performance apis.
17
+ performance.mark('Scratch.LoadStart');
18
+ }
19
+ </script>
20
+ </head>
21
+ <body>
22
+ <h2>Scratch VM Benchmark</h2>
23
+ <p class="description">
24
+ Welcome to the scratch-vm benchmark. This tool helps you profile a scratch
25
+ project. When you load the page, it:
26
+ <ol class="description">
27
+ <li>loads the default project and enables turbo mode
28
+ <li>runs the project for 4 seconds to warm up
29
+ <li>profiles for 6 seconds
30
+ <li>stops and reports
31
+ </ol>
32
+ </p>
33
+ <div class="run-form">
34
+ <input type="text" value="119615668">
35
+ <button class="run">run</button>
36
+ </div>
37
+ <p class="run-push">
38
+ <i>Try a different project, like `130041250`</i>
39
+ </p>
40
+
41
+ <canvas id="scratch-stage"></canvas><br />
42
+
43
+ <div class="layer">
44
+ <div class="loading">
45
+ <label>Loading Data:</label>
46
+ <span class="loading-complete">0</span> / <span class="loading-total">0</span> <span class="loading-time">(--ms)</span>
47
+ </div>
48
+ <div class="loading">
49
+ <label>Loading Content:</label>
50
+ <span class="loading-content-complete">0</span> / <span class="loading-content-total">0</span> <span class="loading-content-time">(--ms)</span>
51
+ </div>
52
+ <div class="loading">
53
+ <label>Hydrating:</label>
54
+ <span class="loading-hydrate-complete">0</span> / <span class="loading-hydrate-total">0</span> <span class="loading-hydrate-time">(--ms)</span>
55
+ </div>
56
+ <div class="loading">
57
+ <label>Memory:</label>
58
+ <span class="loading-memory-current">--</span> / <span class="loading-memory-peak">--</span>
59
+ </div>
60
+ <div class="profile-count-group">
61
+ <div class="profile-count">
62
+ <label>Percent of time worked:</label>
63
+ <span class="profile-count-value profile-count-amount-recorded">...</span>
64
+ </div>
65
+ <div class="profile-count">
66
+ <label>Steps looped:</label>
67
+ <span class="profile-count-value profile-count-steps-looped">...</span>
68
+ </div>
69
+ <div class="profile-count">
70
+ <label>Blocks executed:</label>
71
+ <span class="profile-count-value profile-count-blocks-executed">...</span>
72
+ </div>
73
+ <a class="share"><div class="profile-count">
74
+ <label>Share this report</label>
75
+ </div></a>
76
+ <a class="share" target="_parent">
77
+ <div class="profile-count">
78
+ <label>Run the full suite</label>
79
+ </div>
80
+ </a>
81
+ </div>
82
+ </div>
83
+
84
+ <div class="profile-tables">
85
+ <table class="profile-count-frame-table" cellspacing="0">
86
+ <thead>
87
+ <tr class="profile-count-frame-head"><th>Frame</th><th>Self Time</th><th>Total Time</th><th>Executions</th></tr>
88
+ </thead>
89
+ <tbody>
90
+ <tr class="profiler-count-running"><td colspan="4"></td></tr>
91
+ </tbody>
92
+ </table>
93
+
94
+ <table class="profile-count-opcode-table" cellspacing="0">
95
+ <thead>
96
+ <tr class="profile-count-opcode-head">
97
+ <th>opcode</th><th>Self Time</th><th>Total Time</th><th>Executions</th>
98
+ </tr>
99
+ </thead>
100
+ <tbody>
101
+ <tr class="profiler-count-running"><td colspan="4"></td></tr>
102
+ </tbody>
103
+ </table>
104
+ </div>
105
+
106
+ <div id="blocks"></div>
107
+
108
+ <!-- Playground -->
109
+ <script src="./benchmark.js"></script>
110
+ </body>
111
+ </html>
package/src/playground/suite.css ADDED
@@ -0,0 +1,78 @@
1
+ html, body {
2
+ width: 100%;
3
+ height: 100%;
4
+ margin: 0;
5
+ overflow: hidden;
6
+ }
7
+
8
+ iframe {
9
+ border: none;
10
+ }
11
+
12
+ .runner-controls {
13
+ position: absolute;
14
+ width: 30em;
15
+ height: 100%;
16
+ left: 0;
17
+ right: 30em;
18
+ top: 0;
19
+ bottom: 0;
20
+ overflow: scroll;
21
+ padding: 1em;
22
+ padding-top: 0;
23
+ box-sizing: border-box;
24
+ }
25
+
26
+ .bench-frame-owner {
27
+ position: absolute;
28
+ width: calc(100% - 30em);
29
+ height: 100%;
30
+ left: 30em;
31
+ right: 100%;
32
+ top: 0;
33
+ bottom: 0;
34
+ }
35
+
36
+ .controls {
37
+ margin-bottom: 1em;
38
+ }
39
+
40
+ .legend {
41
+ margin: 1em 0;
42
+ }
43
+
44
+ .result-view {
45
+ border-bottom: 1px solid #ccc;
46
+ border-spacing: 0;
47
+ border-collapse: collapse;
48
+ padding: 5px;
49
+ }
50
+
51
+ .fixture-project {
52
+ display: inline-block;
53
+ clear: both;
54
+ }
55
+
56
+ .fixture-warm-up {
57
+ display: inline-block;
58
+ }
59
+
60
+ .fixture-recording {
61
+ display: inline-block;
62
+ }
63
+
64
+ .result-view.resume {
65
+ cursor: pointer;
66
+ }
67
+
68
+ .result-status {
69
+ float: right;
70
+ text-align: right;
71
+ margin-left: 0.3em;
72
+ }
73
+
74
+ .compare-file {
75
+ cursor: pointer;
76
+ visibility: hidden;
77
+ width: 0;
78
+ }
package/src/playground/suite.html ADDED
@@ -0,0 +1,25 @@
1
+ <!doctype html>
2
+
3
+ <html lang="en">
4
+ <head>
5
+ <meta charset="utf-8">
6
+ <title>Scratch VM Benchmark Suite</title>
7
+ <link rel="stylesheet" href="./suite.css" type="text/css" media="screen">
8
+ </head>
9
+ <body>
10
+ <div class="runner-controls">
11
+ <h2>Scratch VM Benchmark Suite</h2>
12
+ <div class="suite-results">
13
+
14
+ </div>
15
+ </div>
16
+
17
+ <div class="bench-frame-owner">
18
+ <iframe id="bench_frame" name="bench_frame" src="" class="bench-frame"
19
+ width="100%" height="100%"></iframe>
20
+ </div>
21
+
22
+ <!-- BenchRunner -->
23
+ <script src="./suite.js" type="text/javascript" charset="utf-8"></script>
24
+ </body>
25
+ </html>