pxt-common-packages 13.2.2 → 13.2.4

package/built/common-sim.js

@@ -3619,10 +3619,12 @@ var pxsim;
     var music;
     (function (music) {
         function playInstructions(b) {
+            setupOnStopAll();
             return pxsim.AudioContextManager.playInstructionsAsync(b.data);
         }
         music.playInstructions = playInstructions;
         function queuePlayInstructions(when, b) {
+            setupOnStopAll();
             pxsim.AudioContextManager.queuePlayInstructions(when, b);
         }
         music.queuePlayInstructions = queuePlayInstructions;
@@ -3644,15 +3646,25 @@ var pxsim;
         music.SEQUENCER_LOOPED_MESSAGE = 3246;
         let sequencers;
         let nextSequencerId = 0;
-        async function _createSequencer() {
-            if (!sequencers) {
+        let onStopAllSetup = false;
+        function setupOnStopAll() {
+            if (!onStopAllSetup) {
+                onStopAllSetup = true;
                 pxsim.AudioContextManager.onStopAll(() => {
-                    for (const seq of sequencers) {
-                        seq.sequencer.stop();
-                        seq.sequencer.dispose();
+                    pxsim.AudioContextManager.muteAllChannels();
+                    if (sequencers) {
+                        for (const seq of sequencers) {
+                            seq.sequencer.stop();
+                            seq.sequencer.dispose();
+                        }
+                        sequencers = [];
                     }
-                    sequencers = [];
                 });
+            }
+        }
+        async function _createSequencer() {
+            setupOnStopAll();
+            if (!sequencers) {
                 sequencers = [];
             }
             const res = {

package/libs/base/docs/reference/control/device-long-serial-number.md

@@ -0,0 +1,26 @@
+# device Long Serial Number
+
+Get the long (64-bit) serial number for the @boardname@
+
+```sig
+control.deviceSerialNumber()
+```
+
+The system software in your board creates a unique number to identify the board. You can use this number in your program if you want to know which board is running your program.
+
+## Returns
+
+* a [buffer](/types/buffer) that contains a 64-bit value to uniquely identify this board.
+
+## Example #example
+
+Write the board's long serial number to the serial port as a Base64 string.
+
+```blocks
+console.log("serialnumber: " + control.deviceLongSerialNumber().toBase64())
+```
+
+## See also #seealso
+
+[device dal version](/reference/control/device-dal-version),
+[device serial number](/reference/control/device-serial-number)

package/libs/base/docs/reference/control/device-serial-number.md

@@ -22,4 +22,5 @@ serial.writeValue("serialnumber", control.deviceSerialNumber());
 
 ## See also #seealso
 
+[device long serial number](/reference/control/device-long-serial-number),
 [device dal version](/reference/control/device-dal-version)

package/libs/base/docs/reference/math/constrain.md

@@ -0,0 +1,36 @@
+# constrain 
+
+Make certain that the value of a number you give is no smaller and no bigger than two other numbers.
+
+```sig
+Math.constrain(0,0,0)
+```
+
+A value is _constrained_, or limited, within a range by testing it's value against two limit numbers. One of the limit numbers sets the lowest value that the number tested should have. The other limit number sets the highest value that the number tested should have.
+
+If the value tested is within the range of these two limit numbers, the value itself is returned. If the value is outside of the range of these two limit numbers, the value returned is one of the limit numbers that is closest to the value being tested.
+
+So, if `15` is constrained within a range of `3` to `10`, then ``Math.constrain(15, 6, 10)`` will return `10`. Also, if `3` is constrained to the same range, ``Math.constrain(3, 6, 10)`` will return `6`. Of course, a value of `4` that is constrained by `3` to `10` stays as `4`.
+
+## Parameters
+
+* **value**: A [number](/types/number) that is tested to be in a range.
+* **low**: the lower number limit of the range to test **value** for.
+* **high**: the upper number limit of the range to test **value** for.
+
+## Returns
+
+* a [number](/types/number) that is a value constrained by the number range of **low** to **high**.
+
+## Example #example
+
+Keep a desired value within a realistic range of `50` to `100`.
+
+```block 
+let desired = 155
+let realistic = Math.constrain(desired, 50, 100)
+```
+
+## See also
+
+[map](/reference/math/map) 

package/libs/base/docs/reference/math/map.md

@@ -0,0 +1,36 @@
+# map
+
+Convert a value in one number range to a value in another number range.
+
+```sig
+Math.map(0, 0, 0, 0, 0)
+```
+
+A _map_ is a conversion of one span of numbers to another. If a dog can live to 16 years and a person lives to 87 years, how do you make a 16 year life span seem like a 87 year life span? You say that one dog year is like some number of people years. This is a _mapping_ of dog years to people years. 
+ 
+Fahrenheit and Celsius are different ways to measure temperature. Celsius doesn't use the same amount of degrees as Fahrenheit. So, there is more energy in one degree of Celsius. If you want to convert a temperature value of Fahrenheit (something between freezing and boiling maybe) to Celsius, you can use ``Math.map(50, 32, 212, 0, 100)``. The map makes `50` degrees of Fahrenheit turn into `10` degrees of Celsius. 
+
+## Parameters
+
+* **value**: a [number](/types/number) to convert from one range to another.
+* **fromLow**: the low [number](/types/number) of the range to convert *from*.
+* **fromHigh**: the high [number](/types/number) of the range to convert *from*
+* **toLow**: the low [number](/types/number) of the range to convert *to*.
+* **toHigh**: the high [number](/types/number) of the range to convert *to*.
+
+## Returns
+
+* a new value that is a [number](/types/number) converted from original **value** using a mapping of the **from** range into the **to** range.
+
+# Example #example
+
+Use a lifespan map to find out the age in "people years" of a dog that's `7` years old.
+
+```block 
+let dogsAge = 7 
+let peoplesAge = Math.map(dogsAge, 1, 16, 15, 87) 
+```
+
+## See also
+
+[constrain](/reference/math/constrain)

package/libs/color-coded-tilemap/docs/reference/color-coded-tilemap/tile-hit-from.md

@@ -0,0 +1,81 @@
+# tile Hit From
+
+Find out what type of tile a sprite has hit.
+
+```sig
+scene.tileHitFrom(sprites.create(null), CollisionDirection.Left)
+```
+
+If a sprite is contacting a wall tile, you can find out what kind of tile it is. The tile index in the tile map is returned.
+
+## Parameters
+
+* **direction**: the direction check for a wall collision: ``left``, ``right``, ``top``, or ``bottom``.
+
+## Returns
+
+* a [number](/types/number) which is the tile index for the wall tile contacting the sprite.
+
+## Example
+
+Build a brick wall of tiles in the scene. Send a arrow sprite towards the wall. When the sprite hits the wall, say what type of tile it contacted.
+
+```blocks
+let mySprite: Sprite = null
+let flipImage: Image = null
+scene.onHitTile(SpriteKind.Player, 2, function (sprite) {
+    sprite.say("tile: " + scene.tileHitFrom(sprite, CollisionDirection.Left))
+})
+scene.setTile(2, img`
+1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 
+1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 1 
+1 2 2 2 2 2 2 2 2 2 2 2 2 f 2 1 
+1 2 2 f 2 2 2 2 2 2 2 2 2 2 2 1 
+1 2 2 2 2 2 2 f 2 2 2 2 2 2 2 1 
+1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 1 
+1 2 2 2 2 2 2 2 2 2 2 2 f 2 2 1 
+1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 1 
+1 2 2 2 2 f 2 2 2 f 2 2 2 2 2 1 
+1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 1 
+1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 1 
+1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 1 
+1 2 2 f 2 2 2 2 2 2 2 2 f 2 2 1 
+1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 1 
+1 2 2 2 2 2 2 f 2 2 2 2 f 2 2 1 
+1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 1 
+`, true)
+scene.setTileMap(img`
+. . . . . . . . . . 
+. 2 . . . . . . . . 
+. 2 . . . . . . . . 
+. 2 . . . . . . . . 
+. 2 . . . . . . . . 
+. 2 . . . . . . . . 
+. 2 . . . . . . . . 
+. . . . . . . . . . 
+`)
+flipImage = 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 . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+. . . . . . . . . . . . . . . . 
+`
+mySprite = sprites.create(flipImage, SpriteKind.Player)
+mySprite.vx = -50
+```
+
+## See also #seealso
+
+[on hit tile](/reference/scene/on-hit-tile)

package/libs/color-coded-tilemap/tilemap.ts

@@ -110,7 +110,7 @@ namespace scene {
      */
     //% blockId=legacyplaceontile block="on top of %tile=variables_get(myTile) place %sprite=variables_get(mySprite)"
     //% group="Color-coded Tilemap"
-    //% help=tiles/place
+    //% help=color-coded-tilemap/place
     export function place(tile: tiles.Tile, mySprite: Sprite): void {
         if (!tile) return;
         tile.place(mySprite);
@@ -148,7 +148,7 @@ namespace scene {
      */
     //% blockId=legacyspriteobstacle block="%sprite=variables_get(mySprite) wall hit on %direction"
     //% group="Color-coded Tilemap"
-    //% help=sprites/sprite/tile-hit-from
+    //% help=color-coded-tilemap/tile-hit-from
     export function tileHitFrom(sprite: Sprite, direction: CollisionDirection): number {
         if (!sprite) return 0;
         return sprite.tileHitFrom(direction);

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

@@ -9066,7 +9066,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_checkDeepSleep__P66135.info = {"start":1087,"length":298,"line":36,"column":4,"endLine":46,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"checkDeepSleep","argumentNames":[]}
+power_checkDeepSleep__P66135.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__P66135_mk(s) {
     checkStack(s.depth);
@@ -9129,7 +9129,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_init__P66137.info = {"start":1610,"length":376,"line":57,"column":4,"endLine":66,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"init","argumentNames":[]}
+power_init__P66137.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__P66137_mk(s) {
     checkStack(s.depth);
@@ -12607,7 +12607,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_poke__P66134.info = {"start":795,"length":81,"line":26,"column":4,"endLine":29,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"poke","argumentNames":[]}
+power_poke__P66134.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__P66134_mk(s) {
     checkStack(s.depth);

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

@@ -8959,7 +8959,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_checkDeepSleep__P83034.info = {"start":1087,"length":298,"line":36,"column":4,"endLine":46,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"checkDeepSleep","argumentNames":[]}
+power_checkDeepSleep__P83034.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__P83034_mk(s) {
     checkStack(s.depth);
@@ -9022,7 +9022,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_init__P83036.info = {"start":1610,"length":376,"line":57,"column":4,"endLine":66,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"init","argumentNames":[]}
+power_init__P83036.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__P83036_mk(s) {
     checkStack(s.depth);
@@ -12500,7 +12500,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_poke__P83033.info = {"start":795,"length":81,"line":26,"column":4,"endLine":29,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"poke","argumentNames":[]}
+power_poke__P83033.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__P83033_mk(s) {
     checkStack(s.depth);

package/libs/core/docs/reference/control/device-dal-version.md

@@ -0,0 +1,25 @@
+# device Dal Version
+
+Get the version information for the system software on the @boardname@.
+
+```sig
+control.deviceDalVersion()
+```
+
+## Returns
+
+* a [string](/types/string) that represents the version of the system software (DAL) on the board.
+
+Returns `"sim"` when running the simulator, and `"linux"` when running on Raspberry Pi.
+
+## Example #example
+
+Write the system software version to the serial port.
+
+```blocks
+serial.writeLine("DAL version = " + control.deviceDalVersion());
+```
+
+## See also #seealso
+
+[device serial number](/reference/control/device-serial-number)

package/libs/core/docs/reference/control/millis.md

@@ -0,0 +1,25 @@
+# millis
+
+Get the number of milliseconds of time passed since the board was turned on or last reset.
+
+```sig
+control.millis()
+```
+
+## Returns
+
+* the [number](/types/number) of milliseconds of time since the board was reset.
+
+## Example #example
+
+Find how many days, hours, minutes, and seconds the @boardname@ has been running.
+
+```blocks
+let msecs = control.millis()
+let seconds = msecs / 1000
+let mins = seconds / 60
+let hours = mins / 60
+let days = hours / 24
+```
+
+## #seealso

package/libs/core/docs/reference/control/pause-until.md

@@ -0,0 +1,31 @@
+# pause Until
+
+Pause a part of the program for some number of milliseconds.
+
+```sig
+control.pause(400)
+```
+
+When code in a block comes to a ``||control:pause until||``, it will wait the amount of time you tell it to. Code
+in blocks like ``||loops:forever||`` and ``||control:run in parallel||`` will keep running while code in some other
+block is waiting at a ``||control:pause||``.
+
+## Parameters
+
+* **ms**: the [number](/types/number) of milliseconds that you want to pause for. So, 100 milliseconds = 1/10 second, and 1000 milliseconds = 1 second.
+
+## Example #example
+
+Write the first five natural numbers to the console but wait one-half second between each write.
+
+```blocks
+for (let i = 0; i < 5; i++) {
+    console.logValue("naturals", i + 1)
+    control.pauseUntil(500)
+}
+```
+
+## See also #seealso
+
+[while](/blocks/loops/while), [for](/blocks/loops/for),
+[forever](/reference/loops/forever)

package/libs/core/docs/reference/control/raise-event.md

@@ -0,0 +1,61 @@
+# raise Event
+
+Announce that something happened at an event source.
+
+```sig
+control.raiseEvent(0, 0)
+```
+You use ``||control:raise event||`` to announce that something happened with the board or something special
+happened in your program. You do this if there are other parts of your program that might want
+to know about it.
+
+If you've added some [``||control:on event||``](/reference/control/on-event) blocks to your program,
+the code inside them will run if the **src** and **value** numbers are the same as those with
+``||control:raise event||``. The **src** tells about where the event is coming from. You pick a number
+for it to identify something like a sensor or a special situation in your program. If you want
+to announce that it's getting dark, you can make **src** something like `51` for the light sensor's
+source number. This means that anything you want to announce about the light sensor, you raise
+event with `51`.
+
+Many events can happen to a single source (**src**). With the light sensor you can announce that
+its getting darker or lighter. This is the cause of the event, the **value**. So, for the light
+sensor (the source number `51`) you might add two events for **value**: `1` for darker and `2` for lighter.
+
+With the light sensor example, you tell the program that it's getting darker:
+
+```block
+control.raiseEvent(51, 1)
+```
+
+## Parameters
+
+* **src**: the identification [number](/types/number) (the source) of this event, such as: `10`.
+* **value**: a [number](/types/number) tells what the cause of the event is, like: `4`.
+
+## Example #example
+
+Register two events coming from source `22`. Write to the console when
+the events of `0` and `1` are _raised_.
+
+```blocks
+const myNotify = 22;
+
+control.runInParallel(function() {
+    for (let i = 0; i < 2; i++) {
+        pause(1000);
+        control.raiseEvent(myNotify, i);
+    }
+})
+
+control.onEvent(myNotify, 0, () => {
+    console.logValue("myNotify", 0)
+})
+
+control.onEvent(myNotify, 1, () => {
+    console.logValue("myNotify", 1)
+})
+```
+
+## See also #seealso
+
+[on event](/reference/control/on-event), [wait for event](/reference/control/wait-for-event)

package/libs/core/docs/reference/control/reset.md

@@ -0,0 +1,20 @@
+# reset
+
+Reset the board and start the program from the beginning.
+
+```sig
+control.reset()
+```
+
+Everything that the program did with the board is set back to the way it was before the
+program started. The program starts over again from the beginning.
+
+## Example #example
+
+Reset the board and begin again.
+
+```blocks
+control.reset()
+```
+
+## #seealso

package/libs/core/docs/reference/control/seconds.md

@@ -0,0 +1,24 @@
+# millis
+
+Get the number of seconds of time passed since the board was turned on or last reset.
+
+```sig
+control.seconds()
+```
+
+## Returns
+
+* the [number](/types/number) of seconds of time since the board was reset.
+
+## Example #example
+
+Find how many days, hours, minutes, and seconds the @boardname@ has been running.
+
+```blocks
+let seconds = control.seconds()
+let mins = seconds / 60
+let hours = mins / 60
+let days = hours / 24
+```
+
+## #seealso

package/libs/core/docs/reference/control.md

@@ -0,0 +1,17 @@
+# Control
+
+Program controls and events.
+
+```cards
+control.millis()
+control.seconds()
+control.reset()
+control.deviceSerialNumber()
+```
+
+## Advanced #advanced
+
+```cards
+control.raiseEvent(0, 0)
+control.deviceDalVersion()
+```

package/libs/core/timer.ts

@@ -14,6 +14,7 @@ namespace control {
          * Gets the elapsed time in millis since the last reset
          */
         //% blockId=timerMillis block="%timer|millis"
+        //% help=control/millis
         millis(): number {
             return control.millis() - this.start;
         }
@@ -22,6 +23,7 @@ namespace control {
          * Gets the elapsed time in seconds since the last reset
          */
         //% blockId=timerSeconds block="%timer|seconds"
+        //% help=control/seconds
         seconds(): number {
             return this.millis() / 1000;
         }
@@ -30,6 +32,7 @@ namespace control {
          * Resets the timer
          */
         //% blockId=timerRest block="%timer|reset"
+        //% help=control/reset
         reset() {
             this.start = control.millis();
         }
@@ -39,6 +42,7 @@ namespace control {
          * @param ms how long to pause for, eg: 5, 100, 200, 500, 1000, 2000
          */
         //% blockId=timerPauseUntil block="%timer|pause until (ms) %ms"
+        //% help=control/pause-until
         pauseUntil(ms: number) {
             const remaining = this.millis() - ms;
             pause(Math.max(0, remaining));

package/libs/core---esp32/dal.d.ts

@@ -98,6 +98,8 @@ declare const enum DAL {
     CFG_PIN_WIFI_AT_TX = 91,
     CFG_PIN_WIFI_AT_RX = 92,
     CFG_PIN_USB_POWER = 93,
+    CFG_SETTINGS_SIZE_DEFL = 95,
+    CFG_SETTINGS_SIZE = 96,
     ACCELEROMETER_TYPE_LIS3DH = 50,
     ACCELEROMETER_TYPE_LIS3DH_ALT = 48,
     ACCELEROMETER_TYPE_MMA8453 = 56,

package/libs/core---esp32s2/dal.d.ts

@@ -98,6 +98,8 @@ declare const enum DAL {
     CFG_PIN_WIFI_AT_TX = 91,
     CFG_PIN_WIFI_AT_RX = 92,
     CFG_PIN_USB_POWER = 93,
+    CFG_SETTINGS_SIZE_DEFL = 95,
+    CFG_SETTINGS_SIZE = 96,
     ACCELEROMETER_TYPE_LIS3DH = 50,
     ACCELEROMETER_TYPE_LIS3DH_ALT = 48,
     ACCELEROMETER_TYPE_MMA8453 = 56,

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

@@ -7524,7 +7524,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_checkDeepSleep__P143656.info = {"start":1087,"length":298,"line":36,"column":4,"endLine":46,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"checkDeepSleep","argumentNames":[]}
+power_checkDeepSleep__P143656.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__P143656_mk(s) {
     checkStack(s.depth);
@@ -7587,7 +7587,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_init__P143658.info = {"start":1610,"length":376,"line":57,"column":4,"endLine":66,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"init","argumentNames":[]}
+power_init__P143658.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__P143658_mk(s) {
     checkStack(s.depth);
@@ -11999,7 +11999,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-power_poke__P143655.info = {"start":795,"length":81,"line":26,"column":4,"endLine":29,"endColumn":5,"fileName":"pxt_modules/power/power.ts","functionName":"poke","argumentNames":[]}
+power_poke__P143655.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__P143655_mk(s) {
     checkStack(s.depth);

package/libs/game/docs/reference/game/runtime.md

@@ -0,0 +1,46 @@
+# runtime
+
+Get the time since the game was started in milliseconds.
+
+```sig
+game.runtime()
+```
+
+## Returns
+
+* a [number](/types/number) that is the amount of time the game has run for.
+
+## Example #example
+
+Give a sprite warning message when the game runtime is greater that `15` minutes.
+
+```blocks
+info.startCountdown(30)
+let mySprite = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . 4 4 4 . . . . 4 4 4 . . . . 
+    . 4 5 5 5 e . . e 5 5 5 4 . . . 
+    4 5 5 5 5 5 e e 5 5 5 5 5 4 . . 
+    4 5 5 4 4 5 5 5 5 4 4 5 5 4 . . 
+    e 5 4 4 5 5 5 5 5 5 4 4 5 e . . 
+    . e e 5 5 5 5 5 5 5 5 e e . . . 
+    . . e 5 f 5 5 5 5 f 5 e . . . . 
+    . . f 5 5 5 4 4 5 5 5 f . f f . 
+    . . . 4 5 5 f f 5 5 6 f f 5 f . 
+    . . . f 6 6 6 6 6 6 4 f 5 5 f . 
+    . . . f 5 5 5 5 5 5 5 4 5 f . . 
+    . . . . f 5 4 5 f 5 f f f . . . 
+    . . . . . f f f f f f f . . . . 
+    `, SpriteKind.Player)
+game.onUpdateInterval(5000, function () {
+    if (game.runtime() > (1000 * 60 * 15)) {
+        mySprite.sayText("Time to quit!")
+    }
+})
+```
+
+## See also #seealso
+
+[start countdown](/reference/info/start-countdown),
+[change countdown by](/reference/info/change-countdown-by),
+[on countdown end](/reference/info/on-countdown-end)

package/libs/light/defaultlights.ts

@@ -23,6 +23,7 @@ namespace light {
      */
     //% blockId="builtinlightsetgradient" block="set gradient from %startRgb=colorNumberPicker to %endRgb=colorNumberPicker"
     //% weight=78 blockGap=8 blockHidden=true
+    //% help=light/neopixelstrip/set-gradient
     export function setGradient(startRgb: number, endRgb: number) {
         light.pixels.setGradient(startRgb, endRgb);
     }