pxt-common-packages 9.4.3 → 9.4.4

package/built/common-sim.d.ts

@@ -1119,6 +1119,14 @@ declare namespace pxsim.input {
     function onSwitchMoved(direction: number, body: RefAction): void;
     function switchRight(): boolean;
 }
+declare namespace pxsim.tts {
+    function _getLanguageCode(): string;
+    function _speakAsync(text: string, pitch?: number, rate?: number, volume?: number, language?: string, onStart?: RefAction, onBoundary?: RefAction): Promise<void>;
+    function _pause(): void;
+    function _isPaused(): boolean;
+    function _resume(): void;
+    function _cancel(): void;
+}
 declare namespace pxsim {
     interface TemperatureBoard extends CommonBoard {
         thermometerState: AnalogSensorState;

package/built/common-sim.js

@@ -4568,6 +4568,80 @@ var pxsim;
     })(input = pxsim.input || (pxsim.input = {}));
 })(pxsim || (pxsim = {}));
 var pxsim;
+(function (pxsim) {
+    var tts;
+    (function (tts) {
+        function _getLanguageCode() {
+            return window.navigator.language;
+        }
+        tts._getLanguageCode = _getLanguageCode;
+        function _speakAsync(text, pitch, rate, volume, language, onStart, onBoundary) {
+            return new Promise((resolve, reject) => {
+                const utterance = new SpeechSynthesisUtterance(text);
+                utterance.voice = getVoiceForLanguage(language || _getLanguageCode());
+                if (pitch != undefined)
+                    utterance.pitch = pitch;
+                if (rate != undefined)
+                    utterance.rate = rate;
+                if (volume != undefined)
+                    utterance.volume = volume;
+                utterance.onend = () => resolve();
+                utterance.onerror = reject;
+                if (onStart) {
+                    utterance.onstart = () => pxsim.runtime.runFiberAsync(onStart);
+                }
+                if (onBoundary) {
+                    utterance.onboundary = event => {
+                        const offset = event.charIndex;
+                        const nextWord = text.substring(offset).split(/\s/).shift();
+                        pxsim.runtime.runFiberAsync(onBoundary, offset, nextWord, text);
+                    };
+                }
+                speechSynthesis.speak(utterance);
+            });
+        }
+        tts._speakAsync = _speakAsync;
+        function _pause() {
+            speechSynthesis.pause();
+        }
+        tts._pause = _pause;
+        function _isPaused() {
+            return speechSynthesis.paused;
+        }
+        tts._isPaused = _isPaused;
+        function _resume() {
+            speechSynthesis.resume();
+        }
+        tts._resume = _resume;
+        function _cancel() {
+            speechSynthesis.cancel();
+        }
+        tts._cancel = _cancel;
+        function getVoiceForLanguage(language) {
+            language = language.toLowerCase();
+            const generalCode = language.substring(0, 2);
+            let bestMatch;
+            let bestNonlocalMatch;
+            for (const voice of speechSynthesis.getVoices()) {
+                const current = voice.lang.toLowerCase();
+                if (current === language) {
+                    if (voice.localService)
+                        return voice;
+                    else
+                        bestNonlocalMatch = voice;
+                }
+                else if (current.substring(0, 2) === generalCode) {
+                    if (!bestMatch && voice.localService)
+                        bestMatch = voice;
+                    if (!bestNonlocalMatch && !voice.localService)
+                        bestNonlocalMatch = voice;
+                }
+            }
+            return bestMatch || bestNonlocalMatch || (language !== "en-us" ? getVoiceForLanguage("en-US") : undefined);
+        }
+    })(tts = pxsim.tts || (pxsim.tts = {}));
+})(pxsim || (pxsim = {}));
+var pxsim;
 (function (pxsim) {
     function thermometerState() {
         return pxsim.board().thermometerState;

package/libs/game/docs/reference/scene/set-tile-at.md

@@ -3,15 +3,15 @@
 Set a tile at a location in the tilemap.
 
 ```sig
-tiles.setTileAt(null, tiles.getTileLocation(0, 0))
+tiles.setTileAt(tiles.getTileLocation(0, 0), null)
 ```
 
 You can set a tile at a specific column and row in the tilemap using a tile location object. Specify a tile to set in the tilemap and a location for it.
 
 ## Parameters
 
-* **tile**: the to set in the tilemap.
 * **loc**: a tile location in the tilemap.
+* **tile**: the to set in the tilemap.
 
 ## Example #example
 

package/libs/game/docs/reference/scene/tile-at-location-equals.md

@@ -3,7 +3,7 @@
 Check if a location in the tilemap contains the tile you're looking for.
 
 ```sig
-tiles.tileAtLocationEquals(location, null)
+tiles.tileAtLocationEquals(tiles.getTileLocation(0, 0), null)
 ```
 
 ## Parameters

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

@@ -36,13 +36,15 @@ mySprite.ax = 0
 
 * **value**: the new horizontal acceleration for the sprite in pixels per second, per second.
 
-## Sprite acceleration
+## Sprite horizontal acceleration
 
-Acceleration of a sprite makes it speed up or slow down. The value for acceleration determines how quickly the speed  of the sprite will change. A positive value makes the sprite speed up as it moves. A negative value causes the sprite to slow down while it moves.
+The value for acceleration determines how quickly the speed of the sprite will change. Acceleration of a sprite makes it speed up in a direction toward the right or left. A positive value causes the sprite's speed in the `right` direction to increase. A negative value causes the sprite's speed in the `left` direction to increase.
+
+Acceleration can be used as an opposing force too. If a sprite is travelling toward the right at a certain speed and a negative horizontal acceleration is applied, the sprite will keep moving to the right but it will slow down. When the sprite's speed reaches `0`, the sprite will begin to move to the left.
 
 ### ~ hint
 
-**How speed changes**
+#### How speed changes
 
 Speed, or velocity, is how much distance an object moves during some period of time. Distance in your game is measured in pixels so the speed of a sprite is in _pixels per second_. Speed is changed by _accelerating_ an object. In your game, a sprite is accelerated by some amount of change in speed per second. So, acceleration is measured in _pixels per second per second_.
 
@@ -131,6 +133,35 @@ game.onUpdateInterval(1000, function () {
 })
 ```
 
+### Opposite force #ex3
+
+Make a sprite move from the left side of the screen to the right side. Apply acceleration in the opposite direction to slow the sprite down and send back to the left.
+
+```blocks
+let mySprite = 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)
+mySprite.setStayInScreen(true)
+mySprite.left = 0
+mySprite.vx = 100
+mySprite.ax = -35
+```
+
 ## See also #seealso
 
 [ay](/reference/sprites/sprite/ay),

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

@@ -36,13 +36,16 @@ mySprite.ay = 0
 
 * **value**: the new vertical acceleration for the sprite in pixels per second, per second.
 
-## Sprite acceleration
+## Sprite vertical acceleration
+
+The value for acceleration determines how quickly the speed of the sprite will change. Acceleration of a sprite makes it speed up in a direction toward the bottom or top. A positive value causes the sprite's speed in the `bottom` direction to increase. A negative value causes the sprite's speed in the `top` direction to increase.
+
+Acceleration can be used as an opposing force too. If a sprite is travelling toward the bottom at a certain speed and a negative vertical acceleration is applied, the sprite will keep moving to the bottom but it will slow down. When the sprite's speed reaches `0`, the sprite will begin to move to the top.
 
-Acceleration of a sprite makes it speed up or slow down. The value for acceleration determines how quickly the speed  of the sprite will change. A positive value makes the sprite speed up as it moves. A negative value causes the sprite to slow down while it moves.
 
 ### ~ hint
 
-**How speed changes**
+#### How speed changes
 
 Speed, or velocity, is how much distance an object moves during some period of time. Distance in your game is measured in pixels so the speed of a sprite is in _pixels per second_. Speed is changed by _accelerating_ an object. In your game, a sprite is accelerated by some amount of change in speed per second. So, acceleration is measured in _pixels per second per second_.
 
@@ -129,6 +132,34 @@ game.onUpdateInterval(1000, function () {
     interval += 1
 })
 ```
+### Opposite force #ex3
+
+Make a sprite move from the top of the screen to the bottom. Apply acceleration in the opposite direction to slow the sprite down and send back to the top.
+
+```blocks
+let mySprite = 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)
+mySprite.setStayInScreen(true)
+mySprite.top = 0
+mySprite.vy = 80
+mySprite.ay = -35
+```
 
 ## See also #seealso
 

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

@@ -0,0 +1,123 @@
+# fy (property)
+
+Get or set the friction opposing a sprite's motion in the vertical direction.
+
+## Get
+
+Get the vertical friction on the sprite.
+
+```block
+let mySprite: Sprite = null
+
+let horzAccel = mySprite.fy
+```
+
+```typescript-ignorelet
+horzAccel = mySprite.fy
+```
+
+### Returns
+
+* a [number](/types/number) that is the current vertical friction of the sprite.
+
+## Set
+
+Set the vertical friction for the sprite.
+
+```block
+let mySprite: Sprite = null
+
+mySprite.fy = 0
+```
+
+```typescript-ignore
+mySprite.fy = 0
+```
+
+### Parameter
+
+* **value**: the new vertical friction opposing the sprite's motion in pixels per second, per second.
+
+## Sprite vertical friction
+
+Friction is an opposing force against the motion of a sprite. If a sprite has a vertical velocity (`vy`), it's friction will slow the sprite down until it's vertical velocity becomes `0`. This is similar to setting an opposite vertical acceleration but the opposite acceleration goes away once the sprite stops.
+
+## Examples #example
+
+### Measure stopping time #ex1
+
+Move the sprite from top to bottom across the screen. Use the correct amount of friction (`fy`) to make the sprite stop at `3` seconds.
+
+```blocks
+let stopTime = 0
+let counting = true
+let mySprite = 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)
+mySprite.setStayInScreen(true)
+mySprite.top = 0
+mySprite.fy = 20
+mySprite.vy = 60
+game.onUpdateInterval(100, function () {
+    if (counting) {
+        stopTime += 0.1
+        if (mySprite.vy == 0) {
+            counting = false
+            mySprite.sayText("" + stopTime + "sec", 5000, false)
+        }
+    }
+})
+```
+
+### Skipppng sprite #ex2
+
+Make a sprite move from the top to the bottom. Make it skip to the right once every second.
+
+```blocks
+let mySprite = 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)
+mySprite.setStayInScreen(true)
+mySprite.top = 0
+mySprite.fy = 60
+mySprite.vy = 60
+for (let index = 0; index < 3; index++) {
+    mySprite.vy = 60
+    pause(1000)
+}
+```
+
+## See also #seealso
+
+[fx](/reference/sprites/sprite/fx),
+[ay](/reference/sprites/sprite/ay)

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

@@ -0,0 +1,123 @@
+# fy (property)
+
+Get or set the friction opposing a sprite's motion in the horizontal direction.
+
+## Get
+
+Get the horizontal friction on the sprite.
+
+```block
+let mySprite: Sprite = null
+
+let horzAccel = mySprite.fx
+```
+
+```typescript-ignorelet
+horzAccel = mySprite.fx
+```
+
+### Returns
+
+* a [number](/types/number) that is the current horizontal friction of the sprite.
+
+## Set
+
+Set the horizontal friction for the sprite.
+
+```block
+let mySprite: Sprite = null
+
+mySprite.fx = 0
+```
+
+```typescript-ignore
+mySprite.fx = 0
+```
+
+### Parameter
+
+* **value**: the new horizontal friction opposing the sprite's motion in pixels per second, per second.
+
+## Sprite horizontal friction
+
+Friction is an opposing force against the motion of a sprite. If a sprite has a horizontal velocity (`vx`), it's friction will slow the sprite down until it's horizontal velocity becomes `0`. This is similar to setting an opposite horizontal acceleration but the opposite acceleration goes away once the sprite stops.
+
+## Examples #example
+
+### Measure stopping time #ex1
+
+Move the sprite from left to right across the screen. Use the correct amount of friction (`fx`) to make the sprite stop at `3` seconds.
+
+```blocks
+let stopTime = 0
+let counting = true
+let mySprite = 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)
+mySprite.setStayInScreen(true)
+mySprite.left = 0
+mySprite.fx = 30
+mySprite.vx = 90
+game.onUpdateInterval(100, function () {
+    if (counting) {
+        stopTime += 0.1
+        if (mySprite.vx == 0) {
+            counting = false
+            mySprite.sayText("" + stopTime + "sec", 5000, false)
+        }
+    }
+})
+```
+
+### Skipppng sprite #ex2
+
+Make a sprite move from the left to the right. Make it skip to the right once every second.
+
+```blocks
+let mySprite = 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)
+mySprite.setStayInScreen(true)
+mySprite.left = 0
+mySprite.fx = 80
+mySprite.vx = 80
+for (let index = 0; index < 3; index++) {
+    mySprite.vx = 80
+    pause(1000)
+}
+```
+
+## See also #seealso
+
+[fy](/reference/sprites/sprite/fy),
+[ax](/reference/sprites/sprite/ax)

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

@@ -58,6 +58,8 @@ sprites.onOverlap(0, 0, function (sprite, otherSprite) {})
 * [**vy- velocity y**](/reference/sprites/sprite/vy)
 * [**ax - acceleration x**](/reference/sprites/sprite/ax)
 * [**ay - acceleration y**](/reference/sprites/sprite/ay)
+* [**fx - friction x**](/reference/sprites/sprite/fx)
+* [**fy - friction y**](/reference/sprites/sprite/fy)
 
 ### Image and Attributes
 

package/libs/text-to-speech/pxt.json

@@ -0,0 +1,14 @@
+{
+    "name": "text-to-speech",
+    "description": "Browser-only text to speech support",
+    "files": [
+        "shims.d.ts",
+        "tts.ts"
+    ],
+    "testFiles": [
+    ],
+    "public": true,
+    "dependencies": {
+        "core": "file:../core"
+    }
+}

package/libs/text-to-speech/shims.d.ts

@@ -0,0 +1,47 @@
+//% icon="\uf075"
+//% color="#f59c16"
+//% block="Text to Speech"
+declare namespace tts {
+    //% shim=tts::_speakAsync promise
+    function speak(text: string, pitch?: number, rate?: number, volume?: number, language?: string, onStart?: () => void, onBoundary?: (offset: number, nextWord: string, fullText: string) => void): void;
+
+    //% shim=tts::_getLanguageCode
+    function getLanguageCode(): string;
+
+    /**
+     * Pauses the current text being spoken. Any calls waiting for the text to finish
+     * will not return until the text is either resumed or cancelled.
+     */
+    //% shim=tts::_pause
+    //% blockId=tts_pause
+    //% block="pause speech"
+    //% weight=90
+    function pause(): void;
+
+    /**
+     * Returns true if the text to speech is currently paused
+     */
+    //% shim=tts::_isPaused
+    //% blockId=tts_isPaused
+    //% block="is speech paused"
+    //% weight=60
+    function isPaused(): boolean;
+
+    /**
+     * Resumes the current text being spoken if in the paused state.
+     */
+    //% shim=tts::_resume
+    //% blockId=tts_resume
+    //% block="resume speech"
+    //% weight=80
+    function resume(): void;
+
+    /**
+     * Cancels all text currently being spoken and any that has been queued.
+     */
+    //% shim=tts::_cancel
+    //% blockId=tts_cancel
+    //% block="cancel speech"
+    //% weight=70
+    function cancel(): void;
+}

package/libs/text-to-speech/sim/tts.ts

@@ -0,0 +1,72 @@
+namespace pxsim.tts {
+    export function _getLanguageCode() {
+        return window.navigator.language;
+    }
+
+    export function _speakAsync(text: string, pitch?: number, rate?: number, volume?: number, language?: string, onStart?: RefAction, onBoundary?: RefAction): Promise<void> {
+        return new Promise<void>((resolve, reject) => {
+            const utterance = new SpeechSynthesisUtterance(text);
+            utterance.voice = getVoiceForLanguage(language || _getLanguageCode());
+
+            if (pitch != undefined) utterance.pitch = pitch;
+            if (rate != undefined) utterance.rate = rate;
+            if (volume != undefined) utterance.volume = volume;
+
+            utterance.onend = () => resolve();
+            utterance.onerror = reject;
+
+            if (onStart) {
+                utterance.onstart = () => runtime.runFiberAsync(onStart);
+            }
+
+            if (onBoundary) {
+                utterance.onboundary = event => {
+                    const offset = event.charIndex;
+                    const nextWord = text.substring(offset).split(/\s/).shift();
+
+                    runtime.runFiberAsync(onBoundary, offset, nextWord, text);
+                }
+            }
+
+            speechSynthesis.speak(utterance);
+        });
+    }
+
+    export function _pause() {
+        speechSynthesis.pause();
+    }
+
+    export function _isPaused(): boolean {
+        return speechSynthesis.paused;
+    }
+
+    export function _resume() {
+        speechSynthesis.resume();
+    }
+
+    export function _cancel() {
+        speechSynthesis.cancel();
+    }
+
+    function getVoiceForLanguage(language: string): SpeechSynthesisVoice {
+        language = language.toLowerCase();
+        const generalCode = language.substring(0, 2);
+
+        let bestMatch: SpeechSynthesisVoice;
+        let bestNonlocalMatch: SpeechSynthesisVoice;
+
+        for (const voice of speechSynthesis.getVoices()) {
+            const current = voice.lang.toLowerCase();
+            if (current === language) {
+                if (voice.localService) return voice;
+                else bestNonlocalMatch = voice;
+            }
+            else if (current.substring(0, 2) === generalCode) {
+                if (!bestMatch && voice.localService) bestMatch = voice;
+                if (!bestNonlocalMatch && !voice.localService) bestNonlocalMatch = voice
+            }
+        }
+
+        return bestMatch || bestNonlocalMatch || (language !== "en-us" ? getVoiceForLanguage("en-US") : undefined);
+    }
+}

package/libs/text-to-speech/tts.ts

@@ -0,0 +1,70 @@
+namespace tts {
+    class TextToSpeechState {
+        boundaryListeners: ((offset: number, nextWord: string, fullText: string) => void)[];
+
+        constructor() {
+            this.boundaryListeners = [];
+        }
+    }
+
+    let state: TextToSpeechState;
+
+    /**
+     * Runs code each time a word or sentence boundary is reached in text being spoken
+     */
+    //% blockId=tts_onWordSpoken
+    //% block="on word spoken from $fullText at $offset with $nextWord"
+    //% draggableParameters="reporter"
+    //% weight=10
+    export function onWordSpoken(handler: (offset: number, nextWord: string, fullText: string) => void) {
+        getState().boundaryListeners.push(handler);
+    }
+
+    /**
+     * Speak some text using the computer's text to speech voice and pause until the speaking has finished.
+     * If some text is already being spoken, this text will be queued until the other text finishes.
+     *
+     * @param text The text to speak
+     * @param volume The volume to speak at
+     * @param pitch A pitch modifier for moving the pitch of text up or down
+     * @param rate The rate at which the text will be spoken; higher is faster
+     * @param language The ISO language code for the text to be spoken; defaults to the system language
+     */
+    //% blockId=tts_speakText
+    //% block="speak $text||with volume $volume pitch $pitch rate $rate language $language"
+    //% inlineInputMode=inline
+    //% volume.min=0
+    //% volume.max=255
+    //% volume.defl=128
+    //% pitch.min=0
+    //% pitch.max=255
+    //% pitch.defl=128
+    //% rate.min=0
+    //% rate.max=255
+    //% rate.defl=25
+    //% weight=100
+    export function speakText(text: string, volume = 128, pitch = 128, rate = 25, language?: string) {
+        // Ranges from 0 to 1
+        volume = Math.map(Math.clamp(0, 255, volume), 0, 255, 0, 1);
+        // Ranges from 0 to 2
+        pitch = Math.map(Math.clamp(0, 255, pitch), 0, 255, 0, 2);;
+        // Ranges from 0.1 to 10
+        rate = Math.map(Math.clamp(0, 255, rate), 0, 255, 0.1, 10);
+
+        tts.speak(text, pitch, rate, volume, language, undefined, onBoundary);
+    }
+
+    function onBoundary(offset: number, nextWord: string, fullText: string) {
+        for (const handler of getState().boundaryListeners) {
+            control.runInParallel(() => handler(offset, nextWord, fullText))
+        }
+    }
+
+    function getState() {
+        if (!state) {
+            state = new TextToSpeechState();
+        }
+
+        return state;
+    }
+}

package/package.json

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