@scratch/scratch-vm 11.0.0-UEPR-176

package/src/serialization/sb2_specmap.js

@@ -0,0 +1,1818 @@
+/**
+ * @fileoverview
+ * The specMap below handles a few pieces of "translation" work between
+ * the SB2 JSON format and the data we need to run a project
+ * in the Scratch 3.0 VM.
+ * Notably:
+ *  - Map 2.0 and 1.4 opcodes (forward:) into 3.0-format (motion_movesteps).
+ *  - Map ordered, unnamed args to unordered, named inputs and fields.
+ * Keep this up-to-date as 3.0 blocks are renamed, changed, etc.
+ * Originally this was generated largely by a hand-guided scripting process.
+ * The relevant data lives here:
+ * https://github.com/scratchfoundation/scratch-flash/blob/master/src/Specs.as
+ * (for the old opcode and argument order).
+ * and here:
+ * https://github.com/scratchfoundation/scratch-blocks/tree/develop/blocks_vertical
+ * (for the new opcodes and argument names).
+ * and here:
+ * https://github.com/scratchfoundation/scratch-blocks/blob/develop/tests/
+ * (for the shadow blocks created for each block).
+ * I started with the `commands` array in Specs.as, and discarded irrelevant
+ * properties. By hand, I matched the opcode name to the 3.0 opcode.
+ * Finally, I filled in the expected arguments as below.
+ */
+
+const Variable = require('../engine/variable');
+
+/**
+ * @typedef {object} SB2SpecMap_blockInfo
+ * @property {string} opcode - the Scratch 3.0 block opcode. Use 'extensionID.opcode' for extension opcodes.
+ * @property {Array.<SB2SpecMap_argInfo>} argMap - metadata for this block's arguments.
+ */
+
+/**
+ * @typedef {object} SB2SpecMap_argInfo
+ * @property {string} type - the type of this arg (such as 'input' or 'field')
+ * @property {string} inputOp - the scratch-blocks shadow type for this arg
+ * @property {string} inputName - the name this argument will take when provided to the block implementation
+ */
+
+/**
+ * Mapping of Scratch 2.0 opcode to Scratch 3.0 block metadata.
+ * @type {object.<SB2SpecMap_blockInfo>}
+ */
+const specMap = {
+    'forward:': {
+        opcode: 'motion_movesteps',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'STEPS'
+            }
+        ]
+    },
+    'turnRight:': {
+        opcode: 'motion_turnright',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'DEGREES'
+            }
+        ]
+    },
+    'turnLeft:': {
+        opcode: 'motion_turnleft',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'DEGREES'
+            }
+        ]
+    },
+    'heading:': {
+        opcode: 'motion_pointindirection',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_angle',
+                inputName: 'DIRECTION'
+            }
+        ]
+    },
+    'pointTowards:': {
+        opcode: 'motion_pointtowards',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'motion_pointtowards_menu',
+                inputName: 'TOWARDS'
+            }
+        ]
+    },
+    'gotoX:y:': {
+        opcode: 'motion_gotoxy',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'X'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'Y'
+            }
+        ]
+    },
+    'gotoSpriteOrMouse:': {
+        opcode: 'motion_goto',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'motion_goto_menu',
+                inputName: 'TO'
+            }
+        ]
+    },
+    'glideSecs:toX:y:elapsed:from:': {
+        opcode: 'motion_glidesecstoxy',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'SECS'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'X'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'Y'
+            }
+        ]
+    },
+    'changeXposBy:': {
+        opcode: 'motion_changexby',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'DX'
+            }
+        ]
+    },
+    'xpos:': {
+        opcode: 'motion_setx',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'X'
+            }
+        ]
+    },
+    'changeYposBy:': {
+        opcode: 'motion_changeyby',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'DY'
+            }
+        ]
+    },
+    'ypos:': {
+        opcode: 'motion_sety',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'Y'
+            }
+        ]
+    },
+    'bounceOffEdge': {
+        opcode: 'motion_ifonedgebounce',
+        argMap: [
+        ]
+    },
+    'setRotationStyle': {
+        opcode: 'motion_setrotationstyle',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'STYLE'
+            }
+        ]
+    },
+    'xpos': {
+        opcode: 'motion_xposition',
+        argMap: [
+        ]
+    },
+    'ypos': {
+        opcode: 'motion_yposition',
+        argMap: [
+        ]
+    },
+    'heading': {
+        opcode: 'motion_direction',
+        argMap: [
+        ]
+    },
+    'scrollRight': {
+        opcode: 'motion_scroll_right',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'DISTANCE'
+            }
+        ]
+    },
+    'scrollUp': {
+        opcode: 'motion_scroll_up',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'DISTANCE'
+            }
+        ]
+    },
+    'scrollAlign': {
+        opcode: 'motion_align_scene',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'ALIGNMENT'
+            }
+        ]
+    },
+    'xScroll': {
+        opcode: 'motion_xscroll',
+        argMap: [
+        ]
+    },
+    'yScroll': {
+        opcode: 'motion_yscroll',
+        argMap: [
+        ]
+    },
+    'say:duration:elapsed:from:': {
+        opcode: 'looks_sayforsecs',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'MESSAGE'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'SECS'
+            }
+        ]
+    },
+    'say:': {
+        opcode: 'looks_say',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'MESSAGE'
+            }
+        ]
+    },
+    'think:duration:elapsed:from:': {
+        opcode: 'looks_thinkforsecs',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'MESSAGE'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'SECS'
+            }
+        ]
+    },
+    'think:': {
+        opcode: 'looks_think',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'MESSAGE'
+            }
+        ]
+    },
+    'show': {
+        opcode: 'looks_show',
+        argMap: [
+        ]
+    },
+    'hide': {
+        opcode: 'looks_hide',
+        argMap: [
+        ]
+    },
+    'hideAll': {
+        opcode: 'looks_hideallsprites',
+        argMap: [
+        ]
+    },
+    'lookLike:': {
+        opcode: 'looks_switchcostumeto',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'looks_costume',
+                inputName: 'COSTUME'
+            }
+        ]
+    },
+    'nextCostume': {
+        opcode: 'looks_nextcostume',
+        argMap: [
+        ]
+    },
+    'startScene': {
+        opcode: 'looks_switchbackdropto',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'looks_backdrops',
+                inputName: 'BACKDROP'
+            }
+        ]
+    },
+    'changeGraphicEffect:by:': {
+        opcode: 'looks_changeeffectby',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'EFFECT'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'CHANGE'
+            }
+        ]
+    },
+    'setGraphicEffect:to:': {
+        opcode: 'looks_seteffectto',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'EFFECT'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'VALUE'
+            }
+        ]
+    },
+    'filterReset': {
+        opcode: 'looks_cleargraphiceffects',
+        argMap: [
+        ]
+    },
+    'changeSizeBy:': {
+        opcode: 'looks_changesizeby',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'CHANGE'
+            }
+        ]
+    },
+    'setSizeTo:': {
+        opcode: 'looks_setsizeto',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'SIZE'
+            }
+        ]
+    },
+    'changeStretchBy:': {
+        opcode: 'looks_changestretchby',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'CHANGE'
+            }
+        ]
+    },
+    'setStretchTo:': {
+        opcode: 'looks_setstretchto',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'STRETCH'
+            }
+        ]
+    },
+    'comeToFront': {
+        opcode: 'looks_gotofrontback',
+        argMap: [
+        ]
+    },
+    'goBackByLayers:': {
+        opcode: 'looks_goforwardbackwardlayers',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_integer',
+                inputName: 'NUM'
+            }
+        ]
+    },
+    'costumeIndex': {
+        opcode: 'looks_costumenumbername',
+        argMap: [
+        ]
+    },
+    'costumeName': {
+        opcode: 'looks_costumenumbername',
+        argMap: [
+        ]
+    },
+    'sceneName': {
+        opcode: 'looks_backdropnumbername',
+        argMap: [
+        ]
+    },
+    'scale': {
+        opcode: 'looks_size',
+        argMap: [
+        ]
+    },
+    'startSceneAndWait': {
+        opcode: 'looks_switchbackdroptoandwait',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'looks_backdrops',
+                inputName: 'BACKDROP'
+            }
+        ]
+    },
+    'nextScene': {
+        opcode: 'looks_nextbackdrop',
+        argMap: [
+        ]
+    },
+    'backgroundIndex': {
+        opcode: 'looks_backdropnumbername',
+        argMap: [
+        ]
+    },
+    'playSound:': {
+        opcode: 'sound_play',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'sound_sounds_menu',
+                inputName: 'SOUND_MENU'
+            }
+        ]
+    },
+    'doPlaySoundAndWait': {
+        opcode: 'sound_playuntildone',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'sound_sounds_menu',
+                inputName: 'SOUND_MENU'
+            }
+        ]
+    },
+    'stopAllSounds': {
+        opcode: 'sound_stopallsounds',
+        argMap: [
+        ]
+    },
+    'playDrum': {
+        opcode: 'music_playDrumForBeats',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'music_menu_DRUM',
+                inputName: 'DRUM'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'BEATS'
+            }
+        ]
+    },
+    'drum:duration:elapsed:from:': {
+        opcode: 'music_midiPlayDrumForBeats',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'DRUM'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'BEATS'
+            }
+        ]
+    },
+    'rest:elapsed:from:': {
+        opcode: 'music_restForBeats',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'BEATS'
+            }
+        ]
+    },
+    'noteOn:duration:elapsed:from:': {
+        opcode: 'music_playNoteForBeats',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'note',
+                inputName: 'NOTE'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'BEATS'
+            }
+        ]
+    },
+    'instrument:': {
+        opcode: 'music_setInstrument',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'music_menu_INSTRUMENT',
+                inputName: 'INSTRUMENT'
+            }
+        ]
+    },
+    'midiInstrument:': {
+        opcode: 'music_midiSetInstrument',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'INSTRUMENT'
+            }
+        ]
+    },
+    'changeVolumeBy:': {
+        opcode: 'sound_changevolumeby',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'VOLUME'
+            }
+        ]
+    },
+    'setVolumeTo:': {
+        opcode: 'sound_setvolumeto',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'VOLUME'
+            }
+        ]
+    },
+    'volume': {
+        opcode: 'sound_volume',
+        argMap: [
+        ]
+    },
+    'changeTempoBy:': {
+        opcode: 'music_changeTempo',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'TEMPO'
+            }
+        ]
+    },
+    'setTempoTo:': {
+        opcode: 'music_setTempo',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'TEMPO'
+            }
+        ]
+    },
+    'tempo': {
+        opcode: 'music_getTempo',
+        argMap: [
+        ]
+    },
+    'clearPenTrails': {
+        opcode: 'pen_clear',
+        argMap: [
+        ]
+    },
+    'stampCostume': {
+        opcode: 'pen_stamp',
+        argMap: [
+        ]
+    },
+    'putPenDown': {
+        opcode: 'pen_penDown',
+        argMap: [
+        ]
+    },
+    'putPenUp': {
+        opcode: 'pen_penUp',
+        argMap: [
+        ]
+    },
+    'penColor:': {
+        opcode: 'pen_setPenColorToColor',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'colour_picker',
+                inputName: 'COLOR'
+            }
+        ]
+    },
+    'changePenHueBy:': {
+        opcode: 'pen_changePenHueBy',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'HUE'
+            }
+        ]
+    },
+    'setPenHueTo:': {
+        opcode: 'pen_setPenHueToNumber',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'HUE'
+            }
+        ]
+    },
+    'changePenShadeBy:': {
+        opcode: 'pen_changePenShadeBy',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'SHADE'
+            }
+        ]
+    },
+    'setPenShadeTo:': {
+        opcode: 'pen_setPenShadeToNumber',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'SHADE'
+            }
+        ]
+    },
+    'changePenSizeBy:': {
+        opcode: 'pen_changePenSizeBy',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'SIZE'
+            }
+        ]
+    },
+    'penSize:': {
+        opcode: 'pen_setPenSizeTo',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'SIZE'
+            }
+        ]
+    },
+    'senseVideoMotion': {
+        opcode: 'videoSensing_videoOn',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'videoSensing_menu_ATTRIBUTE',
+                inputName: 'ATTRIBUTE'
+            },
+            {
+                type: 'input',
+                inputOp: 'videoSensing_menu_SUBJECT',
+                inputName: 'SUBJECT'
+            }
+        ]
+    },
+    'whenGreenFlag': {
+        opcode: 'event_whenflagclicked',
+        argMap: [
+        ]
+    },
+    'whenKeyPressed': {
+        opcode: 'event_whenkeypressed',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'KEY_OPTION'
+            }
+        ]
+    },
+    'whenClicked': {
+        opcode: 'event_whenthisspriteclicked',
+        argMap: [
+        ]
+    },
+    'whenSceneStarts': {
+        opcode: 'event_whenbackdropswitchesto',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'BACKDROP'
+            }
+        ]
+    },
+    'whenSensorGreaterThan': ([, sensor]) => {
+        if (sensor === 'video motion') {
+            return {
+                opcode: 'videoSensing_whenMotionGreaterThan',
+                argMap: [
+                    // skip the first arg, since we converted to a video specific sensing block
+                    {},
+                    {
+                        type: 'input',
+                        inputOp: 'math_number',
+                        inputName: 'REFERENCE'
+                    }
+                ]
+            };
+        }
+        return {
+            opcode: 'event_whengreaterthan',
+            argMap: [
+                {
+                    type: 'field',
+                    fieldName: 'WHENGREATERTHANMENU'
+                },
+                {
+                    type: 'input',
+                    inputOp: 'math_number',
+                    inputName: 'VALUE'
+                }
+            ]
+        };
+    },
+    'whenIReceive': {
+        opcode: 'event_whenbroadcastreceived',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'BROADCAST_OPTION',
+                variableType: Variable.BROADCAST_MESSAGE_TYPE
+            }
+        ]
+    },
+    'broadcast:': {
+        opcode: 'event_broadcast',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'event_broadcast_menu',
+                inputName: 'BROADCAST_INPUT',
+                variableType: Variable.BROADCAST_MESSAGE_TYPE
+            }
+        ]
+    },
+    'doBroadcastAndWait': {
+        opcode: 'event_broadcastandwait',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'event_broadcast_menu',
+                inputName: 'BROADCAST_INPUT',
+                variableType: Variable.BROADCAST_MESSAGE_TYPE
+            }
+        ]
+    },
+    'wait:elapsed:from:': {
+        opcode: 'control_wait',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_positive_number',
+                inputName: 'DURATION'
+            }
+        ]
+    },
+    'doRepeat': {
+        opcode: 'control_repeat',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_whole_number',
+                inputName: 'TIMES'
+            },
+            {
+                type: 'input',
+                inputOp: 'substack',
+                inputName: 'SUBSTACK'
+            }
+        ]
+    },
+    'doForever': {
+        opcode: 'control_forever',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'substack',
+                inputName: 'SUBSTACK'
+            }
+        ]
+    },
+    'doIf': {
+        opcode: 'control_if',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'CONDITION'
+            },
+            {
+                type: 'input',
+                inputOp: 'substack',
+                inputName: 'SUBSTACK'
+            }
+        ]
+    },
+    'doIfElse': {
+        opcode: 'control_if_else',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'CONDITION'
+            },
+            {
+                type: 'input',
+                inputOp: 'substack',
+                inputName: 'SUBSTACK'
+            },
+            {
+                type: 'input',
+                inputOp: 'substack',
+                inputName: 'SUBSTACK2'
+            }
+        ]
+    },
+    'doWaitUntil': {
+        opcode: 'control_wait_until',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'CONDITION'
+            }
+        ]
+    },
+    'doUntil': {
+        opcode: 'control_repeat_until',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'CONDITION'
+            },
+            {
+                type: 'input',
+                inputOp: 'substack',
+                inputName: 'SUBSTACK'
+            }
+        ]
+    },
+    'doWhile': {
+        opcode: 'control_while',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'CONDITION'
+            },
+            {
+                type: 'input',
+                inputOp: 'substack',
+                inputName: 'SUBSTACK'
+            }
+        ]
+    },
+    'doForLoop': {
+        opcode: 'control_for_each',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'VARIABLE'
+            },
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'VALUE'
+            },
+            {
+                type: 'input',
+                inputOp: 'substack',
+                inputName: 'SUBSTACK'
+            }
+        ]
+    },
+    'stopScripts': {
+        opcode: 'control_stop',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'STOP_OPTION'
+            }
+        ]
+    },
+    'whenCloned': {
+        opcode: 'control_start_as_clone',
+        argMap: [
+        ]
+    },
+    'createCloneOf': {
+        opcode: 'control_create_clone_of',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'control_create_clone_of_menu',
+                inputName: 'CLONE_OPTION'
+            }
+        ]
+    },
+    'deleteClone': {
+        opcode: 'control_delete_this_clone',
+        argMap: [
+        ]
+    },
+    'COUNT': {
+        opcode: 'control_get_counter',
+        argMap: [
+        ]
+    },
+    'INCR_COUNT': {
+        opcode: 'control_incr_counter',
+        argMap: [
+        ]
+    },
+    'CLR_COUNT': {
+        opcode: 'control_clear_counter',
+        argMap: [
+        ]
+    },
+    'warpSpeed': {
+        opcode: 'control_all_at_once',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'substack',
+                inputName: 'SUBSTACK'
+            }
+        ]
+    },
+    'touching:': {
+        opcode: 'sensing_touchingobject',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'sensing_touchingobjectmenu',
+                inputName: 'TOUCHINGOBJECTMENU'
+            }
+        ]
+    },
+    'touchingColor:': {
+        opcode: 'sensing_touchingcolor',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'colour_picker',
+                inputName: 'COLOR'
+            }
+        ]
+    },
+    'color:sees:': {
+        opcode: 'sensing_coloristouchingcolor',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'colour_picker',
+                inputName: 'COLOR'
+            },
+            {
+                type: 'input',
+                inputOp: 'colour_picker',
+                inputName: 'COLOR2'
+            }
+        ]
+    },
+    'distanceTo:': {
+        opcode: 'sensing_distanceto',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'sensing_distancetomenu',
+                inputName: 'DISTANCETOMENU'
+            }
+        ]
+    },
+    'doAsk': {
+        opcode: 'sensing_askandwait',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'QUESTION'
+            }
+        ]
+    },
+    'answer': {
+        opcode: 'sensing_answer',
+        argMap: [
+        ]
+    },
+    'keyPressed:': {
+        opcode: 'sensing_keypressed',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'sensing_keyoptions',
+                inputName: 'KEY_OPTION'
+            }
+        ]
+    },
+    'mousePressed': {
+        opcode: 'sensing_mousedown',
+        argMap: [
+        ]
+    },
+    'mouseX': {
+        opcode: 'sensing_mousex',
+        argMap: [
+        ]
+    },
+    'mouseY': {
+        opcode: 'sensing_mousey',
+        argMap: [
+        ]
+    },
+    'soundLevel': {
+        opcode: 'sensing_loudness',
+        argMap: [
+        ]
+    },
+    'isLoud': {
+        opcode: 'sensing_loud',
+        argMap: [
+        ]
+    },
+    // 'senseVideoMotion': {
+    //     opcode: 'sensing_videoon',
+    //     argMap: [
+    //         {
+    //             type: 'input',
+    //             inputOp: 'sensing_videoonmenuone',
+    //             inputName: 'VIDEOONMENU1'
+    //         },
+    //         {
+    //             type: 'input',
+    //             inputOp: 'sensing_videoonmenutwo',
+    //             inputName: 'VIDEOONMENU2'
+    //         }
+    //     ]
+    // },
+    'setVideoState': {
+        opcode: 'videoSensing_videoToggle',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'videoSensing_menu_VIDEO_STATE',
+                inputName: 'VIDEO_STATE'
+            }
+        ]
+    },
+    'setVideoTransparency': {
+        opcode: 'videoSensing_setVideoTransparency',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'TRANSPARENCY'
+            }
+        ]
+    },
+    'timer': {
+        opcode: 'sensing_timer',
+        argMap: [
+        ]
+    },
+    'timerReset': {
+        opcode: 'sensing_resettimer',
+        argMap: [
+        ]
+    },
+    'getAttribute:of:': {
+        opcode: 'sensing_of',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'PROPERTY'
+            },
+            {
+                type: 'input',
+                inputOp: 'sensing_of_object_menu',
+                inputName: 'OBJECT'
+            }
+        ]
+    },
+    'timeAndDate': {
+        opcode: 'sensing_current',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'CURRENTMENU'
+            }
+        ]
+    },
+    'timestamp': {
+        opcode: 'sensing_dayssince2000',
+        argMap: [
+        ]
+    },
+    'getUserName': {
+        opcode: 'sensing_username',
+        argMap: [
+        ]
+    },
+    'getUserId': {
+        opcode: 'sensing_userid',
+        argMap: [
+        ]
+    },
+    '+': {
+        opcode: 'operator_add',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM1'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM2'
+            }
+        ]
+    },
+    '-': {
+        opcode: 'operator_subtract',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM1'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM2'
+            }
+        ]
+    },
+    '*': {
+        opcode: 'operator_multiply',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM1'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM2'
+            }
+        ]
+    },
+    '/': {
+        opcode: 'operator_divide',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM1'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM2'
+            }
+        ]
+    },
+    'randomFrom:to:': {
+        opcode: 'operator_random',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'FROM'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'TO'
+            }
+        ]
+    },
+    '<': {
+        opcode: 'operator_lt',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'OPERAND1'
+            },
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'OPERAND2'
+            }
+        ]
+    },
+    '=': {
+        opcode: 'operator_equals',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'OPERAND1'
+            },
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'OPERAND2'
+            }
+        ]
+    },
+    '>': {
+        opcode: 'operator_gt',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'OPERAND1'
+            },
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'OPERAND2'
+            }
+        ]
+    },
+    '&': {
+        opcode: 'operator_and',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'OPERAND1'
+            },
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'OPERAND2'
+            }
+        ]
+    },
+    '|': {
+        opcode: 'operator_or',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'OPERAND1'
+            },
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'OPERAND2'
+            }
+        ]
+    },
+    'not': {
+        opcode: 'operator_not',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'boolean',
+                inputName: 'OPERAND'
+            }
+        ]
+    },
+    'concatenate:with:': {
+        opcode: 'operator_join',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'STRING1'
+            },
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'STRING2'
+            }
+        ]
+    },
+    'letter:of:': {
+        opcode: 'operator_letter_of',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_whole_number',
+                inputName: 'LETTER'
+            },
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'STRING'
+            }
+        ]
+    },
+    'stringLength:': {
+        opcode: 'operator_length',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'STRING'
+            }
+        ]
+    },
+    '%': {
+        opcode: 'operator_mod',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM1'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM2'
+            }
+        ]
+    },
+    'rounded': {
+        opcode: 'operator_round',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM'
+            }
+        ]
+    },
+    'computeFunction:of:': {
+        opcode: 'operator_mathop',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'OPERATOR'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'NUM'
+            }
+        ]
+    },
+    'readVariable': {
+        opcode: 'data_variable',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'VARIABLE',
+                variableType: Variable.SCALAR_TYPE
+            }
+        ]
+    },
+    // Scratch 2 uses this alternative variable getter opcode only in monitors,
+    // blocks use the `readVariable` opcode above.
+    'getVar:': {
+        opcode: 'data_variable',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'VARIABLE',
+                variableType: Variable.SCALAR_TYPE
+            }
+        ]
+    },
+    'setVar:to:': {
+        opcode: 'data_setvariableto',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'VARIABLE',
+                variableType: Variable.SCALAR_TYPE
+            },
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'VALUE'
+            }
+        ]
+    },
+    'changeVar:by:': {
+        opcode: 'data_changevariableby',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'VARIABLE',
+                variableType: Variable.SCALAR_TYPE
+            },
+            {
+                type: 'input',
+                inputOp: 'math_number',
+                inputName: 'VALUE'
+            }
+        ]
+    },
+    'showVariable:': {
+        opcode: 'data_showvariable',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'VARIABLE',
+                variableType: Variable.SCALAR_TYPE
+            }
+        ]
+    },
+    'hideVariable:': {
+        opcode: 'data_hidevariable',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'VARIABLE',
+                variableType: Variable.SCALAR_TYPE
+            }
+        ]
+    },
+    'contentsOfList:': {
+        opcode: 'data_listcontents',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            }
+        ]
+    },
+    'append:toList:': {
+        opcode: 'data_addtolist',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'ITEM'
+            },
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            }
+        ]
+    },
+    'deleteLine:ofList:': {
+        opcode: 'data_deleteoflist',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_integer',
+                inputName: 'INDEX'
+            },
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            }
+        ]
+    },
+    'insert:at:ofList:': {
+        opcode: 'data_insertatlist',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'ITEM'
+            },
+            {
+                type: 'input',
+                inputOp: 'math_integer',
+                inputName: 'INDEX'
+            },
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            }
+        ]
+    },
+    'setLine:ofList:to:': {
+        opcode: 'data_replaceitemoflist',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_integer',
+                inputName: 'INDEX'
+            },
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            },
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'ITEM'
+            }
+        ]
+    },
+    'getLine:ofList:': {
+        opcode: 'data_itemoflist',
+        argMap: [
+            {
+                type: 'input',
+                inputOp: 'math_integer',
+                inputName: 'INDEX'
+            },
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            }
+        ]
+    },
+    'lineCountOfList:': {
+        opcode: 'data_lengthoflist',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            }
+        ]
+    },
+    'list:contains:': {
+        opcode: 'data_listcontainsitem',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            },
+            {
+                type: 'input',
+                inputOp: 'text',
+                inputName: 'ITEM'
+            }
+        ]
+    },
+    'showList:': {
+        opcode: 'data_showlist',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            }
+        ]
+    },
+    'hideList:': {
+        opcode: 'data_hidelist',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'LIST',
+                variableType: Variable.LIST_TYPE
+            }
+        ]
+    },
+    'procDef': {
+        opcode: 'procedures_definition',
+        argMap: []
+    },
+    'getParam': {
+        // Doesn't map to single opcode. Import step assigns final correct opcode.
+        opcode: 'argument_reporter_string_number',
+        argMap: [
+            {
+                type: 'field',
+                fieldName: 'VALUE'
+            }
+        ]
+    },
+    'call': {
+        opcode: 'procedures_call',
+        argMap: []
+    }
+};
+
+/**
+ * Add to the specMap entries for an opcode from a Scratch 2.0 extension. Two entries will be made with the same
+ * metadata; this is done to support projects saved by both older and newer versions of the Scratch 2.0 editor.
+ * @param {string} sb2Extension - the Scratch 2.0 name of the extension
+ * @param {string} sb2Opcode - the Scratch 2.0 opcode
+ * @param {SB2SpecMap_blockInfo} blockInfo - the Scratch 3.0 block info
+ */
+const addExtensionOp = function (sb2Extension, sb2Opcode, blockInfo) {
+    /**
+     * This string separates the name of an extension and the name of an opcode in more recent Scratch 2.0 projects.
+     * Earlier projects used '.' as a separator, up until we added the 'LEGO WeDo 2.0' extension...
+     * @type {string}
+     */
+    const sep = '\u001F'; // Unicode Unit Separator
+
+    // make one entry for projects saved by recent versions of the Scratch 2.0 editor
+    specMap[`${sb2Extension}${sep}${sb2Opcode}`] = blockInfo;
+
+    // make a second for projects saved by older versions of the Scratch 2.0 editor
+    specMap[`${sb2Extension}.${sb2Opcode}`] = blockInfo;
+};
+
+const weDo2 = 'LEGO WeDo 2.0';
+
+addExtensionOp(weDo2, 'motorOnFor', {
+    opcode: 'wedo2_motorOnFor',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_MOTOR_ID',
+            inputName: 'MOTOR_ID'
+        },
+        {
+            type: 'input',
+            inputOp: 'math_number',
+            inputName: 'DURATION'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'motorOn', {
+    opcode: 'wedo2_motorOn',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_MOTOR_ID',
+            inputName: 'MOTOR_ID'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'motorOff', {
+    opcode: 'wedo2_motorOff',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_MOTOR_ID',
+            inputName: 'MOTOR_ID'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'startMotorPower', {
+    opcode: 'wedo2_startMotorPower',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_MOTOR_ID',
+            inputName: 'MOTOR_ID'
+        },
+        {
+            type: 'input',
+            inputOp: 'math_number',
+            inputName: 'POWER'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'setMotorDirection', {
+    opcode: 'wedo2_setMotorDirection',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_MOTOR_ID',
+            inputName: 'MOTOR_ID'
+        },
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_MOTOR_DIRECTION',
+            inputName: 'MOTOR_DIRECTION'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'setLED', {
+    opcode: 'wedo2_setLightHue',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'math_number',
+            inputName: 'HUE'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'playNote', {
+    opcode: 'wedo2_playNoteFor',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'math_number',
+            inputName: 'NOTE'
+        },
+        {
+            type: 'input',
+            inputOp: 'math_number',
+            inputName: 'DURATION'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'whenDistance', {
+    opcode: 'wedo2_whenDistance',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_OP',
+            inputName: 'OP'
+        },
+        {
+            type: 'input',
+            inputOp: 'math_number',
+            inputName: 'REFERENCE'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'whenTilted', {
+    opcode: 'wedo2_whenTilted',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_TILT_DIRECTION_ANY',
+            inputName: 'TILT_DIRECTION_ANY'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'getDistance', {
+    opcode: 'wedo2_getDistance',
+    argMap: []
+});
+
+addExtensionOp(weDo2, 'isTilted', {
+    opcode: 'wedo2_isTilted',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_TILT_DIRECTION_ANY',
+            inputName: 'TILT_DIRECTION_ANY'
+        }
+    ]
+});
+
+addExtensionOp(weDo2, 'getTilt', {
+    opcode: 'wedo2_getTiltAngle',
+    argMap: [
+        {
+            type: 'input',
+            inputOp: 'wedo2_menu_TILT_DIRECTION',
+            inputName: 'TILT_DIRECTION'
+        }
+    ]
+});
+
+module.exports = specMap;