@vitessce/vit-s 4.0.2 → 4.0.4

package/dist/index.js

@@ -34108,7 +34108,7 @@ const AUTO_INDEPENDENT_COORDINATION_TYPES = [
     CoordinationType$1.HIERARCHY_LEVELS
   ]
 });
-const version = "4.0.2";
+const version = "4.0.4";
 const META_VERSION = {
   version
 };
@@ -47151,6 +47151,33 @@ function createOnDrop(setters, isFileInput = false, isConfigInput = false) {
     setStores(storesForConfig);
   };
 }
+function useMemoCustomComparison(factory, dependencies, customIsEqual) {
+  const ref = useRef(
+    /** @type {{ deps: any; value: T } | undefined} */
+    void 0
+  );
+  if (ref.current === void 0 || !customIsEqual(ref.current.deps, dependencies)) {
+    ref.current = { deps: dependencies, value: factory() };
+  }
+  return ref.current.value;
+}
+const shallowDiff = (prevDeps, nextDeps, depName) => prevDeps[depName] !== nextDeps[depName];
+const shallowDiffByLayer = (prevDeps, nextDeps, depName, scopeName) => prevDeps?.[depName]?.[scopeName] !== nextDeps?.[depName]?.[scopeName];
+const shallowDiffByLayerWithKeys = (prevDeps, nextDeps, depName, scopeName, keys2) => keys2.some(
+  (k) => prevDeps?.[depName]?.[scopeName]?.[k] !== nextDeps?.[depName]?.[scopeName]?.[k]
+);
+const shallowDiffByChannel = (prevDeps, nextDeps, depName, firstName, secondName) => prevDeps?.[depName]?.[firstName]?.[secondName] !== nextDeps?.[depName]?.[firstName]?.[secondName];
+const shallowDiffByChannelWithKeys = (prevDeps, nextDeps, depName, firstName, secondName, keys2) => keys2.some(
+  (k) => prevDeps?.[depName]?.[firstName]?.[secondName]?.[k] !== nextDeps?.[depName]?.[firstName]?.[secondName]?.[k]
+);
+const shallowDiffByLayerCoordination = (prevDeps, nextDeps, depName, layerScope) => prevDeps?.[depName]?.[0]?.[layerScope] !== nextDeps?.[depName]?.[0]?.[layerScope];
+const shallowDiffByLayerCoordinationWithKeys = (prevDeps, nextDeps, depName, layerScope, keys2) => keys2.some(
+  (k) => prevDeps?.[depName]?.[0]?.[layerScope]?.[k] !== nextDeps?.[depName]?.[0]?.[layerScope]?.[k]
+);
+const shallowDiffByChannelCoordination = (prevDeps, nextDeps, depName, layerScope, channelScope) => prevDeps?.[depName]?.[0]?.[layerScope]?.[channelScope] !== nextDeps?.[depName]?.[0]?.[layerScope]?.[channelScope];
+const shallowDiffByChannelCoordinationWithKeys = (prevDeps, nextDeps, depName, layerScope, channelScope, keys2) => keys2.some(
+  (k) => prevDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]?.[k] !== nextDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]?.[k]
+);
 export {
   CellColorEncodingOption,
   OptionSelect,
@@ -47162,6 +47189,15 @@ export {
   createLoaders,
   createOnDrop,
   logConfig,
+  shallowDiff,
+  shallowDiffByChannel,
+  shallowDiffByChannelCoordination,
+  shallowDiffByChannelCoordinationWithKeys,
+  shallowDiffByChannelWithKeys,
+  shallowDiffByLayer,
+  shallowDiffByLayerCoordination,
+  shallowDiffByLayerCoordinationWithKeys,
+  shallowDiffByLayerWithKeys,
   useAddImageChannelInMetaCoordinationScopes,
   useAsyncFunction,
   useAuxiliaryCoordination,
@@ -47194,6 +47230,7 @@ export {
   useInitialCoordination,
   useLoaders,
   useMatchingLoader,
+  useMemoCustomComparison,
   useMergeCoordination,
   useMultiCoordinationScopes,
   useMultiCoordinationScopesNonNull,

package/dist-tsc/index.d.ts

@@ -12,4 +12,5 @@ export { useDescription, useImageData, useObsSetsData, useObsEmbeddingData, useF
 export { usePointMultiObsLabels, usePointMultiObsFeatureMatrixIndices, useSpotMultiFeatureSelection, useSpotMultiObsFeatureMatrixIndices, useSegmentationMultiFeatureSelection, useSegmentationMultiObsFeatureMatrixIndices, useSegmentationMultiObsLocations, useSegmentationMultiObsSets } from "./data-hooks-multilevel.js";
 export { CellColorEncodingOption, OptionsContainer, OptionSelect, usePlotOptionsStyles } from "./shared-plot-options/index.js";
 export { useAsyncFunction, usePageModeView } from "./contexts.js";
+export { useMemoCustomComparison, shallowDiff, shallowDiffByLayer, shallowDiffByLayerWithKeys, shallowDiffByChannel, shallowDiffByChannelWithKeys, shallowDiffByLayerCoordination, shallowDiffByLayerCoordinationWithKeys, shallowDiffByChannelCoordination, shallowDiffByChannelCoordinationWithKeys } from "./use-memo-custom-comparison.js";
 //# sourceMappingURL=index.d.ts.map

package/dist-tsc/index.js

@@ -13,4 +13,5 @@ export { logConfig } from './view-config-utils.js';
 export { useAsyncFunction, usePageModeView } from './contexts.js';
 export { createLoaders } from './vitessce-grid-utils.js';
 export { createOnDrop } from './on-drop.js';
+export { useMemoCustomComparison, shallowDiff, shallowDiffByLayer, shallowDiffByLayerWithKeys, shallowDiffByChannel, shallowDiffByChannelWithKeys, shallowDiffByLayerCoordination, shallowDiffByLayerCoordinationWithKeys, shallowDiffByChannelCoordination, shallowDiffByChannelCoordinationWithKeys, } from './use-memo-custom-comparison.js';
 //# sourceMappingURL=index.js.map

package/dist-tsc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,yBAAyB;AACzB,OAAO,EACL,QAAQ,EACR,OAAO,EACP,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,aAAa,EACb,+BAA+B,EAC/B,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC1B,iCAAiC,EACjC,mCAAmC,EACnC,0CAA0C,EAC1C,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,6CAA6C,EAC7C,0CAA0C,GAC3C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EACd,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EAEd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAEhB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EAEtB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,oCAAoC,EACpC,4BAA4B,EAC5B,mCAAmC,EACnC,oCAAoC,EACpC,2CAA2C,EAC3C,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,yBAAyB;AACzB,OAAO,EACL,QAAQ,EACR,OAAO,EACP,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,aAAa,EACb,+BAA+B,EAC/B,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC1B,iCAAiC,EACjC,mCAAmC,EACnC,0CAA0C,EAC1C,0BAA0B,EAC1B,2BAA2B,EAC3B,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,6CAA6C,EAC7C,0CAA0C,GAC3C,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EACd,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EAEd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAEhB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EAEtB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,oCAAoC,EACpC,4BAA4B,EAC5B,mCAAmC,EACnC,oCAAoC,EACpC,2CAA2C,EAC3C,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,8BAA8B,EAC9B,sCAAsC,EACtC,gCAAgC,EAChC,wCAAwC,GACzC,MAAM,iCAAiC,CAAC"}

package/dist-tsc/use-memo-custom-comparison.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A variant of useMemo that accepts a custom equality function
+ * to determine whether the dependencies have changed.
+ * @template T
+ * @param {() => T} factory - Function that computes the memoized value.
+ * @param {any} dependencies - The useMemo dependencies.
+ * @param {(prevDeps: any, nextDeps: any) => boolean} customIsEqual - Custom equality function,
+ * which receives the previous and next dependencies and returns true if they are considered equal.
+ * @returns {T} The memoized value.
+ */
+export function useMemoCustomComparison<T>(factory: () => T, dependencies: any, customIsEqual: (prevDeps: any, nextDeps: any) => boolean): T;
+export function shallowDiff(prevDeps: any, nextDeps: any, depName: any): boolean;
+export function shallowDiffByLayer(prevDeps: any, nextDeps: any, depName: any, scopeName: any): boolean;
+export function shallowDiffByLayerWithKeys(prevDeps: any, nextDeps: any, depName: any, scopeName: any, keys: any): any;
+export function shallowDiffByChannel(prevDeps: any, nextDeps: any, depName: any, firstName: any, secondName: any): boolean;
+export function shallowDiffByChannelWithKeys(prevDeps: any, nextDeps: any, depName: any, firstName: any, secondName: any, keys: any): any;
+export function shallowDiffByLayerCoordination(prevDeps: any, nextDeps: any, depName: any, layerScope: any): boolean;
+export function shallowDiffByLayerCoordinationWithKeys(prevDeps: any, nextDeps: any, depName: any, layerScope: any, keys: any): any;
+export function shallowDiffByChannelCoordination(prevDeps: any, nextDeps: any, depName: any, layerScope: any, channelScope: any): boolean;
+export function shallowDiffByChannelCoordinationWithKeys(prevDeps: any, nextDeps: any, depName: any, layerScope: any, channelScope: any, keys: any): any;
+//# sourceMappingURL=use-memo-custom-comparison.d.ts.map

package/dist-tsc/use-memo-custom-comparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-memo-custom-comparison.d.ts","sourceRoot":"","sources":["../src/use-memo-custom-comparison.js"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,wCAPa,CAAC,WACH,MAAM,CAAC,gBACP,GAAG,iBACH,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,OAAO,GAEvC,CAAC,CAUb;AAIM,iFAA4F;AAC5F,wGAEN;AAGM,uHAEN;AACM,2HAGN;AACM,0IAKN;AACM,qHAGN;AACM,oIAGN;AACM,0IAGN;AACM,yJAGN"}

package/dist-tsc/use-memo-custom-comparison.js

@@ -0,0 +1,39 @@
+/* eslint-disable no-unused-vars */
+/* eslint-disable max-len */
+import { useRef } from 'react';
+/**
+ * A variant of useMemo that accepts a custom equality function
+ * to determine whether the dependencies have changed.
+ * @template T
+ * @param {() => T} factory - Function that computes the memoized value.
+ * @param {any} dependencies - The useMemo dependencies.
+ * @param {(prevDeps: any, nextDeps: any) => boolean} customIsEqual - Custom equality function,
+ * which receives the previous and next dependencies and returns true if they are considered equal.
+ * @returns {T} The memoized value.
+ */
+export function useMemoCustomComparison(factory, dependencies, customIsEqual) {
+    const ref = useRef(/** @type {{ deps: any; value: T } | undefined} */ (undefined));
+    if (ref.current === undefined || !customIsEqual(ref.current.deps, dependencies)) {
+        ref.current = { deps: dependencies, value: factory() };
+    }
+    return ref.current.value;
+}
+// Comparison utilties inspired by componentDidUpdate in spatial-beta/Spatial.js:
+export const shallowDiff = (prevDeps, nextDeps, depName) => prevDeps[depName] !== nextDeps[depName];
+export const shallowDiffByLayer = (prevDeps, nextDeps, depName, scopeName) => (prevDeps?.[depName]?.[scopeName] !== nextDeps?.[depName]?.[scopeName]);
+// Rather than checking equality of the entire object,
+// here, we only shallowly compare the specific properties that are relevant.
+export const shallowDiffByLayerWithKeys = (prevDeps, nextDeps, depName, scopeName, keys) => keys.some(k => (prevDeps?.[depName]?.[scopeName]?.[k] !== nextDeps?.[depName]?.[scopeName]?.[k]));
+export const shallowDiffByChannel = (prevDeps, nextDeps, depName, firstName, secondName) => (prevDeps?.[depName]?.[firstName]?.[secondName]
+    !== nextDeps?.[depName]?.[firstName]?.[secondName]);
+export const shallowDiffByChannelWithKeys = (prevDeps, nextDeps, depName, firstName, secondName, keys) => keys.some(k => (prevDeps?.[depName]?.[firstName]?.[secondName]?.[k]
+    !== nextDeps?.[depName]?.[firstName]?.[secondName]?.[k]));
+export const shallowDiffByLayerCoordination = (prevDeps, nextDeps, depName, layerScope) => (prevDeps?.[depName]?.[0]?.[layerScope]
+    !== nextDeps?.[depName]?.[0]?.[layerScope]);
+export const shallowDiffByLayerCoordinationWithKeys = (prevDeps, nextDeps, depName, layerScope, keys) => keys.some(k => prevDeps?.[depName]?.[0]?.[layerScope]?.[k]
+    !== nextDeps?.[depName]?.[0]?.[layerScope]?.[k]);
+export const shallowDiffByChannelCoordination = (prevDeps, nextDeps, depName, layerScope, channelScope) => (prevDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]
+    !== nextDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]);
+export const shallowDiffByChannelCoordinationWithKeys = (prevDeps, nextDeps, depName, layerScope, channelScope, keys) => keys.some(k => prevDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]?.[k]
+    !== nextDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]?.[k]);
+//# sourceMappingURL=use-memo-custom-comparison.js.map

package/dist-tsc/use-memo-custom-comparison.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitessce/vit-s",
-  "version": "4.0.2",
+  "version": "4.0.4",
   "author": "HIDIVE Lab at HMS",
   "homepage": "http://vitessce.io",
   "repository": {
@@ -31,17 +31,17 @@
     "react-error-boundary": "^5.0.0",
     "@placemarkio/flat-drop-files": "^1.0.2",
     "zarrita": "0.6.1",
-    "@vitessce/error": "4.0.2",
-    "@vitessce/styles": "4.0.2",
-    "@vitessce/abstract": "4.0.2",
-    "@vitessce/constants-internal": "4.0.2",
-    "@vitessce/plugins": "4.0.2",
-    "@vitessce/schemas": "4.0.2",
-    "@vitessce/zarr-utils": "4.0.2",
-    "@vitessce/utils": "4.0.2",
-    "@vitessce/sets-utils": "4.0.2",
-    "@vitessce/globals": "4.0.2",
-    "@vitessce/config": "4.0.2"
+    "@vitessce/styles": "4.0.4",
+    "@vitessce/abstract": "4.0.4",
+    "@vitessce/error": "4.0.4",
+    "@vitessce/schemas": "4.0.4",
+    "@vitessce/constants-internal": "4.0.4",
+    "@vitessce/utils": "4.0.4",
+    "@vitessce/zarr-utils": "4.0.4",
+    "@vitessce/sets-utils": "4.0.4",
+    "@vitessce/plugins": "4.0.4",
+    "@vitessce/config": "4.0.4",
+    "@vitessce/globals": "4.0.4"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",
@@ -50,7 +50,7 @@
     "react-dom": "19.2.6",
     "vite": "^7.0.0",
     "vitest": "^3.1.4",
-    "@vitessce/types": "4.0.2"
+    "@vitessce/types": "4.0.4"
   },
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"

package/src/index.js

@@ -107,3 +107,15 @@ export { logConfig } from './view-config-utils.js';
 export { useAsyncFunction, usePageModeView } from './contexts.js';
 export { createLoaders } from './vitessce-grid-utils.js';
 export { createOnDrop } from './on-drop.js';
+export {
+  useMemoCustomComparison,
+  shallowDiff,
+  shallowDiffByLayer,
+  shallowDiffByLayerWithKeys,
+  shallowDiffByChannel,
+  shallowDiffByChannelWithKeys,
+  shallowDiffByLayerCoordination,
+  shallowDiffByLayerCoordinationWithKeys,
+  shallowDiffByChannelCoordination,
+  shallowDiffByChannelCoordinationWithKeys,
+} from './use-memo-custom-comparison.js';

package/src/use-memo-custom-comparison.js

@@ -0,0 +1,61 @@
+/* eslint-disable no-unused-vars */
+/* eslint-disable max-len */
+import { useRef } from 'react';
+
+/**
+ * A variant of useMemo that accepts a custom equality function
+ * to determine whether the dependencies have changed.
+ * @template T
+ * @param {() => T} factory - Function that computes the memoized value.
+ * @param {any} dependencies - The useMemo dependencies.
+ * @param {(prevDeps: any, nextDeps: any) => boolean} customIsEqual - Custom equality function,
+ * which receives the previous and next dependencies and returns true if they are considered equal.
+ * @returns {T} The memoized value.
+ */
+export function useMemoCustomComparison(factory, dependencies, customIsEqual) {
+  const ref = useRef(/** @type {{ deps: any; value: T } | undefined} */ (undefined));
+
+  if (ref.current === undefined || !customIsEqual(ref.current.deps, dependencies)) {
+    ref.current = { deps: dependencies, value: factory() };
+  }
+
+  return ref.current.value;
+}
+
+
+// Comparison utilties inspired by componentDidUpdate in spatial-beta/Spatial.js:
+export const shallowDiff = (prevDeps, nextDeps, depName) => prevDeps[depName] !== nextDeps[depName];
+export const shallowDiffByLayer = (prevDeps, nextDeps, depName, scopeName) => (
+  prevDeps?.[depName]?.[scopeName] !== nextDeps?.[depName]?.[scopeName]
+);
+// Rather than checking equality of the entire object,
+// here, we only shallowly compare the specific properties that are relevant.
+export const shallowDiffByLayerWithKeys = (prevDeps, nextDeps, depName, scopeName, keys) => keys.some(
+  k => (prevDeps?.[depName]?.[scopeName]?.[k] !== nextDeps?.[depName]?.[scopeName]?.[k]),
+);
+export const shallowDiffByChannel = (prevDeps, nextDeps, depName, firstName, secondName) => (
+  prevDeps?.[depName]?.[firstName]?.[secondName]
+    !== nextDeps?.[depName]?.[firstName]?.[secondName]
+);
+export const shallowDiffByChannelWithKeys = (prevDeps, nextDeps, depName, firstName, secondName, keys) => keys.some(
+  k => (
+    prevDeps?.[depName]?.[firstName]?.[secondName]?.[k]
+        !== nextDeps?.[depName]?.[firstName]?.[secondName]?.[k]
+  ),
+);
+export const shallowDiffByLayerCoordination = (prevDeps, nextDeps, depName, layerScope) => (
+  prevDeps?.[depName]?.[0]?.[layerScope]
+    !== nextDeps?.[depName]?.[0]?.[layerScope]
+);
+export const shallowDiffByLayerCoordinationWithKeys = (prevDeps, nextDeps, depName, layerScope, keys) => keys.some(
+  k => prevDeps?.[depName]?.[0]?.[layerScope]?.[k]
+        !== nextDeps?.[depName]?.[0]?.[layerScope]?.[k],
+);
+export const shallowDiffByChannelCoordination = (prevDeps, nextDeps, depName, layerScope, channelScope) => (
+  prevDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]
+    !== nextDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]
+);
+export const shallowDiffByChannelCoordinationWithKeys = (prevDeps, nextDeps, depName, layerScope, channelScope, keys) => keys.some(
+  k => prevDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]?.[k]
+        !== nextDeps?.[depName]?.[0]?.[layerScope]?.[channelScope]?.[k],
+);