pxt-common-packages 13.1.2 → 13.1.5

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

@@ -1,4 +1,4 @@
-// total=2917 new=27.67% cached=0.00% other=72.33%
+// total=2916 new=27.64% cached=0.00% other=72.36%
 (function (ectx) {
 'use strict';
 const runtime = ectx.runtime;
@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P56956(s) {
+function _main___P56980(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,27 +66,26 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___57200 = (undefined);
-    globals._pollEventQueue___57213 = (undefined);
+    globals._intervals___57224 = (undefined);
+    globals._pollEventQueue___57237 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P56956.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"pxt_modules/light/neopixel.ts","functionName":"<main>","argumentNames":[]}
-_main___P56956.continuations = [  ]
+_main___P56980.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"pxt_modules/light/neopixel.ts","functionName":"<main>","argumentNames":[]}
+_main___P56980.continuations = [  ]
 
-function _main___P56956_mk(s) {
+function _main___P56980_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P56956, depth: s.depth + 1,
+        parent: s, fn: _main___P56980, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
 
 
 
-
 const breakpoints = setupDebugger(1, [])
 
-return _main___P56956
+return _main___P56980
 })

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

@@ -1,4 +1,4 @@
-// total=2896 new=27.14% cached=0.00% other=72.86%
+// total=2895 new=27.12% cached=0.00% other=72.88%
 (function (ectx) {
 'use strict';
 const runtime = ectx.runtime;
@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P63807(s) {
+function _main___P63834(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,27 +66,26 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___64051 = (undefined);
-    globals._pollEventQueue___64064 = (undefined);
+    globals._intervals___64078 = (undefined);
+    globals._pollEventQueue___64091 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P63807.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"power.ts","functionName":"<main>","argumentNames":[]}
-_main___P63807.continuations = [  ]
+_main___P63834.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"power.ts","functionName":"<main>","argumentNames":[]}
+_main___P63834.continuations = [  ]
 
-function _main___P63807_mk(s) {
+function _main___P63834_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P63807, depth: s.depth + 1,
+        parent: s, fn: _main___P63834, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
 
 
 
-
 const breakpoints = setupDebugger(1, [])
 
-return _main___P63807
+return _main___P63834
 })

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

@@ -1,4 +1,4 @@
-// total=2910 new=27.32% cached=0.00% other=72.68%
+// total=2909 new=27.29% cached=0.00% other=72.71%
 (function (ectx) {
 'use strict';
 const runtime = ectx.runtime;
@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P104807(s) {
+function _main___P104840(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,27 +66,26 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___105051 = (undefined);
-    globals._pollEventQueue___105064 = (undefined);
+    globals._intervals___105084 = (undefined);
+    globals._pollEventQueue___105097 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P104807.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"vl53l0x.ts","functionName":"<main>","argumentNames":[]}
-_main___P104807.continuations = [  ]
+_main___P104840.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"vl53l0x.ts","functionName":"<main>","argumentNames":[]}
+_main___P104840.continuations = [  ]
 
-function _main___P104807_mk(s) {
+function _main___P104840_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P104807, depth: s.depth + 1,
+        parent: s, fn: _main___P104840, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
 
 
 
-
 const breakpoints = setupDebugger(1, [])
 
-return _main___P104807
+return _main___P104840
 })

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

@@ -1,4 +1,4 @@
-// total=2910 new=27.49% cached=0.00% other=72.51%
+// total=2909 new=27.47% cached=0.00% other=72.53%
 (function (ectx) {
 'use strict';
 const runtime = ectx.runtime;
@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P19401(s) {
+function _main___P19412(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,27 +66,26 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___19645 = (undefined);
-    globals._pollEventQueue___19658 = (undefined);
+    globals._intervals___19656 = (undefined);
+    globals._pollEventQueue___19669 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P19401.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"pxt_modules/base/ns.ts","functionName":"<main>","argumentNames":[]}
-_main___P19401.continuations = [  ]
+_main___P19412.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"pxt_modules/base/ns.ts","functionName":"<main>","argumentNames":[]}
+_main___P19412.continuations = [  ]
 
-function _main___P19401_mk(s) {
+function _main___P19412_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P19401, depth: s.depth + 1,
+        parent: s, fn: _main___P19412, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
 
 
 
-
 const breakpoints = setupDebugger(1, [])
 
-return _main___P19401
+return _main___P19412
 })

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

@@ -5,9 +5,14 @@
   "radio._packetProperty|block": "%note",
   "radio.onDataReceived|block": "radio on data received",
   "radio.onReceivedBuffer|block": "on radio received",
+  "radio.onReceivedBuffer|handlerParam|receivedBuffer": "receivedBuffer",
   "radio.onReceivedNumber|block": "on radio received",
+  "radio.onReceivedNumber|handlerParam|receivedNumber": "receivedNumber",
   "radio.onReceivedString|block": "on radio received",
+  "radio.onReceivedString|handlerParam|receivedString": "receivedString",
   "radio.onReceivedValue|block": "on radio received",
+  "radio.onReceivedValue|handlerParam|name": "name",
+  "radio.onReceivedValue|handlerParam|value": "value",
   "radio.raiseEvent|block": "radio raise event|from source %src=control_event_source_id|with value %value=control_event_value_id",
   "radio.receivedPacket|block": "received packet %type=radio_packet_property",
   "radio.sendNumber|block": "radio send number %value",

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

@@ -1,4 +1,4 @@
-// total=2914 new=27.56% cached=0.00% other=72.44%
+// total=2913 new=27.53% cached=0.00% other=72.47%
 (function (ectx) {
 'use strict';
 const runtime = ectx.runtime;
@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P193643(s) {
+function _main___P193688(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,27 +66,26 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___193887 = (undefined);
-    globals._pollEventQueue___193900 = (undefined);
+    globals._intervals___193932 = (undefined);
+    globals._pollEventQueue___193945 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P193643.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"targetoverrides.ts","functionName":"<main>","argumentNames":[]}
-_main___P193643.continuations = [  ]
+_main___P193688.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"targetoverrides.ts","functionName":"<main>","argumentNames":[]}
+_main___P193688.continuations = [  ]
 
-function _main___P193643_mk(s) {
+function _main___P193688_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P193643, depth: s.depth + 1,
+        parent: s, fn: _main___P193688, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
 
 
 
-
 const breakpoints = setupDebugger(1, [])
 
-return _main___P193643
+return _main___P193688
 })

package/libs/radio-broadcast/built/debug/binary.js

@@ -1,4 +1,4 @@
-// total=2924 new=27.46% cached=0.00% other=72.54%
+// total=2923 new=27.44% cached=0.00% other=72.56%
 (function (ectx) {
 'use strict';
 const runtime = ectx.runtime;
@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P195468(s) {
+function _main___P195514(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,27 +66,26 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___195712 = (undefined);
-    globals._pollEventQueue___195725 = (undefined);
+    globals._intervals___195758 = (undefined);
+    globals._pollEventQueue___195771 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P195468.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"radio-broadcast.ts","functionName":"<main>","argumentNames":[]}
-_main___P195468.continuations = [  ]
+_main___P195514.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"radio-broadcast.ts","functionName":"<main>","argumentNames":[]}
+_main___P195514.continuations = [  ]
 
-function _main___P195468_mk(s) {
+function _main___P195514_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P195468, depth: s.depth + 1,
+        parent: s, fn: _main___P195514, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
 
 
 
-
 const breakpoints = setupDebugger(1, [])
 
-return _main___P195468
+return _main___P195514
 })

package/libs/rotary-encoder/built/debug/binary.js

@@ -1,4 +1,4 @@
-// total=2923 new=27.47% cached=0.00% other=72.53%
+// total=2922 new=27.45% cached=0.00% other=72.55%
 (function (ectx) {
 'use strict';
 const runtime = ectx.runtime;
@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P175629(s) {
+function _main___P175672(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,27 +66,26 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___175873 = (undefined);
-    globals._pollEventQueue___175886 = (undefined);
+    globals._intervals___175916 = (undefined);
+    globals._pollEventQueue___175929 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P175629.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"targetoverrides.ts","functionName":"<main>","argumentNames":[]}
-_main___P175629.continuations = [  ]
+_main___P175672.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"targetoverrides.ts","functionName":"<main>","argumentNames":[]}
+_main___P175672.continuations = [  ]
 
-function _main___P175629_mk(s) {
+function _main___P175672_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P175629, depth: s.depth + 1,
+        parent: s, fn: _main___P175672, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
 
 
 
-
 const breakpoints = setupDebugger(1, [])
 
-return _main___P175629
+return _main___P175672
 })

package/libs/rotary-encoder/docs/reference/encoders/on-changed.md

@@ -0,0 +1,29 @@
+# on Changed
+
+Run some code when the rotary encoder changes position.
+
+```sig
+encoders.createRotaryEncoder(pins.A2, pins.A1).onChanged(function () {})
+```
+
+## Example #example
+
+Show the encoder position on the game console when it changes.
+
+```typescript
+const crank = encoders.createRotaryEncoder(pins.A2, pins.A1);
+game.consoleOverlay.setVisible(true);
+let sprite = sprites.create(sprites.castle.heroFrontAttack1)
+crank.onChanged(function () {
+    console.log(crank.position())
+    sprite.x = screen.width / 2 + crank.position()
+})
+```
+
+## See also #seealso
+
+[position](/reference/encoders/position)
+
+```package
+encoders
+```

package/libs/rotary-encoder/docs/reference/encoders/position.md

@@ -0,0 +1,33 @@
+# position
+
+Get the current position rotary encoder.
+
+```sig
+encoders.createRotaryEncoder(pins.A2, pins.A1).position( )
+```
+
+## Returns
+
+* a [number](/types/number) that indicates the encoder's position.
+
+## Example #example
+
+Show the encoder position on the game console when it changes.
+
+```typescript
+const crank = encoders.createRotaryEncoder(pins.A2, pins.A1);
+game.consoleOverlay.setVisible(true);
+let sprite = sprites.create(sprites.castle.heroFrontAttack1)
+crank.onChanged(function () {
+    console.log(crank.position())
+    sprite.x = screen.width / 2 + crank.position()
+})
+```
+
+## See also #seealso
+
+[on changed](/reference/encoders/on-changed)
+
+```package
+encoders
+```

package/libs/rotary-encoder/rotary.cpp

@@ -78,7 +78,7 @@ namespace RotaryEncoderMethods {
  */
 //% blockNamespace="encoders"
 //% blockId=rotaryencoderonchaned block="on %this changed"
-//% weight=80 blockGap=8
+//% weight=80 blockGap=8 help=encoders/on-changed
 void onChanged(RotaryEncoder encoder, Action body) {
     registerWithDal(encoder->id, ROT_EV_CHANGED, body);
 }
@@ -88,7 +88,7 @@ void onChanged(RotaryEncoder encoder, Action body) {
  */
 //% blockNamespace="encoders"
 //% blockId=rotaryencoderposition block="%this position"
-//% weight=79 blockGap=8
+//% weight=79 blockGap=8 help=encoders/position
 int position(RotaryEncoder encoder) {
     // the position always changes by 4 per tick
     return encoder->position >> 2;

package/libs/rotary-encoder/shims.d.ts

@@ -23,7 +23,7 @@ declare interface RotaryEncoder {
      */
     //% blockNamespace="encoders"
     //% blockId=rotaryencoderonchaned block="on %this changed"
-    //% weight=80 blockGap=8 shim=RotaryEncoderMethods::onChanged
+    //% weight=80 blockGap=8 help=encoders/on-changed shim=RotaryEncoderMethods::onChanged
     onChanged(body: () => void): void;
 
     /**
@@ -31,7 +31,7 @@ declare interface RotaryEncoder {
      */
     //% blockNamespace="encoders"
     //% blockId=rotaryencoderposition block="%this position"
-    //% weight=79 blockGap=8 shim=RotaryEncoderMethods::position
+    //% weight=79 blockGap=8 help=encoders/position shim=RotaryEncoderMethods::position
     position(): int32;
 }