pxt-common-packages 9.3.12 → 9.4.3

package/libs/game/_locales/game-jsdoc-strings.json

@@ -57,6 +57,7 @@
   "Sprite.startEffect|param|effect": "the type of effect to create",
   "Sprite.tileHitFrom": "Get the obstacle sprite in a given direction if any",
   "Sprite.tileKindAt": "Get the tile kind in a given direction if any",
+  "Sprite.tilemapLocation": "Gets the tilemap location at the center of a sprite",
   "animation.animationPresets": "Generates a path string for preset animation",
   "animation.animationPresets|param|animationPath": "The preset path",
   "animation.runImageAnimation": "Create and run an image animation on a sprite",
@@ -272,6 +273,7 @@
   "sprites.createProjectileFromSide": "Create a new sprite with a given speed, and place it at the edge of the screen so it moves towards the middle.\nThe sprite auto-destroys when it leaves the screen. You can modify position after it's created.",
   "sprites.createProjectileFromSprite": "Create a new sprite with a given speed that starts from the location of another sprite.\nThe sprite auto-destroys when it leaves the screen. You can modify position after it's created.",
   "sprites.create|param|img": "the image",
+  "sprites.destroyAllSpritesOfKind": "Destroys all sprites of the given kind.",
   "sprites.onCreated": "Run code when a certain kind of sprite is created",
   "sprites.onCreated|param|kind": "@param sprite",
   "sprites.onDestroyed": "Run code when a certain kind of sprite is destroyed",
@@ -279,9 +281,12 @@
   "sprites.onOverlap": "Run code when two kinds of sprites overlap",
   "texteffects.TextSprite": "A text sprite on the screen",
   "tiles.Location": "A (col, row) location in the tilemap",
+  "tiles.Location.getNeighboringLocation": "Returns the neighboring location in a specifc direction from a location in a tilemap",
+  "tiles.Location.getNeighboringLocation|param|direction": "The direction to fetch the location in",
   "tiles.Location.place": "Center the given sprite on this tile",
   "tiles.Tile": "DEPRECATED: a tile in the tilemap",
   "tiles.Tile.place": "Center the given sprite on this tile",
+  "tiles._tilemapEditor": "A tilemap",
   "tiles.getRandomTileByType": "Get a random tile of the given type",
   "tiles.getRandomTileByType|param|tile": "the type of tile to get a random selection of",
   "tiles.getTileAt": "Get the image of a tile, given a (column, row) in the tilemap",
@@ -293,10 +298,14 @@
   "tiles.placeOnRandomTile|param|sprite": "@param tile",
   "tiles.placeOnTile": "Center the given sprite on a given location",
   "tiles.placeOnTile|param|sprite": "@param loc",
+  "tiles.setCurrentTilemap": "Sets the given tilemap to be the current active tilemap in the game\n* @param tilemap The tilemap to set as the current tilemap",
   "tiles.setTileAt": "Set a location in the map (column, row) to a tile",
   "tiles.setTileAt|param|loc": "@param tile",
   "tiles.setWallAt": "Set or unset a wall at a location in the map (column, row)",
   "tiles.setWallAt|param|loc": "@param on",
   "tiles.tileAtLocationEquals": "Returns true if the tile at the given location is the same as the given tile;\notherwise returns false",
-  "tiles.tileAtLocationEquals|param|location": "@param tile"
+  "tiles.tileAtLocationEquals|param|location": "@param tile",
+  "tiles.tileAtLocationIsWall": "Returns true if the tile at the given location is a wall in the current tilemap;\notherwise returns false",
+  "tiles.tileAtLocationIsWall|param|location": "The location to check for a wall",
+  "tiles.tileImageAtLocation": "Returns the image of the tile at the given location in the current tilemap\n* @param location The location of the image to fetch"
 }

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

@@ -71,6 +71,7 @@
   "Sprite.startEffect|block": "%sprite(mySprite) start %effect effect || for %duration=timePicker|ms",
   "Sprite.tileHitFrom|block": "%sprite(mySprite) wall hit on %direction",
   "Sprite.tileKindAt|block": "tile to $direction of $this(mySprite) is $tile",
+  "Sprite.tilemapLocation|block": "tilemap location of $this",
   "Sprite.top@set|block": "top",
   "Sprite.top|block": "top",
   "Sprite.vx@set|block": "vx (velocity x)",
@@ -236,6 +237,7 @@
   "sprites.createProjectileFromSprite|block": "projectile %img=screen_image_picker from %sprite=variables_get(mySprite) with vx %vx vy %vy",
   "sprites.createProjectile|block": "projectile %img=screen_image_picker vx %vx vy %vy of kind %kind=spritekind||from sprite %sprite=variables_get(mySprite)",
   "sprites.create|block": "sprite %img=screen_image_picker of kind %kind=spritekind",
+  "sprites.destroyAllSpritesOfKind|block": "destroy all sprites of kind $kind || with $effect effect for $duration ms",
   "sprites.onCreated|block": "on created $sprite of kind $kind=spritekind",
   "sprites.onDestroyed|block": "on destroyed $sprite of kind $kind=spritekind ",
   "sprites.onOverlap|block": "on $sprite of kind $kind=spritekind overlaps $otherSprite of kind $otherKind=spritekind",
@@ -244,15 +246,28 @@
   "texteffects.TextEffectKind.Shake|block": "shake",
   "texteffects.TextEffectKind.Wave|block": "wave",
   "texteffects|block": "texteffects",
+  "tiles.Location.bottom|block": "bottom",
+  "tiles.Location.column|block": "column",
+  "tiles.Location.getNeighboringLocation|block": "tilemap location $direction of $this",
+  "tiles.Location.left|block": "left",
+  "tiles.Location.right|block": "right",
+  "tiles.Location.row|block": "row",
+  "tiles.Location.top|block": "top",
+  "tiles.Location.x|block": "x",
+  "tiles.Location.y|block": "y",
   "tiles.Tile.place|block": "on top of %tile(myTile) place %sprite=variables_get(mySprite)",
+  "tiles._tilemapEditor|block": "tilemap $tilemap",
   "tiles.getTileLocation|block": "tilemap col $col row $row",
   "tiles.getTilesByType|block": "array of all $tile locations",
   "tiles.placeOnRandomTile|block": "place $sprite=variables_get(mySprite) on top of random $tile",
   "tiles.placeOnTile|block": "place $sprite=variables_get(mySprite) on top of $loc",
+  "tiles.setCurrentTilemap|block": "set tilemap to $tilemap",
   "tiles.setTileAt|block": "set $tile at $loc=mapgettile",
   "tiles.setTilemap|block": "set tilemap to $tilemap",
   "tiles.setWallAt|block": "set wall $on at $loc",
   "tiles.tileAtLocationEquals|block": "tile at $location is $tile",
+  "tiles.tileAtLocationIsWall|block": "tile at $location is wall",
+  "tiles.tileImageAtLocation|block": "tile image at $location",
   "tiles|block": "tiles",
   "{id:category}Animation": "Animation",
   "{id:category}ArcadePhysicsEngine": "ArcadePhysicsEngine",
@@ -274,7 +289,6 @@
   "{id:category}Tiles": "Tiles",
   "{id:group}Animate": "Animate",
   "{id:group}Camera": "Camera",
-  "{id:group}Collisions": "Collisions",
   "{id:group}Countdown": "Countdown",
   "{id:group}Create": "Create",
   "{id:group}Dialogs": "Dialogs",
@@ -283,6 +297,7 @@
   "{id:group}Image": "Image",
   "{id:group}Life": "Life",
   "{id:group}Lifecycle": "Lifecycle",
+  "{id:group}Locations": "Locations",
   "{id:group}Multiplayer": "Multiplayer",
   "{id:group}Overlaps": "Overlaps",
   "{id:group}Physics": "Physics",
@@ -292,5 +307,6 @@
   "{id:group}Screen": "Screen",
   "{id:group}Single Player": "Single Player",
   "{id:group}Theme": "Theme",
-  "{id:group}Tiles": "Tiles"
+  "{id:group}Tilemap Operations": "Tilemap Operations",
+  "{id:group}Tilemaps": "Tilemaps"
 }

package/libs/game/assetTemplates.ts

@@ -1,5 +1,6 @@
 //% helper=getTilemapByName
 //% pyConvertToTaggedTemplate
+//% blockIdentity="tiles._tilemapEditor"
 function tilemap(lits: any, ...args: any[]): tiles.TileMapData { return null }
 
 //% helper=getTilemapByName
@@ -17,6 +18,7 @@ function tilemap32(lits: any, ...args: any[]): tiles.TileMapData { return null }
 namespace assets {
     //% helper=getTilemapByName
     //% pyConvertToTaggedTemplate
+    //% blockIdentity="tiles._tilemapEditor"
     export function tilemap(lits: any, ...args: any[]): tiles.TileMapData { return null }
 
     //% helper=getImageByName