minerender 1.4.11 → 2.0.0-alpha.1

package/src/util/util.js

@@ -0,0 +1,117 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toDegrees = exports.toRadians = exports.base64decode = exports.base64encode = exports.sha512 = exports.sha256 = exports.sha1 = exports.md5 = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const browserCrypto = __importStar(require("crypto-js"));
+const core_1 = __importDefault(require("crypto-js/core"));
+function md5(str) {
+    if (typeof browserCrypto !== "undefined") {
+        return browserCrypto.MD5(str).toString(core_1.default.enc.Hex);
+    }
+    return crypto_1.default.createHash('md5').update(str).digest("hex");
+}
+exports.md5 = md5;
+function sha1(str) {
+    if (typeof browserCrypto !== "undefined") {
+        return browserCrypto.SHA1(str).toString(core_1.default.enc.Hex);
+    }
+    return crypto_1.default.createHash('sha1').update(str).digest("hex");
+}
+exports.sha1 = sha1;
+function sha256(str) {
+    if (typeof browserCrypto !== "undefined") {
+        return browserCrypto.SHA256(str).toString(core_1.default.enc.Hex);
+    }
+    return crypto_1.default.createHash('sha256').update(str).digest("hex");
+}
+exports.sha256 = sha256;
+function sha512(str) {
+    if (typeof browserCrypto !== "undefined") {
+        return browserCrypto.SHA512(str).toString(core_1.default.enc.Hex);
+    }
+    return crypto_1.default.createHash('sha512').update(str).digest("hex");
+}
+exports.sha512 = sha512;
+function base64encode(str) {
+    if (typeof btoa !== "undefined") {
+        return btoa(str);
+    }
+    return Buffer.from(str).toString("base64");
+}
+exports.base64encode = base64encode;
+function base64decode(str) {
+    if (typeof atob !== "undefined") {
+        return atob(str);
+    }
+    return Buffer.from(str, "base64").toString("ascii");
+}
+exports.base64decode = base64decode;
+function toRadians(degrees) {
+    return degrees * Math.PI / 180;
+}
+exports.toRadians = toRadians;
+function toDegrees(radians) {
+    return radians * 180 / Math.PI;
+}
+exports.toDegrees = toDegrees;
+(function () {
+    const source = [
+        "https://threejs.org/docs/#api/en/textures/Texture",
+        "https://www.npmjs.com/package/md5",
+        "a JavaScript function for hashing messages with MD5.\nnode-md5 is being sponsored by the following tool; please help to support us by taking a look and signing up to a free trial",
+        "Before version 2.0.0 there were two packages called md5 on npm, one lowercase, one uppercase (the one you're looking at). As of version 2.0.0, all new versions of this module will go to lowercase md5 on npm. To use the correct version, users of this module will have to change their code from require('MD5') to require('md5') if they want to use versions >= 2.0.0.",
+        "Redistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:",
+        "THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\n" +
+            "ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\n" +
+            "WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\n" +
+            "DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR\n" +
+            "ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n" +
+            "(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n" +
+            "LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON\n" +
+            "ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n" +
+            "(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\n" +
+            "SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+    ];
+    const it = 100000;
+    let noneStart = Date.now();
+    for (let i = 0; i < it; i++) {
+        let none = "" + source[i % source.length];
+    }
+    let noneEnd = Date.now();
+    console.log("none: " + (noneEnd - noneStart));
+    let hashStart = Date.now();
+    for (let i = 0; i < it; i++) {
+        let hash = "" + md5(source[i % source.length]);
+    }
+    let hashEnd = Date.now();
+    console.log("hash: " + (hashEnd - hashStart));
+    let baseStart = Date.now();
+    for (let i = 0; i < it; i++) {
+        let base = "" + base64encode(source[i % source.length]);
+    }
+    let baseEnd = Date.now();
+    console.log("base64: " + (baseEnd - baseStart));
+})();
+//# sourceMappingURL=util.js.map

package/src/util/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"./","sources":["src/util/util.ts"],"names":[],"mappings":"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"}

package/src/util/util.ts

@@ -0,0 +1,120 @@
+import crypto from "crypto";
+import * as browserCrypto from "crypto-js";
+import CryptoJS from "crypto-js/core";
+import exp from "constants";
+import { MeshBasicMaterial, Vector3 } from "three";
+
+export const changeEvent = { type: 'change'};
+
+export type Maybe<T> = T | undefined;
+
+export function md5(str: string): string {
+    if (typeof browserCrypto !== "undefined") {
+        return browserCrypto.MD5(str).toString(CryptoJS.enc.Hex);
+    }
+    return crypto.createHash('md5').update(str).digest("hex");
+}
+
+export function sha1(str: string): string {
+    if (typeof browserCrypto !== "undefined") {
+        return browserCrypto.SHA1(str).toString(CryptoJS.enc.Hex);
+    }
+    return crypto.createHash('sha1').update(str).digest("hex");
+}
+
+export function sha256(str: string): string {
+    if (typeof browserCrypto !== "undefined") {
+        return browserCrypto.SHA256(str).toString(CryptoJS.enc.Hex);
+    }
+    return crypto.createHash('sha256').update(str).digest("hex");
+}
+
+export function sha512(str: string): string {
+    if (typeof browserCrypto !== "undefined") {
+        return browserCrypto.SHA512(str).toString(CryptoJS.enc.Hex);
+    }
+    return crypto.createHash('sha512').update(str).digest("hex");
+}
+
+export function base64encode(str: string): string {
+    if (typeof btoa !== "undefined") {
+        return btoa(str);
+    }
+    return Buffer.from(str).toString("base64");
+}
+
+export function base64decode(str: string): string {
+    if (typeof atob !== "undefined") {
+        return atob(str);
+    }
+    return Buffer.from(str, "base64").toString("ascii");
+}
+
+export function toRadians(degrees: number): number {
+    return degrees * Math.PI / 180;
+}
+
+export function toDegrees(radians: number): number {
+    return radians * 180 / Math.PI;
+}
+
+export async function sleep(timeout: number): Promise<void> {
+    return new Promise(resolve => {
+        setTimeout(() => resolve(), timeout);
+    });
+}
+
+export function clampRotationDegrees(deg: number): number {
+    return deg % 360;
+}
+
+export function isVector3(obj: any): obj is Vector3 {
+    return (<Vector3>obj).isVector3;
+}
+
+export type DeepPartial<T> = {
+    [P in keyof T]?: DeepPartial<T[P]>;
+};
+
+(function () {
+    const source = [
+        "https://threejs.org/docs/#api/en/textures/Texture",
+        "https://www.npmjs.com/package/md5",
+        "a JavaScript function for hashing messages with MD5.\nnode-md5 is being sponsored by the following tool; please help to support us by taking a look and signing up to a free trial",
+        "Before version 2.0.0 there were two packages called md5 on npm, one lowercase, one uppercase (the one you're looking at). As of version 2.0.0, all new versions of this module will go to lowercase md5 on npm. To use the correct version, users of this module will have to change their code from require('MD5') to require('md5') if they want to use versions >= 2.0.0.",
+        "Redistribution and use in source and binary forms, with or without modification,\nare permitted provided that the following conditions are met:",
+        "THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\n" +
+        "ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\n" +
+        "WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\n" +
+        "DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR\n" +
+        "ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n" +
+        "(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;\n" +
+        "LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON\n" +
+        "ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\n" +
+        "(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS\n" +
+        "SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+    ];
+    const it = 100000;
+
+    let noneStart = Date.now();
+    for (let i = 0; i < it; i++) {
+        let none = "" + source[i % source.length];
+    }
+    let noneEnd = Date.now();
+    console.log("none: " + (noneEnd - noneStart));
+
+    let hashStart = Date.now();
+    for (let i = 0; i < it; i++) {
+        let hash = "" + md5(source[i % source.length]);
+    }
+    let hashEnd = Date.now();
+    console.log("hash: " + (hashEnd - hashStart));
+
+    let baseStart = Date.now();
+    for (let i = 0; i < it; i++) {
+        let base = "" + base64encode(source[i % source.length]);
+    }
+    let baseEnd = Date.now();
+    console.log("base64: " + (baseEnd - baseStart));
+
+})();

package/src/world/BlockInfo.ts

@@ -0,0 +1,7 @@
+import { Block } from "../model/block/Block";
+import { BlockObject } from "../model/block/scene/BlockObject";
+
+export interface BlockInfo {
+    block: Block;
+    object: BlockObject;
+}

package/src/world/Chunk.ts

@@ -0,0 +1,165 @@
+import { Block } from "../model/block/Block";
+import { BlockObject, isBlockObject } from "../model/block/scene/BlockObject";
+import { Box3, Object3D, Vector3 } from "three";
+import { Maybe } from "../util/util";
+import { BlockInfo } from "./BlockInfo";
+import { del } from "node-persist";
+import { MineRenderScene } from "../renderer/MineRenderScene";
+import { BlockStates } from "../assets/BlockStates";
+import { AssetKey } from "../assets/AssetKey";
+import { MineRenderWorld } from "./MineRenderWorld";
+import { isTripleArray, TripleArray } from "../model/Model";
+import { addBox3WireframeToObject } from "../util/model";
+import webpack from "webpack";
+import { prefix } from "../util/log";
+
+const p = prefix("Chunk");
+
+export class Chunk {
+
+    public readonly scene: MineRenderScene; //TODO: should probably be the world
+
+    public readonly x: number;
+    public readonly y: number;
+    public readonly z: number;
+
+    private readonly _blocks: BlockInfo[] = [];
+
+    private readonly _anchor: Object3D;
+
+    constructor(scene: MineRenderScene, x: number, y: number, z: number) {
+        this.scene = scene;
+        this.x = x;
+        this.y = y;
+        this.z = z;
+
+        //TODO: option to visualize chunks
+        let anchor = new Object3D();
+        this._anchor = anchor;
+        scene.add(anchor)
+        anchor.position.set((this.x * 256) + 128 - 8, (this.y * 256) + 128 - 8, (this.z * 256) + 128 - 8);
+        addBox3WireframeToObject(
+            new Box3(new Vector3(0, 0, 0), new Vector3(256, 256, 256)),
+            anchor,
+            0xffff00,
+            4);
+    }
+
+    public getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo>;
+    public getBlockAt(pos: Vector3): Maybe<BlockInfo>;
+    public getBlockAt(pos: TripleArray): Maybe<BlockInfo>;
+    public getBlockAt(posOrX: number | Vector3 | TripleArray, y?: number, z?: number): Maybe<BlockInfo> {
+        if (typeof posOrX == "number") {
+            return this.getBlockAt(new Vector3(posOrX, y, z));
+        }
+        if (isTripleArray(posOrX)) {
+            return this.getBlockAt(new Vector3(posOrX[0], posOrX[1], posOrX[2]))
+        }
+        const pos: Vector3 = this.worldPosToChunkPos(posOrX);
+        const index = Chunk.chunkPosToBlockIndex(pos);
+        return this._blocks[index];
+    }
+
+    /**
+     * Set block at a _world_ position
+     */
+    public async setBlockAt(x: number, y: number, z: number, block: Maybe<Block>): Promise<Maybe<BlockInfo>>;
+    public async setBlockAt(pos: Vector3, block: Maybe<Block>): Promise<Maybe<BlockInfo>>;
+    public async setBlockAt(pos: TripleArray, block: Maybe<Block>): Promise<Maybe<BlockInfo>>;
+    public async setBlockAt(posOrX: number | Vector3 | TripleArray, yOrBlock?: number | Block, z?: number, block?: Block): Promise<Maybe<BlockInfo>> {
+        if (typeof posOrX == "number") {
+            return this.setBlockAt(new Vector3(posOrX, yOrBlock as number, z), block as Block);
+        }
+        if (isTripleArray(posOrX)) {
+            return this.setBlockAt(new Vector3(posOrX[0], posOrX[1], posOrX[2]), yOrBlock as Block);
+        }
+        const worldPos: Vector3 = posOrX;
+        const pos: Vector3 = this.worldPosToChunkPos(worldPos);
+        block = yOrBlock as Block;
+
+        return this.setBlockInChunkAt(pos, block, worldPos);
+    }
+
+    /**
+     * Set block at a _chunk_ position (0-16)
+     */
+    public async setBlockInChunkAt(pos: Vector3, block?: Block,  worldPos?: Vector3): Promise<Maybe<BlockInfo>> {
+        if (typeof worldPos === "undefined") {
+            worldPos = this.chunkPosToWorldPos(pos);
+        }
+
+        const index = Chunk.chunkPosToBlockIndex(pos);
+        const current = this._blocks[index];
+        if (typeof current !== "undefined") {
+            console.debug(p, "deleting existing block at", pos, worldPos, index);
+            // current.object.setScale(new Vector3(0, 0, 0));//TODO
+            current.object.removeFromScene();
+            delete this._blocks[index];
+        }
+
+        if (typeof block === "undefined" || typeof block.type === "undefined" || block.type === "air") return undefined; // only delete block
+
+        const blockState = await BlockStates.get(AssetKey.parse("blockstates", block.type));
+        if (blockState) {
+            const blockObject: BlockObject = await this.scene.addBlock(blockState, {
+                mergeMeshes: true,
+                instanceMeshes: true,
+                wireframe: true,
+                maxInstanceCount: 2000 //TODO: setting this to high kills FPS; increase on demand somehow?
+            }) as BlockObject;//TODO
+            if (block.properties) {
+                await blockObject.setState(block.properties);
+            }
+
+            const scenePos = MineRenderWorld.worldToScenePosition(worldPos);
+            blockObject.setPosition(scenePos);
+
+            this._blocks[index] = {
+                block: block,
+                object: blockObject as BlockObject
+            }
+            return this._blocks[index];
+        }
+        return undefined;
+    }
+
+    public async clear(): Promise<void> {
+        let promises: Promise<any>[] = [];
+        let pos = new Vector3();
+        for (let x = 0; x < 16; x++) {
+            for (let z = 0; z < 16; z++) {
+                for (let y = 0; y < 16; y++) {
+                    promises.push(this.setBlockInChunkAt(pos.set(x,y,z), undefined));
+                }
+            }
+        }
+        return Promise.all(promises).then(ignored => {
+        });
+    }
+
+    public async dispose(): Promise<void> {
+        await this.clear();
+        this.scene.remove(this._anchor);
+    }
+
+    static chunkPosToBlockIndex(pos: Vector3): number {
+        return (pos.y * 16 * 16) + (pos.z * 16) + pos.x;
+    }
+
+    worldPosToChunkPos(pos: Vector3): Vector3 {
+        return new Vector3(
+            pos.x - (this.x * 16),
+            pos.y - (this.y * 16),
+            pos.z - (this.z * 16)
+        )
+    }
+
+    chunkPosToWorldPos(pos: Vector3): Vector3 {
+        return new Vector3(
+            (this.x * 16) + pos.x,
+            (this.y * 16) + pos.y,
+            (this.z * 16) + pos.z
+        );
+    }
+
+}

package/src/world/MineRenderWorld.ts

@@ -0,0 +1,149 @@
+import { MineRenderScene } from "../renderer/MineRenderScene";
+import { Block } from "../model/block/Block";
+import { BlockObject } from "../model/block/scene/BlockObject";
+import { Vector3 } from "three";
+import { isTripleArray, TripleArray } from "../model/Model";
+import { isVector3, Maybe } from "../util/util";
+import { Chunk } from "./Chunk";
+import { BlockInfo } from "./BlockInfo";
+import { MultiBlockBlock, MultiBlockStructure } from "../model/multiblock/MultiBlockStructure";
+import { BatchedExecutor } from "../util/BatchedExecutor";
+import { AssetKey } from "../assets/AssetKey";
+import { BlockStates } from "../assets/BlockStates";
+
+//TODO: maybe make this an Object3D to add children
+export class MineRenderWorld {
+
+    public readonly scene: MineRenderScene;
+
+    private _size: number = 4; //TODO: expandable
+    private _blockSize: number = this._size * 16;
+
+    private readonly _chunks: Map<string,Chunk> = new Map<string, Chunk>();
+
+    constructor(scene: MineRenderScene) {
+        this.scene = scene;
+    }
+
+    public getBlockAt(x: number, y: number, z: number): Maybe<BlockInfo>;
+    public getBlockAt(pos: Vector3): Maybe<BlockInfo>;
+    public getBlockAt(pos: TripleArray): Maybe<BlockInfo>;
+    public getBlockAt(posOrX: number | Vector3 | TripleArray, y?: number, z?: number): Maybe<BlockInfo> {
+        if (typeof posOrX == "number") {
+            return this.getBlockAt(new Vector3(posOrX, y, z));
+        }
+        if (isTripleArray(posOrX)) {
+            return this.getBlockAt(new Vector3(posOrX[0], posOrX[1], posOrX[2]))
+        }
+        const chunk = this.getChunkAt(posOrX);
+        if (typeof chunk === "undefined") {
+            return undefined;
+        }
+        this.validatePosBounds(posOrX);
+        return chunk.getBlockAt(posOrX);
+    }
+
+    public async setBlockAt(x: number, y: number, z: number, block: Block): Promise<Maybe<BlockInfo>>;
+    public async setBlockAt(pos: Vector3, block: Block): Promise<Maybe<BlockInfo>>;
+    public async setBlockAt(pos: TripleArray, block: Block): Promise<Maybe<BlockInfo>>;
+    public async setBlockAt(posOrX: number | Vector3 | TripleArray, yOrBlock?: number | Block, z?: number, block?: Block): Promise<Maybe<BlockInfo>> {
+        if (typeof posOrX == "number") {
+            return this.setBlockAt(new Vector3(posOrX, yOrBlock as number, z), block as Block);
+        }
+        if (isTripleArray(posOrX)) {
+            return this.setBlockAt(new Vector3(posOrX[0], posOrX[1], posOrX[2]), yOrBlock as Block);
+        }
+        this.validatePosBounds(posOrX);
+        const chunk = this.getOrCreateChunkAt(posOrX);
+        return chunk.setBlockAt(posOrX, yOrBlock as Block);
+    }
+
+
+    public async placeMultiBlock(multiblock: MultiBlockStructure, useBatches: boolean = true, executor: BatchedExecutor = new BatchedExecutor()): Promise<void> {
+        // preload blockstates
+        const keys = new Set<AssetKey>(multiblock.blocks.map(block => AssetKey.parse("blockstates", block.type)));
+        await BlockStates.getAll(keys);
+
+        const place = async (block: MultiBlockBlock) => {
+            if (useBatches && typeof executor !== "undefined") {
+                await new Promise((resolve, reject) => {
+                    executor.submit(() => {
+                        this.setBlockAt(block.position, block).then(resolve).catch(reject)
+                    })
+                });
+            } else {
+                await this.setBlockAt(block.position, block);
+            }
+        }
+        for (let block of multiblock.blocks) {
+            await place(block);
+        }
+    }
+
+
+    public async clear(): Promise<void> {
+        console.log("CHUNKS",this._chunks)
+
+        for (let chunk of this._chunks.values()) {
+            console.log("dispose chunk",chunk)
+            await chunk?.dispose();
+        }
+        this._chunks.clear();
+    }
+
+    private getOrCreateChunkAt(pos: Vector3): Chunk {
+        const key = this.worldPosToChunkKey(pos);
+        let chunk = this._chunks.get(key);
+        if (typeof chunk === "undefined") {
+            chunk = new Chunk(this.scene, Math.floor(pos.x / 16), Math.floor(pos.y / 16), Math.floor(pos.z / 16));
+            this._chunks.set(key, chunk);
+        }
+        return chunk;
+    }
+
+    public getChunkAt(pos: Vector3): Maybe<Chunk> {
+        const index = this.worldPosToChunkIndex(pos);
+        return this._chunks[index];
+    }
+
+
+    static worldToScenePosition(pos: Vector3): Vector3 {
+        return new Vector3(
+            pos.x * 16.0,
+            pos.y * 16.0,
+            pos.z * 16.0
+        );
+    }
+
+    static sceneToWorldPosition(pos: Vector3): Vector3 {
+        return new Vector3(
+            pos.x / 16.0,
+            pos.y / 16.0,
+            pos.z / 16.0
+        );
+    }
+
+    worldPosToChunkIndex(pos: Vector3): number {
+        const chunkX = Math.floor(pos.x / 16);
+        const chunkY = Math.floor(pos.y / 16);
+        const chunkZ = Math.floor(pos.z / 16);
+        return (chunkZ * this._size * this._size) + (chunkY * this._size) + chunkX;
+    }
+
+    worldPosToChunkKey(pos: Vector3): string {
+        const chunkX = Math.floor(pos.x / 16);
+        const chunkY = Math.floor(pos.y / 16);
+        const chunkZ = Math.floor(pos.z / 16);
+        return `${chunkX}_${chunkY}_${chunkZ}`;
+    }
+
+    validatePosBounds(pos: Vector3): void {
+        if (pos.x < 0) throw new Error("x<0");
+        if (pos.y < 0) throw new Error("y<0");
+        if (pos.z < 0) throw new Error("z<0");
+        if (pos.x > this._blockSize) throw new Error("x>" + this._blockSize);
+        if (pos.y > this._blockSize) throw new Error("y>" + this._blockSize);
+        if (pos.z > this._blockSize) throw new Error("z>" + this._blockSize);
+    }
+
+}

package/test/serviceworker.js

@@ -0,0 +1,50 @@
+// [Working example](/serviceworker-cookbook/json-cache/).
+
+var CACHE_NAME = 'dependencies-cache';
+
+self.addEventListener('install', function (event) {
+    // Perform the install step:
+    // * Load a JSON file from server
+    // * Parse as JSON
+    // * Add files to the cache list
+
+    // Message to simply show the lifecycle flow
+    console.log('[install] Kicking off service worker registration!');
+
+    event.waitUntil(
+        caches.open(CACHE_NAME)
+    );
+});
+
+self.addEventListener('fetch', function (event) {
+    event.respondWith(
+        caches.match(event.request)
+            .then(function (response) {
+                    // Cache hit - return the response from the cached version
+                    if (response) {
+                        console.log(
+                            '[fetch] Returning from Service Worker cache: ',
+                            event.request.url
+                        );
+                        return response;
+                    }
+
+                    caches.open(CACHE_NAME).then(cache => cache.add(event.request));
+
+                    // Not in cache - return the result from the live server
+                    // `fetch` is essentially a "fallback"
+                    console.log('[fetch] Returning from server: ', event.request.url);
+                    return fetch(event.request);
+                }
+            )
+    );
+});
+
+self.addEventListener('activate', function (event) {
+    // Message to simply show the lifecycle flow
+    console.log('[activate] Activating service worker!');
+
+    // Claim the service work for this client, forcing `controllerchange` event
+    console.log('[activate] Claiming this service worker!');
+    event.waitUntil(self.clients.claim());
+});