@xtia/grid 0.0.4 → 0.0.5

package/README.md

@@ -22,7 +22,7 @@ npm i @xtia/grid
 ```
 
 ```ts
-import { Grid } from "@xtia/grid";
+import { Grid } from "@xtia/grid"; // ~5.3kb gzipped
 
 // initialise a 30x20 Grid<number> of 0's
 const numGrid = Grid.solid(30, 20, 0);
@@ -74,12 +74,12 @@ const lakeGrid = Grid.from(lakeRegion);
 
 ## Transformation Layers
 
-`grid.map(read, write)` creates a **view** that reads and writes the parent through the provided transformation functions.
+`grid.map(read, write)` creates a **zero-copy view** that reads and writes the parent through the provided transformation functions.
 
 ```ts
 const spriteMap = world.map(
 	type => type + ".png",
-	sprite => sprite.replace(/\.*/, '')
+	sprite => sprite.replace(/\..*/, '')
 );
 
 world.set(0, 0, "mountain"); // modify the parent
@@ -90,6 +90,20 @@ console.log(world.get(1, 0)); // read the parent: "forest"
 
 For one-way read-mapping, use `grid.pipe` - a [Pipe2D](https://github.com/tiadrop/pipe2d) view into the grid's data.
 
+```ts
+// create a one-way, player-centred sprite map
+const viewport = world.pipe
+	.oob("mountain")
+	.map(t => t + ".png")
+	.crop(playerX - 5, playerY - 5, 10, 10);
+
+// or get a list of locations of cells with mountains
+const mountainCells = world.cells.toFlatArrayXY()
+	.filter(cell => cell.value === "mountain")
+	.map(cell => [cell.x, cell.y]);
+
+```
+
 ## Cell interface
 
 `grid.cells` provides a Pipe2D, for convenient transformation, of live-view interfaces relating to positions in the grid.
@@ -98,12 +112,12 @@ For one-way read-mapping, use `grid.pipe` - a [Pipe2D](https://github.com/tiadro
 const topLeft = world.cells.get(0, 0);
 console.log(topLeft.value); // "mountain"
 
-topLeft.value = "forest; // modifies the underlying data
+topLeft.value = "forest"; // modifies the underlying data
 console.log(spriteMap.get(0, 0)); // now "forest.png";
 
 // navigate by offset
 const adjacentCell = topLeft.look(1, 0);
-console.log(adjacentCell.x, adjacentCell.y); // 1, 0
+console.log(adjacentCell?.x, adjacentCell?.y); // 1, 0
 ```
 
 Cells provide methods for locational utilities such as pathfinding and visibility mapping.
@@ -149,9 +163,6 @@ const visibility = start.createVisibilityMap(
 // any 2d source, including visibility maps, can be used as a mask for paste/fill operations
 // paste(source: Source2D<T>, mask?: Source2D<boolean>)
 screenGrid.paste(spriteMap, visibility);
-
-// using pipe2d's convenience
-const mountainCells = world.cells.toFlatArrayXY().filter(c => c.value === "mountain");
 ```
 
 ### Reusing path data
@@ -173,4 +184,15 @@ Unlike visibility maps, which are lazily evaluated according to the supplied `is
 
 Although the Grid factory methods (`Grid.solid()`, `Grid.from()`, `Grid.init()`) return a `GridBase<T>`, the mental model is that we're simply working with `Grid`s, therefore those factory methods live on `Grid`. The only API distinction is that `GridBase` provides a 'change' event, via `grid.on("change", handler)`.
 
-You can perform batched updates, holding off the 'change' event until the batch process concludes, with `grid.batchUpdate(callback)`.
+You can perform batched updates, holding off the 'change' event until the batch process concludes, with `grid.batchUpdate(callback)`.
+
+## Save and load
+
+Pipe2D makes it easy to save and restore grid data:
+
+```ts
+const saved = world.pipe.toFlatArrayXY(); // ["mountain", "forest", "grass", ...]
+
+const restoredPipe = Pipe2D.fromFlatArrayXY(saved);
+const restored = Grid.from(restoredPipe);
+```

package/lib/grid.js

@@ -132,7 +132,7 @@ export class Cell {
                 return path;
             });
         }
-        return this.gridView.cells.map((c => { var _a; return (_a = costs.get(c)) !== null && _a !== void 0 ? _a : Infinity; }))
+        return this.gridView.cells.map(costs, () => Infinity)
             .strict();
     }
     *getLineTo(target) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "2D store and utilities, with zero-copy regions and transform layers, pathfinding, Pipe2D interop",
   "name": "@xtia/grid",
   "exports": {