pxt-common-packages 9.5.4 → 9.5.5

package/libs/controller/built/debug/binary.js

@@ -35606,7 +35606,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-Sprite_toString__P65941.info = {"start":37683,"length":93,"line":1169,"column":4,"endLine":1171,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
+Sprite_toString__P65941.info = {"start":37718,"length":93,"line":1170,"column":4,"endLine":1172,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
 
 function Sprite_toString__P65941_mk(s) {
     checkStack(s.depth);

package/libs/controller---none/built/debug/binary.js

@@ -35497,7 +35497,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-Sprite_toString__P81431.info = {"start":37683,"length":93,"line":1169,"column":4,"endLine":1171,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
+Sprite_toString__P81431.info = {"start":37718,"length":93,"line":1170,"column":4,"endLine":1172,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
 
 function Sprite_toString__P81431_mk(s) {
     checkStack(s.depth);

package/libs/game/built/debug/binary.js

@@ -35027,7 +35027,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-Sprite_toString__P138985.info = {"start":37683,"length":93,"line":1169,"column":4,"endLine":1171,"endColumn":5,"fileName":"sprite.ts","functionName":"toString","argumentNames":["this"]}
+Sprite_toString__P138985.info = {"start":37718,"length":93,"line":1170,"column":4,"endLine":1172,"endColumn":5,"fileName":"sprite.ts","functionName":"toString","argumentNames":["this"]}
 
 function Sprite_toString__P138985_mk(s) {
     checkStack(s.depth);

package/libs/game/docs/reference/sprites/sprite/follow.md

@@ -0,0 +1,66 @@
+# follow
+
+Set a sprite to always move to the position of another target sprite.
+
+```sig
+sprites.create(null).follow(null, 0)
+```
+
+When you set a sprite to follow a target sprite, it will move toward the target by "chasing" it with a certain speed. If the sprite can reach the target before it moves again, the sprite will stop and occupy the same location as the target sprite. When not moving, the sprites overlap each other at their center locations.
+
+## Parameters
+
+* **target**: the target [sprite](/types/sprite) to follow.
+* **speed**: the maximum chase speed after accelerating, in pixels per second, when moving toward the target sprite.
+* **turnRate**: (optional) the time to take in making a turn to toward the target sprite. For example, using the default rate, `400`, the sprite will reach **speed** in 125 milleseconds when turing 180 degrees to chase the target. 
+
+## Example
+
+Create 2 sprites. Set the second sprite to follow the first one. Every second, randomly change the position of the first sprite on the screen so that the second sprite will keep chasing it.
+
+```blocks
+let mySprite = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 7 7 7 7 7 7 . . . . . 
+    . . . 7 7 7 7 7 7 7 7 7 7 . . . 
+    . . . 7 7 7 7 7 7 7 7 7 7 . . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . . 7 7 7 7 7 7 7 7 7 7 . . . 
+    . . . 7 7 7 7 7 7 7 7 7 7 . . . 
+    . . . . . 7 7 7 7 7 7 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+let mySprite2 = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+mySprite2.follow(mySprite, 50,)
+game.onUpdateInterval(1000, function () {
+    mySprite.setPosition(randint(0, scene.screenWidth()), randint(0, scene.screenHeight()))
+})
+```
+
+## See also
+
+[overlaps with](/reference/sprites/sprite/overlaps-with)

package/libs/game/docs/reference/sprites/sprite/set-bounce-on-wall.md

@@ -43,7 +43,7 @@ mySprite.vx = 50
 mySprite.vy = 50
 ```
 
-### Boucne on the the edge of the screen
+### Bounce on the the edge of the screen
 
 With a scene that has no tilemap set, make a sprite bounce on the edges of the screen.
 
@@ -97,4 +97,4 @@ mySprite.vy = 50
 
 ## See also
 
-[set flag](/reference/sprites/sprite/set-flag), [set stay in screen](/reference/sprites/sprite/set-stay-in-screen)
+[set flag](/reference/sprites/sprite/set-flag), [set stay in screen](/reference/sprites/sprite/set-stay-in-screen)

package/libs/game/sprite.ts

@@ -998,6 +998,7 @@ class Sprite extends sprites.BaseSprite {
     //% group="Physics" weight=10
     //% blockId=spriteFollowOtherSprite
     //% block="set %sprite(myEnemy) follow %target=variables_get(mySprite) || with speed %speed"
+    //% help=sprites/sprite/follow
     follow(target: Sprite, speed = 100, turnRate = 400) {
         if (target === this) return;
 

package/libs/net-game/built/debug/binary.js

@@ -44310,7 +44310,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-Sprite_toString__P112350.info = {"start":37683,"length":93,"line":1169,"column":4,"endLine":1171,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
+Sprite_toString__P112350.info = {"start":37718,"length":93,"line":1170,"column":4,"endLine":1172,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
 
 function Sprite_toString__P112350_mk(s) {
     checkStack(s.depth);

package/libs/palette/built/debug/binary.js

@@ -35027,7 +35027,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-Sprite_toString__P171170.info = {"start":37683,"length":93,"line":1169,"column":4,"endLine":1171,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
+Sprite_toString__P171170.info = {"start":37718,"length":93,"line":1170,"column":4,"endLine":1172,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
 
 function Sprite_toString__P171170_mk(s) {
     checkStack(s.depth);

package/libs/radio/_locales/radio-strings.json

@@ -18,5 +18,8 @@
   "radio.setTransmitPower|block": "radio set transmit power %power",
   "radio.setTransmitSerialNumber|block": "radio set transmit serial number %transmit",
   "radio|block": "radio",
-  "{id:category}Radio": "Radio"
+  "{id:category}Radio": "Radio",
+  "{id:group}Group": "Group",
+  "{id:group}Receive": "Receive",
+  "{id:group}Send": "Send"
 }

package/libs/radio/radio.cpp

@@ -237,6 +237,7 @@ CODAL_RADIO* getRadio() {
     //% weight=100
     //% blockId=radio_set_group block="radio set group %ID"
     //% id.min=0 id.max=255
+    //% group="Group"
     void setGroup(int id) {
 #ifdef CODAL_RADIO        
         if (radioEnable() != DEVICE_OK) return;

package/libs/radio/radio.ts

@@ -14,7 +14,7 @@ enum RadioPacketProperty {
 /**
  * Communicate data using radio packets
  */
-//% color=#E3008C weight=96 icon="\uf012"
+//% color=#E3008C weight=96 icon="\uf012" groups='["Group", "Broadcast", "Send", "Receive"]'
 namespace radio {
 
     // keep in sync with CODAL
@@ -95,6 +95,8 @@ namespace radio {
     //% help=radio/on-received-number
     //% blockId=radio_on_number_drag block="on radio received" blockGap=16
     //% useLoc="radio.onDataPacketReceived" draggableParameters=reporter
+    //% group="Receive"
+    //% weight=20
     export function onReceivedNumber(cb: (receivedNumber: number) => void) {
         init();
         onReceivedNumberHandler = cb;
@@ -106,6 +108,8 @@ namespace radio {
     //% help=radio/on-received-value
     //% blockId=radio_on_value_drag block="on radio received" blockGap=16
     //% useLoc="radio.onDataPacketReceived" draggableParameters=reporter
+    //% group="Receive"
+    //% weight=19
     export function onReceivedValue(cb: (name: string, value: number) => void) {
         init();
         onReceivedValueHandler = cb;
@@ -117,6 +121,8 @@ namespace radio {
     //% help=radio/on-received-string
     //% blockId=radio_on_string_drag block="on radio received" blockGap=16
     //% useLoc="radio.onDataPacketReceived" draggableParameters=reporter
+    //% group="Receive"
+    //% weight=18
     export function onReceivedString(cb: (receivedString: string) => void) {
         init();
         onReceivedStringHandler = cb;
@@ -138,8 +144,10 @@ namespace radio {
      * @param type the type of property to retrieve from the last packet
      */
     //% help=radio/received-packet
-    //% weight=11 blockGap=8
+    //% blockGap=8
     //% blockId=radio_received_packet block="received packet %type=radio_packet_property" blockGap=16
+    //% group="Receive"
+    //% weight=16
     export function receivedPacket(type: number) {
         if (lastPacket) {
             switch (type) {
@@ -272,6 +280,7 @@ namespace radio {
     //% help=radio/send-number
     //% weight=60
     //% blockId=radio_datagram_send block="radio send number %value" blockGap=8
+    //% group="Send"
     export function sendNumber(value: number) {
         let packet: RadioPacket;
 
@@ -296,6 +305,7 @@ namespace radio {
     //% help=radio/send-value
     //% weight=59
     //% blockId=radio_datagram_send_value block="radio send|value %name|= %value" blockGap=8
+    //% group="Send"
     export function sendValue(name: string, value: number) {
         let packet: RadioPacket;
 
@@ -319,6 +329,7 @@ namespace radio {
     //% weight=58
     //% blockId=radio_datagram_send_string block="radio send string %msg"
     //% msg.shadowOptions.toString=true
+    //% group="Send"
     export function sendString(value: string) {
         const packet = RadioPacket.mkPacket(PACKET_TYPE_STRING);
         packet.stringPayload = value;

package/libs/radio/shims.d.ts

@@ -58,7 +58,8 @@ declare namespace radio {
     //% help=radio/set-group
     //% weight=100
     //% blockId=radio_set_group block="radio set group %ID"
-    //% id.min=0 id.max=255 shim=radio::setGroup
+    //% id.min=0 id.max=255
+    //% group="Group" shim=radio::setGroup
     function setGroup(id: int32): void;
 
     /**

package/libs/radio-broadcast/_locales/radio-broadcast-strings.json

@@ -2,5 +2,6 @@
   "radio.onReceivedMessage|block": "on radio $msg received",
   "radio.sendMessage|block": "radio send $msg",
   "radio|block": "radio",
-  "{id:category}Radio": "Radio"
+  "{id:category}Radio": "Radio",
+  "{id:group}Broadcast": "Broadcast"
 }

package/libs/radio-broadcast/radio-broadcast.ts

@@ -21,6 +21,7 @@ namespace radio {
     //% weight=200
     //% blockGap=8
     //% help=radio/send-message
+    //% group="Broadcast"
     export function sendMessage(msg: number): void {
         // 0 is MICROBIT_EVT_ANY, shifting by 1
         radio.raiseEvent(BROADCAST_GENERAL_ID, msg + 1);
@@ -35,6 +36,7 @@ namespace radio {
     //% msg.shadow=radioMessageCode draggableParameters
     //% weight=199
     //% help=radio/on-received-message
+    //% group="Broadcast"
     export function onReceivedMessage(msg: number, handler: () => void) {
         control.onEvent(BROADCAST_GENERAL_ID, msg + 1, handler);
     }

package/libs/sprite-scaling/built/debug/binary.js

@@ -35027,7 +35027,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-Sprite_toString__P191659.info = {"start":37683,"length":93,"line":1169,"column":4,"endLine":1171,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
+Sprite_toString__P191659.info = {"start":37718,"length":93,"line":1170,"column":4,"endLine":1172,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
 
 function Sprite_toString__P191659_mk(s) {
     checkStack(s.depth);

package/libs/storyboard/built/debug/binary.js

@@ -35027,7 +35027,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-Sprite_toString__P154569.info = {"start":37683,"length":93,"line":1169,"column":4,"endLine":1171,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
+Sprite_toString__P154569.info = {"start":37718,"length":93,"line":1170,"column":4,"endLine":1172,"endColumn":5,"fileName":"pxt_modules/game/sprite.ts","functionName":"toString","argumentNames":["this"]}
 
 function Sprite_toString__P154569_mk(s) {
     checkStack(s.depth);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pxt-common-packages",
-  "version": "9.5.4",
+  "version": "9.5.5",
   "description": "Microsoft MakeCode (PXT) common packages",
   "keywords": [
     "MakeCode",