@xtia/grid 0.0.10 → 0.0.11

package/README.md

@@ -91,7 +91,7 @@ const mask = (x: number, y: number) => {
   const dist = Math.hypot(x - centre.x, y - centre.y);
   return dist > 12 && dist < 18; // mountain ring
 };
-world.fill("mountain", mask);
+world.writeMask(mask).fill("mountain");
 
 // get a view of just the interesting area
 const lakeRegion = world.region(25, 25, 30, 30);
@@ -203,9 +203,8 @@ const visibility = start.createVisibilityMap(
 	cell => cell.value === "grass" // anything except grass blocks vision
 );
 
-// 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, 0, 0, visibility);
+// writeMask() creates a live view that only allows writes at positions allowed by the mask Source2D/function
+screenGrid.writeMask(visibility).paste(spriteMap, 0, 0);
 ```
 
 ### Reusing path data
@@ -234,8 +233,17 @@ We can perform batched updates, suppressing the 'change' event until a process c
 Pipe2D makes it easy to save and restore grid data:
 
 ```ts
-const saved = world.pipe.toFlatArrayXY(); // ["mountain", "forest", "grass", ...]
+const snapshot = world.pipe.stash();
 
-const restoredPipe = Pipe2D.fromFlatArrayXY(saved);
-const restored = Grid.from(restoredPipe);
-```
+const restored = Grid.from(snapshot);
+// or paste it to an existing grid
+world.paste(snapshot);
+```
+
+For persistent storage or transmission, Pipe2D can export as array:
+
+```ts
+const saved = snapshot.toFlatArrayXY(); // ["mountain", "forest", "grass", ...]
+
+const restoredSnapshot = Pipe2D.fromFlatArrayXY(saved);
+```

package/lib/grid.d.ts

@@ -64,8 +64,9 @@ export declare class Grid<T> {
     get(x: number, y: number): T;
     set(x: number, y: number, value: T): void;
     trySet(x: number, y: number, value: T): boolean;
-    fill(value: T, mask?: Source2D<boolean> | GetXYFunc<boolean>): void;
-    paste(source: Source2D<T>, x?: number, y?: number, mask?: Source2D<boolean> | GetXYFunc<boolean>): void;
+    fill(value: T): void;
+    paste(source: Source2D<T>, x?: number, y?: number): void;
+    writeMask(mask: Source2D<boolean> | GetXYFunc<boolean>): Grid<T>;
     [Symbol.iterator](): IterableIterator<{
         x: number;
         y: number;

package/lib/grid.js

@@ -245,41 +245,36 @@ export class Grid {
         this.set(x, y, value);
         return true;
     }
-    fill(value, mask) {
-        const maskSource = typeof mask == "function" ? {
-            width: this.width,
-            height: this.height,
-            get: mask
-        } : mask;
+    fill(value) {
         this.batchUpdate(() => {
             for (let y = 0; y < this.height; y++) {
                 for (let x = 0; x < this.width; x++) {
-                    if (maskSource && !maskSource.get(x, y))
-                        continue;
                     this.trySet(x, y, value);
                 }
             }
         });
     }
-    paste(source, x = 0, y = 0, mask) {
-        const maskSource = typeof mask == "function" ? {
-            width: this.width,
-            height: this.height,
-            get: mask
-        } : mask;
+    paste(source, x = 0, y = 0) {
         const cachedSource = new GridBase(source);
         this.batchUpdate(() => {
             for (let oy = 0; oy < source.height; oy++) {
                 for (let ox = 0; ox < source.width; ox++) {
-                    const tx = ox + x;
-                    const ty = oy + y;
-                    if (maskSource && !maskSource.get(tx, ty))
-                        continue;
-                    this.trySet(tx, ty, cachedSource.get(ox, oy));
+                    this.trySet(ox + x, oy + y, cachedSource.get(ox, oy));
                 }
             }
         });
     }
+    writeMask(mask) {
+        const getMask = typeof mask == "function"
+            ? mask
+            : (x, y) => mask.get(x, y);
+        return new Grid(this.width, this.height, this.parentGet, (x, y, v) => {
+            const writable = getMask(x, y);
+            if (writable) {
+                this.set(x, y, v);
+            }
+        }, cb => this.batch(cb));
+    }
     *[Symbol.iterator]() {
         for (let y = 0; y < this.height; y++) {
             for (let x = 0; x < this.width; x++) {

package/package.json

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