pxt-common-packages 13.2.2 → 13.2.4

package/libs/radio/docs/reference/radio/received-packet.md

@@ -0,0 +1,39 @@
+# received Packet
+
+Get a property for the last radio packet received
+
+```sig
+radio.receivedPacket(RadioPacketProperty.Time)
+```
+
+Some information about the last packet received is available such as the time it was received, the packet serial number, or the signal strength when received.
+
+## Parameters
+
+* **type**: the type of property to return for the received packet:
+
+> `time`: the time when the packed was received
+> `serial number`: the serial number of the packet
+> `signal strength`: the signal strength at the time the packet was received
+
+## Simulator
+
+This function only works on the @boardname@, not in browsers.
+
+## Example
+
+Get the signal strength of the last received packet.
+
+```blocks
+let ss = radio.receivedPacket(RadioPacketProperty.SignalStrength)
+```
+
+## See also
+
+[on received number](/reference/radio/on-received-number),
+[on received string](/reference/radio/on-received-string),
+[on received value](/reference/radio/on-received-value)
+
+```package
+radio
+```

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

@@ -7524,7 +7524,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_checkDeepSleep__P199675.info = {"start":1087,"length":298,"line":36,"column":4,"endLine":46,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"checkDeepSleep","argumentNames":[]}
+power_checkDeepSleep__P199675.info = {"start":1084,"length":298,"line":36,"column":4,"endLine":46,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"checkDeepSleep","argumentNames":[]}
 
 function power_checkDeepSleep__P199675_mk(s) {
     checkStack(s.depth);
@@ -7587,7 +7587,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_init__P199677.info = {"start":1610,"length":376,"line":57,"column":4,"endLine":66,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"init","argumentNames":[]}
+power_init__P199677.info = {"start":1606,"length":376,"line":57,"column":4,"endLine":66,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"init","argumentNames":[]}
 
 function power_init__P199677_mk(s) {
     checkStack(s.depth);
@@ -11999,7 +11999,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_poke__P199674.info = {"start":795,"length":81,"line":26,"column":4,"endLine":29,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"poke","argumentNames":[]}
+power_poke__P199674.info = {"start":793,"length":81,"line":26,"column":4,"endLine":29,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"poke","argumentNames":[]}
 
 function power_poke__P199674_mk(s) {
     checkStack(s.depth);

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

@@ -7524,7 +7524,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_checkDeepSleep__P159791.info = {"start":1087,"length":298,"line":36,"column":4,"endLine":46,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"checkDeepSleep","argumentNames":[]}
+power_checkDeepSleep__P159791.info = {"start":1084,"length":298,"line":36,"column":4,"endLine":46,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"checkDeepSleep","argumentNames":[]}
 
 function power_checkDeepSleep__P159791_mk(s) {
     checkStack(s.depth);
@@ -7587,7 +7587,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_init__P159793.info = {"start":1610,"length":376,"line":57,"column":4,"endLine":66,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"init","argumentNames":[]}
+power_init__P159793.info = {"start":1606,"length":376,"line":57,"column":4,"endLine":66,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"init","argumentNames":[]}
 
 function power_init__P159793_mk(s) {
     checkStack(s.depth);
@@ -11999,7 +11999,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_poke__P159790.info = {"start":795,"length":81,"line":26,"column":4,"endLine":29,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"poke","argumentNames":[]}
+power_poke__P159790.info = {"start":793,"length":81,"line":26,"column":4,"endLine":29,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"poke","argumentNames":[]}
 
 function power_poke__P159790_mk(s) {
     checkStack(s.depth);

package/libs/switch/docs/reference/input/switch-right.md

@@ -0,0 +1,27 @@
+# switch Right
+
+Check if a switch is positioned to the right.
+
+```sig
+input.switchRight( )
+
+```
+## Returns
+
+* a [boolean](/types/boolean) value that is `true` if the switch is in the **right** position or `false` if it is in the **left** position.
+
+## Example #example
+
+Check if a switch is in the `right` position.
+
+```blocks
+let isRight = input.switchRight()
+```
+
+## See also #seealso
+
+[on event](/reference/input/on-switch-moved)
+
+```package
+input
+```

package/libs/switch/shims.d.ts

@@ -16,7 +16,8 @@ declare namespace input {
      */
     //% blockId=device_switch_direction block="switch right"
     //% parts="switch"
-    //% group="Switch" weight=10 blockGap=8 shim=input::switchRight
+    //% group="Switch" weight=10 blockGap=8
+    //% help=input/switch-right shim=input::switchRight
     function switchRight(): boolean;
 }
 

package/libs/switch/switch.cpp

@@ -43,6 +43,7 @@ void onSwitchMoved(SwitchDirection direction, Action handler) {
 //% blockId=device_switch_direction block="switch right"
 //% parts="switch"
 //% group="Switch" weight=10 blockGap=8
+//% help=input/switch-right
 bool switchRight() {
     auto slide = getWSwitch();
     return slide->slideSwitch.isPressed();

package/libs/touch/docs/reference/input/touch/threshold.md

@@ -0,0 +1,33 @@
+# threshold
+
+Get the current threshold set for a touch pin.
+
+```sig
+input.touchA1.threshold()
+```
+
+Pins (or pads) on a board used to detect a touch are measured to see how much electrical charge is on them. This measurement happens over a short period of time while a charge builds up when you touch it. To control the amount of charge it takes for the touch circuit to say that a touch happen, you set the touch threshold.
+
+Setting a higher threshold value makes it take longer for a touch event to happen. If you want a touch event to require you to stay on the pin for a while, then set the value to something high. Quick taps on the pin will signal a touch with a lower threshold value.
+
+## Returns
+
+* a [number](/types/number) that is the currently set threshold (charge amount) needed to detect that a pin was touched. This is a value between `0` and `1023`.
+
+## Example #example
+
+Set the touch threshold to `1000` if it's set to a lower value.
+
+```blocks
+if (input.touchA1.threshold()) {
+    input.touchA1.setThreshold(1000)
+}
+```
+
+## See also #seealso
+
+[set threshold](/reference/input/touch/set-threshold)
+
+```package
+touch
+```

package/package.json

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