@aics/vole-core 3.12.4 → 3.13.0

package/es/workers/VolumeLoaderContext.js

@@ -21,11 +21,11 @@ const throttle = throttledQueue(1, 16);
 class SharedLoadWorkerHandle {
   pendingRequests = [];
   workerOpen = true;
-  throttleChannelData = false;
-  onChannelData = undefined;
-  onUpdateMetadata = undefined;
+  onEvent = undefined;
   constructor() {
-    this.worker = new Worker(new URL("./VolumeLoadWorker", import.meta.url));
+    this.worker = new Worker(new URL("./VolumeLoadWorker", import.meta.url), {
+      type: "module"
+    });
     this.worker.onmessage = this.receiveMessage.bind(this);
   }
 
@@ -53,7 +53,11 @@ class SharedLoadWorkerHandle {
    * Send a message of type `T` to the worker.
    * Returns a `Promise` that resolves with the worker's response, or rejects with an error message.
    */
-  sendMessage(type, payload) {
+  // overload 1: message is a global action and does not require a loader ID
+
+  // overload 2: message is a loader-specific action and requires a loader ID
+
+  sendMessage(type, payload, loaderId) {
     let msgId = -1;
     const promise = new Promise((resolve, reject) => {
       msgId = this.registerMessagePromise({
@@ -65,7 +69,8 @@ class SharedLoadWorkerHandle {
     const msg = {
       msgId,
       type,
-      payload
+      payload,
+      loaderId
     };
     this.worker.postMessage(msg);
     return promise;
@@ -76,17 +81,7 @@ class SharedLoadWorkerHandle {
     data
   }) {
     if (data.responseResult === WorkerResponseResult.EVENT) {
-      if (data.eventType === WorkerEventType.CHANNEL_LOAD) {
-        if (this.onChannelData) {
-          if (this.throttleChannelData) {
-            throttle(() => this.onChannelData ? this.onChannelData(data) : {});
-          } else {
-            this.onChannelData ? this.onChannelData(data) : {};
-          }
-        }
-      } else if (data.eventType === WorkerEventType.METADATA_UPDATE) {
-        this.onUpdateMetadata?.(data);
-      }
+      this.onEvent?.(data);
     } else {
       const prom = this.pendingRequests[data.msgId];
       if (prom === undefined) {
@@ -103,16 +98,13 @@ class SharedLoadWorkerHandle {
       this.pendingRequests[data.msgId] = undefined;
     }
   }
-  setThrottleChannelData(throttle) {
-    this.throttleChannelData = throttle;
-  }
 }
 
 /**
  * A context in which volume loaders can be run, which allows loading to run on a WebWorker (where it won't block
  * rendering or UI updates) and loaders to share a single `VolumeCache` and `RequestQueue`.
  *
- * ### To use:
+ * # To use:
  * 1. Create a `VolumeLoaderContext` with the desired cache and queue configuration.
  * 2. Before creating a loader, await `onOpen` to ensure the worker is ready.
  * 3. Create a loader with `createLoader`. This accepts nearly the same arguments as `createVolumeLoader`, but without
@@ -123,10 +115,11 @@ class SharedLoadWorkerHandle {
  * running on the worker.
  */
 class VolumeLoaderContext {
-  activeLoader = undefined;
-  activeLoaderId = -1;
+  throttleChannelData = false;
   constructor(maxCacheSize, maxActiveRequests, maxLowPriorityRequests) {
     this.workerHandle = new SharedLoadWorkerHandle();
+    this.workerHandle.onEvent = this.handleEvent.bind(this);
+    this.loaders = new Map();
     this.openPromise = this.workerHandle.sendMessage(WorkerMsgType.INIT, {
       maxCacheSize,
       maxActiveRequests,
@@ -145,7 +138,20 @@ class VolumeLoaderContext {
   /** Close this context, its worker, and any active loaders. */
   close() {
     this.workerHandle.close();
-    this.activeLoader?.close();
+  }
+  handleEvent(e) {
+    const loader = this.loaders.get(e.loaderId);
+    if (loader) {
+      if (e.eventType === WorkerEventType.CHANNEL_LOAD) {
+        if (this.throttleChannelData) {
+          throttle(() => loader.onChannelData(e));
+        } else {
+          loader.onChannelData(e);
+        }
+      } else if (e.eventType === WorkerEventType.METADATA_UPDATE) {
+        loader.onUpdateMetadata(e);
+      }
+    }
   }
 
   /**
@@ -165,23 +171,19 @@ class VolumeLoaderContext {
       }
       return new RawArrayLoader(options.rawArrayOptions.data, options.rawArrayOptions.metadata);
     }
-    const success = await this.workerHandle.sendMessage(WorkerMsgType.CREATE_LOADER, {
+    const loaderId = await this.workerHandle.sendMessage(WorkerMsgType.CREATE_LOADER, {
       path,
       options
     });
-    if (!success) {
+    if (loaderId === undefined) {
       throw new Error("Failed to create loader");
     }
-    this.activeLoader?.close();
-    this.activeLoaderId += 1;
-    this.activeLoader = new WorkerLoader(this.activeLoaderId, this.workerHandle);
-    return this.activeLoader;
+    const loader = new WorkerLoader(loaderId, this.workerHandle);
+    this.loaders.set(loaderId, loader);
+    return loader;
   }
   setThrottleChannelData(throttle) {
-    this.workerHandle.setThrottleChannelData(throttle);
-  }
-  getActiveLoader() {
-    return this.activeLoader;
+    this.throttleChannelData = throttle;
   }
 }
 
@@ -191,7 +193,6 @@ class VolumeLoaderContext {
  * Created with `VolumeLoaderContext.createLoader`. See its documentation for more.
  */
 class WorkerLoader extends ThreadableVolumeLoader {
-  isOpen = true;
   currentLoadId = -1;
   currentLoadCallback = undefined;
   currentMetadataUpdateCallback = undefined;
@@ -199,18 +200,21 @@ class WorkerLoader extends ThreadableVolumeLoader {
     super();
     this.loaderId = loaderId;
     this.workerHandle = workerHandle;
-    workerHandle.onChannelData = this.onChannelData.bind(this);
-    workerHandle.onUpdateMetadata = this.onUpdateMetadata.bind(this);
   }
-  checkIsOpen() {
-    if (!this.isOpen || !this.workerHandle.isOpen) {
+  getLoaderId() {
+    if (this.loaderId === undefined || !this.workerHandle.isOpen) {
       throw new Error("Tried to use a closed loader");
     }
+    return this.loaderId;
   }
 
   /** Close and permanently invalidate this loader. */
   close() {
-    this.isOpen = false;
+    if (this.loaderId === undefined) {
+      return;
+    }
+    this.workerHandle.sendMessage(WorkerMsgType.CLOSE_LOADER, undefined, this.loaderId);
+    this.loaderId = undefined;
   }
 
   /**
@@ -218,40 +222,37 @@ class WorkerLoader extends ThreadableVolumeLoader {
    * any chunks are prefetched in any other directions. Has no effect if this loader doesn't support prefetching.
    */
   setPrefetchPriority(directions) {
-    return this.workerHandle.sendMessage(WorkerMsgType.SET_PREFETCH_PRIORITY_DIRECTIONS, directions);
+    return this.workerHandle.sendMessage(WorkerMsgType.SET_PREFETCH_PRIORITY_DIRECTIONS, directions, this.getLoaderId());
   }
   updateFetchOptions(fetchOptions) {
-    return this.workerHandle.sendMessage(WorkerMsgType.UPDATE_FETCH_OPTIONS, fetchOptions);
+    return this.workerHandle.sendMessage(WorkerMsgType.UPDATE_FETCH_OPTIONS, fetchOptions, this.getLoaderId());
   }
   syncMultichannelLoading(sync) {
-    return this.workerHandle.sendMessage(WorkerMsgType.SYNCHRONIZE_MULTICHANNEL_LOADING, sync);
+    return this.workerHandle.sendMessage(WorkerMsgType.SYNCHRONIZE_MULTICHANNEL_LOADING, sync, this.getLoaderId());
   }
   loadDims(loadSpec) {
-    this.checkIsOpen();
-    return this.workerHandle.sendMessage(WorkerMsgType.LOAD_DIMS, loadSpec);
+    return this.workerHandle.sendMessage(WorkerMsgType.LOAD_DIMS, loadSpec, this.getLoaderId());
   }
   async createImageInfo(loadSpec) {
-    this.checkIsOpen();
     const {
       imageInfo,
       loadSpec: adjustedLoadSpec
-    } = await this.workerHandle.sendMessage(WorkerMsgType.CREATE_VOLUME, loadSpec);
+    } = await this.workerHandle.sendMessage(WorkerMsgType.CREATE_VOLUME, loadSpec, this.getLoaderId());
     return {
       imageInfo,
       loadSpec: rebuildLoadSpec(adjustedLoadSpec)
     };
   }
   loadRawChannelData(imageInfo, loadSpec, onUpdateMetadata, onData) {
-    this.checkIsOpen();
     this.currentLoadCallback = onData;
     this.currentMetadataUpdateCallback = onUpdateMetadata;
     this.currentLoadId += 1;
-    return this.workerHandle.sendMessage(WorkerMsgType.LOAD_VOLUME_DATA, {
+    const message = {
       imageInfo,
       loadSpec,
-      loaderId: this.loaderId,
       loadId: this.currentLoadId
-    });
+    };
+    return this.workerHandle.sendMessage(WorkerMsgType.LOAD_VOLUME_DATA, message, this.getLoaderId());
   }
   onChannelData(e) {
     if (e.loaderId !== this.loaderId || e.loadId !== this.currentLoadId) {

package/es/workers/types.js

@@ -2,15 +2,20 @@
 export let WorkerMsgType = /*#__PURE__*/function (WorkerMsgType) {
   WorkerMsgType[WorkerMsgType["INIT"] = 0] = "INIT";
   WorkerMsgType[WorkerMsgType["CREATE_LOADER"] = 1] = "CREATE_LOADER";
-  WorkerMsgType[WorkerMsgType["CREATE_VOLUME"] = 2] = "CREATE_VOLUME";
-  WorkerMsgType[WorkerMsgType["LOAD_DIMS"] = 3] = "LOAD_DIMS";
-  WorkerMsgType[WorkerMsgType["LOAD_VOLUME_DATA"] = 4] = "LOAD_VOLUME_DATA";
-  WorkerMsgType[WorkerMsgType["SET_PREFETCH_PRIORITY_DIRECTIONS"] = 5] = "SET_PREFETCH_PRIORITY_DIRECTIONS";
-  WorkerMsgType[WorkerMsgType["SYNCHRONIZE_MULTICHANNEL_LOADING"] = 6] = "SYNCHRONIZE_MULTICHANNEL_LOADING";
-  WorkerMsgType[WorkerMsgType["UPDATE_FETCH_OPTIONS"] = 7] = "UPDATE_FETCH_OPTIONS";
+  WorkerMsgType[WorkerMsgType["CLOSE_LOADER"] = 2] = "CLOSE_LOADER";
+  WorkerMsgType[WorkerMsgType["CREATE_VOLUME"] = 3] = "CREATE_VOLUME";
+  WorkerMsgType[WorkerMsgType["LOAD_DIMS"] = 4] = "LOAD_DIMS";
+  WorkerMsgType[WorkerMsgType["LOAD_VOLUME_DATA"] = 5] = "LOAD_VOLUME_DATA";
+  WorkerMsgType[WorkerMsgType["SET_PREFETCH_PRIORITY_DIRECTIONS"] = 6] = "SET_PREFETCH_PRIORITY_DIRECTIONS";
+  WorkerMsgType[WorkerMsgType["SYNCHRONIZE_MULTICHANNEL_LOADING"] = 7] = "SYNCHRONIZE_MULTICHANNEL_LOADING";
+  WorkerMsgType[WorkerMsgType["UPDATE_FETCH_OPTIONS"] = 8] = "UPDATE_FETCH_OPTIONS";
   return WorkerMsgType;
 }({});
 
+/** The variants of `WorkerMessageType` which represent "global" actions that don't require a specific loader */
+
+/** The variants of `WorkerMessageType` which represent actions on a specific loader */
+
 /** The kind of response a worker can return - `SUCCESS`, `ERROR`, or `EVENT`. */
 export let WorkerResponseResult = /*#__PURE__*/function (WorkerResponseResult) {
   WorkerResponseResult[WorkerResponseResult["SUCCESS"] = 0] = "SUCCESS";
@@ -21,12 +26,17 @@ export let WorkerResponseResult = /*#__PURE__*/function (WorkerResponseResult) {
 
 /** The kind of events that can occur when loading */
 export let WorkerEventType = /*#__PURE__*/function (WorkerEventType) {
+  /** Fired to update a `Volume`'s `imageInfo` and/or `loadSpec` based on loaded data (time, channels, region, etc.) */
   WorkerEventType[WorkerEventType["METADATA_UPDATE"] = 0] = "METADATA_UPDATE";
+  /** Fired when data for a channel (or batch of channels) is loaded */
   WorkerEventType[WorkerEventType["CHANNEL_LOAD"] = 1] = "CHANNEL_LOAD";
   return WorkerEventType;
 }({});
 
-/** All messages to/from a worker carry a `msgId`, a `type`, and a `payload` (whose type is determined by `type`). */
+/**
+ * All messages to/from a worker carry a `msgId`, a `type`, and a `payload` (whose type is determined by `type`).
+ * Messages which operate on a specific loader also require a `loaderId`.
+ */
 
 /** Maps each `WorkerMsgType` to the type of the payload of requests of that type. */
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aics/vole-core",
-  "version": "3.12.4",
+  "version": "3.13.0",
   "description": "volume renderer for 3d, 4d, or 5d imaging data with OME-Zarr support",
   "main": "es/index.js",
   "type": "module",
@@ -16,15 +16,15 @@
     "build-docs": "node node_modules/documentation/bin/documentation.js build src/Histogram.ts src/View3d.ts src/Volume.ts src/VolumeMaker.ts src/VolumeLoader.ts -f html -o docs --shallow",
     "build": "npm run transpileES && npm run build-types",
     "build-types": "tsc -p tsconfig.types.json",
-    "build-demo": "webpack --config webpack.demo.js",
+    "build-demo": "vite build public/ --config vite.config.ts --outDir ./demo",
     "clean": "rimraf es/",
-    "format": "prettier --write src/**/*.js",
-    "gh-build": "webpack --config webpack.dev.js",
-    "dev": "webpack serve --config webpack.dev.js",
-    "start": "webpack serve --config webpack.dev.js",
+    "format": "prettier --write src/**/*.ts",
+    "gh-build": "vite build public/ --config vite.config.ts --outDir ./vole-core",
+    "dev": "vite serve",
+    "start": "vite serve",
     "lint": "eslint --config ./.eslintrc.json --ignore-path ./.eslintignore --ext .js --ext .ts ./src",
-    "test": "cross-env NODE_OPTIONS=\"--loader ts-node/esm\" mocha --require ts-node/register --es-module-specifier-resolution=node src/**/test/*.[jt]s",
-    "transpileES": "babel src --out-dir es --extensions .js,.ts --ignore **/*.test.js",
+    "test": "vitest run",
+    "transpileES": "babel src --out-dir es --extensions .js,.ts --ignore **/*.test.ts",
     "typeCheck": "tsc -p tsconfig.json --noEmit"
   },
   "author": "Daniel Toloudis",
@@ -48,16 +48,13 @@
     "@babel/preset-typescript": "^7.24.7",
     "@babel/register": "^7.24.6",
     "@tweakpane/core": "^1.1.9",
-    "@types/chai": "^4.3.12",
-    "@types/mocha": "^9.1.1",
-    "@types/three": "^0.144.0",
+    "@types/three": "^0.171.0",
     "@typescript-eslint/eslint-plugin": "^5.30.5",
     "@typescript-eslint/parser": "^5.30.5",
     "acorn": "^8.7.0",
     "babel-loader": "^8.2.2",
     "babel-plugin-inline-import": "^3.0.0",
     "babel-plugin-inline-import-data-uri": "^1.0.1",
-    "chai": "^5.1.0",
     "clean-webpack-plugin": "^4.0.0-alpha.0",
     "copy-webpack-plugin": "^9.0.1",
     "cross-env": "^7.0.3",
@@ -67,15 +64,18 @@
     "file-loader": "^6.2.0",
     "html-webpack-plugin": "^5.3.2",
     "husky": "^7.0.1",
+    "jsdom": "^25.0.1",
     "lil-gui": "^0.19.2",
     "lint-staged": "^13.2.1",
-    "mocha": "^10.3.0",
     "prettier": "^2.3.2",
     "raw-loader": "^4.0.2",
     "rimraf": "^3.0.2",
     "ts-node": "^10.9.2",
     "typescript": "^4.3.5",
     "url-loader": "^4.1.1",
+    "vite": "^6.0.6",
+    "vitest": "^2.1.8",
+    "vite-plugin-glsl": "^1.3.1",
     "webpack": "^5.69.1",
     "webpack-cli": "^4.9.2",
     "webpack-dev-server": "^4.7.4"

package/es/test/ChunkPrefetchIterator.test.js

@@ -1,208 +0,0 @@
-import { expect } from "chai";
-import ChunkPrefetchIterator from "../loaders/zarr_utils/ChunkPrefetchIterator";
-import { PrefetchDirection } from "../loaders/zarr_utils/types";
-const EXPECTED_3X3X3X3 = [[0, 0, 1, 1, 1],
-// T-
-[2, 0, 1, 1, 1],
-// T+
-[1, 0, 0, 1, 1],
-// Z-
-[1, 0, 2, 1, 1],
-// Z+
-[1, 0, 1, 0, 1],
-// Y-
-[1, 0, 1, 2, 1],
-// Y+
-[1, 0, 1, 1, 0],
-// X-
-[1, 0, 1, 1, 2] // X+
-];
-
-// move from the middle of a 3x3x3x3 cube to the middle of a 5x5x5x5 cube
-const EXPECTED_5X5X5X5_1 = EXPECTED_3X3X3X3.map(([t, c, z, y, x]) => [t + 1, c, z + 1, y + 1, x + 1]);
-// offset = 2!
-const EXPECTED_5X5X5X5_2 = [[0, 0, 2, 2, 2],
-// T--
-[4, 0, 2, 2, 2],
-// T++
-[2, 0, 0, 2, 2],
-// Z--
-[2, 0, 4, 2, 2],
-// Z++
-[2, 0, 2, 0, 2],
-// Y--
-[2, 0, 2, 4, 2],
-// Y++
-[2, 0, 2, 2, 0],
-// X--
-[2, 0, 2, 2, 4] // X++
-];
-function validate(iter, expected) {
-  expect([...iter]).to.deep.equal(expected);
-}
-describe("ChunkPrefetchIterator", () => {
-  it("iterates outward in TZYX order, negative then positive", () => {
-    // 3x3x3x3, with one chunk in the center
-    const iterator = new ChunkPrefetchIterator([[1, 0, 1, 1, 1]], [1, 1, 1, 1], [[3, 1, 3, 3, 3]]);
-    validate(iterator, EXPECTED_3X3X3X3);
-  });
-  it("finds the borders of a set of multiple chunks and iterates outward from them", () => {
-    // 4x4x4, with a 2x2x2 set of chunks in the center
-    const fetchedChunks = [[1, 0, 1, 1, 1], [1, 0, 1, 1, 2], [1, 0, 1, 2, 1], [1, 0, 1, 2, 2], [1, 0, 2, 1, 1], [1, 0, 2, 1, 2], [1, 0, 2, 2, 1], [1, 0, 2, 2, 2]];
-    const iterator = new ChunkPrefetchIterator(fetchedChunks, [1, 1, 1, 1], [[3, 1, 4, 4, 4]]);
-    const expected = [...fetchedChunks.map(([_t, c, z, y, x]) => [0, c, z, y, x]),
-    // T-
-    ...fetchedChunks.map(([_t, c, z, y, x]) => [2, c, z, y, x]),
-    // T+
-    ...fetchedChunks.filter(([_t, _c, z, _y, _x]) => z === 1).map(([t, c, _z, y, x]) => [t, c, 0, y, x]),
-    // Z-
-    ...fetchedChunks.filter(([_t, _c, z, _y, _x]) => z === 2).map(([t, c, _z, y, x]) => [t, c, 3, y, x]),
-    // Z+
-    ...fetchedChunks.filter(([_t, _c, _z, y, _x]) => y === 1).map(([t, c, z, _y, x]) => [t, c, z, 0, x]),
-    // Y-
-    ...fetchedChunks.filter(([_t, _c, _z, y, _x]) => y === 2).map(([t, c, z, _y, x]) => [t, c, z, 3, x]),
-    // Y+
-    ...fetchedChunks.filter(([_t, _c, _z, _y, x]) => x === 1).map(([t, c, z, y, _x]) => [t, c, z, y, 0]),
-    // X-
-    ...fetchedChunks.filter(([_t, _c, _z, _y, x]) => x === 2).map(([t, c, z, y, _x]) => [t, c, z, y, 3]) // X+
-    ];
-    validate(iterator, expected);
-  });
-  it("iterates through the same offset in all dimensions before increasing the offset", () => {
-    // 5x5x5, with one chunk in the center
-    const iterator = new ChunkPrefetchIterator([[2, 0, 2, 2, 2]], [2, 2, 2, 2], [[5, 1, 5, 5, 5]]);
-    const expected = [
-    // offset = 1
-    ...EXPECTED_5X5X5X5_1,
-    // offset = 2!
-    ...EXPECTED_5X5X5X5_2];
-    validate(iterator, expected);
-  });
-  it("stops at the max offset in each dimension", () => {
-    // 5x5x5, with one chunk in the center
-    const iterator = new ChunkPrefetchIterator([[2, 0, 2, 2, 2]], [1, 1, 1, 1], [[5, 1, 5, 5, 5]]);
-    validate(iterator, EXPECTED_5X5X5X5_1); // never reaches offset = 2, as it does above
-  });
-  it("stops at the borders of the zarr", () => {
-    // 3x3x3x3, with one chunk in the center
-    const iterator = new ChunkPrefetchIterator([[1, 0, 1, 1, 1]], [2, 2, 2, 2], [[3, 1, 3, 3, 3]]);
-    validate(iterator, EXPECTED_3X3X3X3);
-  });
-  it("does not iterate in dimensions which are entirely covered by the fetched set", () => {
-    // 3x3x3x3, with a 1x1x3x3 slice covering all of x and y
-    const fetchedChunks = [[1, 0, 1, 0, 0],
-    // 0, 0
-    [1, 0, 1, 0, 1],
-    // 0, 1
-    [1, 0, 1, 0, 2],
-    // 0, 2
-    [1, 0, 1, 1, 0],
-    // 1, 0
-    [1, 0, 1, 1, 1],
-    // 1, 1
-    [1, 0, 1, 1, 2],
-    // 1, 2
-    [1, 0, 1, 2, 0],
-    // 2, 0
-    [1, 0, 1, 2, 1],
-    // 2, 1
-    [1, 0, 1, 2, 2] // 2, 2
-    ];
-    const iterator = new ChunkPrefetchIterator(fetchedChunks, [1, 1, 1, 1], [[3, 1, 3, 3, 3]]);
-    const expected = [...fetchedChunks.map(([_t, c, z, y, x]) => [0, c, z, y, x]),
-    // T-
-    ...fetchedChunks.map(([_t, c, z, y, x]) => [2, c, z, y, x]),
-    // T+
-    ...fetchedChunks.map(([t, c, _z, y, x]) => [t, c, 0, y, x]),
-    // Z-
-    ...fetchedChunks.map(([t, c, _z, y, x]) => [t, c, 2, y, x]) // Z+
-    // skips x and y
-    ];
-    validate(iterator, expected);
-  });
-  it("does not iterate in dimensions where the max offset is 0", () => {
-    // 3x3x3x3, with one chunk in the center
-    const iterator = new ChunkPrefetchIterator([[1, 0, 1, 1, 1]], [1, 0, 1, 0], [[3, 1, 3, 3, 3]]);
-    const expected = [[0, 0, 1, 1, 1],
-    // T-
-    [2, 0, 1, 1, 1],
-    // T+
-    // skips z
-    [1, 0, 1, 0, 1],
-    // Y-
-    [1, 0, 1, 2, 1] // Y+
-    // skips x
-    ];
-    validate(iterator, expected);
-  });
-  it("yields chunks in all prioritized directions first", () => {
-    // 5x5x5, with one chunk in the center
-    const iterator = new ChunkPrefetchIterator([[2, 0, 2, 2, 2]], [2, 2, 2, 2], [[5, 1, 5, 5, 5]], [PrefetchDirection.T_PLUS, PrefetchDirection.Y_MINUS]);
-    const expected = [[3, 0, 2, 2, 2],
-    // T+
-    [2, 0, 2, 1, 2],
-    // Y-
-    [4, 0, 2, 2, 2],
-    // T++
-    [2, 0, 2, 0, 2],
-    // Y--
-    ...EXPECTED_5X5X5X5_1.filter(([t, _c, _z, y, _x]) => t <= 2 && y >= 2), ...EXPECTED_5X5X5X5_2.filter(([t, _c, _z, y, _x]) => t <= 2 && y >= 2)];
-    validate(iterator, expected);
-  });
-  it("continues iterating in other dimensions when some reach their limits", () => {
-    // final boss: 4x4x6 volume with off-center fetched set
-    // t has a max offset of 2, but is already at its maximum of 2 and never iterates in positive direction
-    // z has a max offset of 2, but stops early in negative direction at 0
-    // y has a max offset of 2, but is already covered in the negative direction by chunks in the fetched set
-    // x has a max offset of 1, which stops iteration before it gets to either edge
-    const fetchedChunks = [[2, 0, 1, 0, 2], [2, 0, 1, 0, 3], [2, 0, 1, 1, 2], [2, 0, 1, 1, 3]];
-    const iterator = new ChunkPrefetchIterator(fetchedChunks, [2, 2, 2, 1], [[3, 1, 4, 4, 6]]);
-
-    // prettier-ignore
-    const expected = [...fetchedChunks.map(([_t, c, z, y, x]) => [1, c, z, y, x]),
-    // T-
-    // skip t+: already at max t
-    ...fetchedChunks.map(([t, c, _z, y, x]) => [t, c, 0, y, x]),
-    // Z-
-    ...fetchedChunks.map(([t, c, _z, y, x]) => [t, c, 2, y, x]),
-    // Z+
-    // skip y-: already covered by fetched chunks
-    [2, 0, 1, 2, 2], [2, 0, 1, 2, 3],
-    // Y+
-    [2, 0, 1, 0, 1], [2, 0, 1, 1, 1],
-    // X-
-    [2, 0, 1, 0, 4], [2, 0, 1, 1, 4],
-    // X+
-    ...fetchedChunks.map(([_t, c, z, y, x]) => [0, c, z, y, x]),
-    // T--
-    // skip t++: still at max t
-    // skip z--: already reached z = 0 above
-    ...fetchedChunks.map(([t, c, _z, y, x]) => [t, c, 3, y, x]),
-    // Z++
-    // skip y-: still already covered by fetched chunks
-    [2, 0, 1, 3, 2], [2, 0, 1, 3, 3] // Y+
-    // skip x: already at max offset in x
-    ];
-    validate(iterator, expected);
-  });
-  it("correctly handles sources with differing chunk dimensions", () => {
-    const allChannels = (x, y, ch = [0, 1, 2, 3]) => ch.map(c => [0, c, 0, y, x]);
-    const iterator = new ChunkPrefetchIterator(allChannels(1, 2), [0, 0, 2, 2], [[0, 1, 0, 4, 3], [0, 2, 0, 5, 2], [0, 1, 0, 3, 4]]);
-    const expected = [...allChannels(1, 1),
-    // Y-
-    ...allChannels(1, 3, [0, 1, 2]),
-    // Y+: channel 3 is maxed out
-    ...allChannels(0, 2),
-    // X-
-    ...allChannels(2, 2, [0, 3]),
-    // X+: channels 1 and 2 are maxed out
-    ...allChannels(1, 0),
-    // Y--
-    ...allChannels(1, 4, [1, 2]),
-    // Y++: channels 0 and 3 are maxed out
-    // skip X--
-    [0, 3, 0, 2, 3] // X++: all channels but channel 3 are maxed out
-    ];
-    validate(iterator, expected);
-  });
-});