@xtia/grid 0.1.1 → 0.2.0

package/README.md

@@ -43,7 +43,7 @@ const source = imagePipe
 	.crop(10, 10, 64, 64)
 	.scale(.5)
 	.rotateLeft();
-const grid = Grid.from(source);
+const grid = Grid.init(source);
 ```
 
 ### Wrapping existing structures
@@ -97,7 +97,7 @@ world.writeMask(mask).fill("mountain");
 const lakeRegion = world.region(25, 25, 30, 30);
 
 // do we want a distinct, self-contained copy of the region?
-const lakeGrid = Grid.from(lakeRegion);
+const lakeGrid = Grid.init(lakeRegion);
 ```
 
 ## Transformation Layers
@@ -225,9 +225,9 @@ Unlike visibility maps, which are lazily evaluated according to the supplied `is
 
 ## The storage layer
 
-`Grid` itself is an interface for reading and writing 2D data. `GridBase` - a subclass of `Grid` - maintains the actual storage of such data.
+`Grid` itself is an interface that sits on top of a synchronous 2D read/write mechanism. `GridBase` is a subclass of `Grid` with built-in storage.
 
-Although the Grid factory methods (`Grid.solid<T>()`, `Grid.from<T>()`, `Grid.init<T>()`) belong to `Grid`, they return a `GridBase<T>`. `Grid.wrap<T>()` is an exception, returning `Grid<T>`, as it uses a storage layer provided by the user. The only API distinction is that `GridBase` provides a 'change' event, via `grid.on("change", handler)`.
+Although the factory methods `Grid.solid<T>()` and `Grid.init<T>()`) belong to `Grid`, they return a `GridBase<T>`. `Grid.wrap<T>()` is an exception, returning `Grid<T>`, as it uses a storage layer provided by the user. The only API distinction is that `GridBase` provides a 'change' event, via `grid.on("change", handler)`.
 
 We can perform batched updates, suppressing the 'change' event until a process concludes, with `grid.batchUpdate(callback)`.
 
@@ -238,7 +238,7 @@ Pipe2D makes it easy to save and restore grid data:
 ```ts
 const snapshot = world.pipe.stash();
 
-const restored = Grid.from(snapshot);
+const restored = Grid.init(snapshot);
 // or paste it to an existing grid
 world.paste(snapshot);
 ```

package/lib/grid.d.ts

@@ -73,7 +73,7 @@ export declare class Grid<T> {
     region(x: number, y: number, width: number, height: number): Grid<T>;
     scroll(xDelta: number, yDelta: number, fill: T): this;
     static init<T>(width: number, height: number, initCell: (x: number, y: number) => T): GridBase<T>;
-    static from<T>(source: Source2D<T>): GridBase<T>;
+    static init<T>(source: Source2D<T>): GridBase<T>;
     static solid<T>(width: number, height: number, fillValue: T): GridBase<T>;
     static wrap<T>(width: number, height: number, get: (x: number, y: number) => T, set: (x: number, y: number, value: T) => void, batch?: (callback: () => void) => void): Grid<T>;
 }

package/lib/grid.js

@@ -342,16 +342,15 @@ export class Grid {
         }
         return this;
     }
-    static init(width, height, initCell) {
+    static init(widthOrSource, height, initCell) {
+        if (typeof widthOrSource == "object")
+            return new GridBase(widthOrSource);
         return new GridBase({
-            width,
-            height,
+            width: widthOrSource,
+            height: height,
             get: initCell
         });
     }
-    static from(source) {
-        return new GridBase(source);
-    }
     static solid(width, height, fillValue) {
         return new GridBase(Pipe2D.solid(fillValue, width, height));
     }

package/package.json

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