@vitessce/vit-s 3.6.7 → 3.6.8

package/dist-tsc/data-hooks.js

@@ -1,9 +1,9 @@
 import { useState, useEffect, useMemo } from 'react';
 import { CoordinationType, DataType, STATUS } from '@vitessce/constants-internal';
 import { useQuery, useQueries } from '@tanstack/react-query';
-import { LoaderNotFoundError, } from '@vitessce/abstract';
-import { useMultiCoordinationValues, useComplexCoordination, useSetWarning, getMatchingLoader, } from './state/hooks.js';
-import { warn, useDataType, useDataTypeMulti, } from './data-hook-utils.js';
+import { LoaderNotFoundError, } from '@vitessce/error';
+import { useMultiCoordinationValues, useComplexCoordination, getMatchingLoader, } from './state/hooks.js';
+import { useDataType, useDataTypeMulti, } from './data-hook-utils.js';
 /**
  * Get the dataset description string.
  * @param {object} loaders The object mapping
@@ -46,52 +46,190 @@ export function useDescription(loaders, dataset) {
  * @param {object} initialCoordinationValues Object where
  * keys are coordination type names with the prefix 'initialize',
  * values are initialization preferences as boolean values.
- * @returns {array} [cells, cellsCount] where
- * cells is an object and cellsCount is the
- * number of items in the cells object.
+ * @returns {array} [data, status, urls, error]
  */
 export function useObsEmbeddingData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.OBS_EMBEDDING, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useObsSpotsData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.OBS_SPOTS, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useObsPointsData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.OBS_POINTS, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useObsLocationsData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.OBS_LOCATIONS, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useObsLabelsData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.OBS_LABELS, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useObsSegmentationsData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.OBS_SEGMENTATIONS, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useObsSetsData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.OBS_SETS, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useSampleSetsData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.SAMPLE_SETS, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useSampleEdgesData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.SAMPLE_EDGES, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useObsFeatureMatrixData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.OBS_FEATURE_MATRIX, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useFeatureLabelsData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.FEATURE_LABELS, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useImageData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.IMAGE, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useGenomicProfilesData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.GENOMIC_PROFILES, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useNeighborhoodsData(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.NEIGHBORHOODS, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
+/**
+ * Wrapper around useDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} coordinationSetters
+ * @param {object} initialCoordinationValues
+ * @param {object} matchOn
+ * @returns {array} [data, status, urls, error]
+ */
 export function useComparisonMetadata(loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn) {
     return useDataType(DataType.COMPARISON_METADATA, loaders, dataset, isRequired, coordinationSetters, initialCoordinationValues, matchOn);
 }
@@ -106,11 +244,12 @@ export function useComparisonMetadata(loaders, dataset, isRequired, coordination
  * @param {boolean} isRequired Should a warning be thrown if
  * loading is unsuccessful?
  * @param {boolean} selection A list of gene names to get expression data for.
- * @returns {array} [geneData] where geneData is an array [Uint8Array, ..., Uint8Array]
+ * @param {object} matchOn Coordination values used to obtain a matching loader.
+ * @returns {array} [geneData, geneName, status, errors]
+ * where geneData is an array [Uint8Array, ..., Uint8Array]
  * for however many genes are in the selection.
  */
 export function useFeatureSelection(loaders, dataset, isRequired, selection, matchOn) {
-    const setWarning = useSetWarning();
     const featureQueries = useQueries({
         queries: selection?.map(featureId => ({
             structuralSharing: false,
@@ -147,7 +286,7 @@ export function useFeatureSelection(loaders, dataset, isRequired, selection, mat
                 }
                 // No loader was found.
                 if (isRequired) {
-                    throw new LoaderNotFoundError(loaders, dataset, DataType.OBS_FEATURE_MATRIX, matchOn);
+                    throw new LoaderNotFoundError(`Loader not found for parameters: ${dataset}, ${DataType.OBS_FEATURE_MATRIX}, ${JSON.stringify(matchOn)}`);
                 }
                 else {
                     return { data: null, dataKey: null };
@@ -158,6 +297,7 @@ export function useFeatureSelection(loaders, dataset, isRequired, selection, mat
     });
     const anyLoading = featureQueries.some(q => q.isFetching);
     const anyError = featureQueries.some(q => q.isError);
+    const errors = anyError ? featureQueries.filter(q => q.isError).map(q => q.error) : [];
     // eslint-disable-next-line no-nested-ternary
     const dataStatus = anyLoading
         ? STATUS.LOADING
@@ -165,17 +305,7 @@ export function useFeatureSelection(loaders, dataset, isRequired, selection, mat
     const isSuccess = dataStatus === STATUS.SUCCESS;
     const geneData = useMemo(() => (isSuccess ? featureQueries.map(q => q.data?.data || null) : null), [isSuccess, selection, dataset]);
     const loadedGeneName = useMemo(() => (isSuccess ? featureQueries.map(q => q.data?.dataKey || null) : null), [isSuccess, selection, dataset]);
-    useEffect(() => {
-        featureQueries
-            .map(q => q.error)
-            .filter(e => Boolean(e))
-            .forEach((error) => {
-            warn(error, setWarning);
-        });
-        // Deliberate dependency omissions: use indirect dependencies for efficiency.
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [anyError, setWarning]);
-    return [geneData, loadedGeneName, dataStatus];
+    return [geneData, loadedGeneName, dataStatus, errors];
 }
 /**
  * Utility hook function which can be used to define
@@ -191,11 +321,12 @@ export function useFeatureSelection(loaders, dataset, isRequired, selection, mat
  * @param {object} matchOn Coordination values used to obtain a matching loader.
  * @param {object} volcanoOptions Options to pass to the loadMulti function of the loader.
  * @param {string} dataType A data type.
- * @returns {array} [{ df, metadata }] Array of dataframes and their metadata, where
- * df is an object in which each column is stored as an array like { col1: arr1, col2: arr2 }.
+ * @returns {array} [{ df, metadata }, status, urls, error]
+ * Array of dataframes and their metadata, where
+ * df is an object in which each column is stored
+ * as an array like { col1: arr1, col2: arr2 }.
  */
 export function useComparativeDataType(loaders, dataset, isRequired, matchOn, volcanoOptions, dataType) {
-    const setWarning = useSetWarning();
     const placeholderObject = useMemo(() => ({}), []);
     const statsQuery = useQuery({
         // TODO: only enable once `loaders` is available?
@@ -235,7 +366,7 @@ export function useComparativeDataType(loaders, dataset, isRequired, matchOn, vo
             // No loader was found.
             if (isRequired) {
                 // Status: error
-                throw new LoaderNotFoundError(loaders, dataset, dataType, matchOn);
+                throw new LoaderNotFoundError(`Loader not found for parameters: ${dataset}, ${dataType}, ${JSON.stringify(matchOn)}`);
             }
             else {
                 // Status: success
@@ -248,19 +379,41 @@ export function useComparativeDataType(loaders, dataset, isRequired, matchOn, vo
     const loadedData = data?.data || placeholderObject;
     const dataStatus = isFetching ? STATUS.LOADING : status;
     const urls = data?.urls;
-    useEffect(() => {
-        if (error) {
-            setWarning(error.message);
-        }
-    }, [error, setWarning]);
-    return [loadedData, dataStatus, urls];
+    return [loadedData, dataStatus, urls, error];
 }
+/**
+ * Wrapper around useComparativeDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} matchOn
+ * @param {object} volcanoOptions
+ * @returns {array} [data, status, urls, error].
+ */
 export function useFeatureStatsData(loaders, dataset, isRequired, matchOn, volcanoOptions) {
     return useComparativeDataType(loaders, dataset, isRequired, matchOn, volcanoOptions, DataType.FEATURE_STATS);
 }
+/**
+ * Wrapper around useComparativeDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} matchOn
+ * @param {object} volcanoOptions
+ * @returns {array} [data, status, urls, error].
+ */
 export function useFeatureSetStatsData(loaders, dataset, isRequired, matchOn, volcanoOptions) {
     return useComparativeDataType(loaders, dataset, isRequired, matchOn, volcanoOptions, DataType.FEATURE_SET_STATS);
 }
+/**
+ * Wrapper around useComparativeDataType.
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {boolean} isRequired
+ * @param {object} matchOn
+ * @param {object} volcanoOptions
+ * @returns {array} [data, status, urls, error].
+ */
 export function useObsSetStatsData(loaders, dataset, isRequired, matchOn, volcanoOptions) {
     return useComparativeDataType(loaders, dataset, isRequired, matchOn, volcanoOptions, DataType.OBS_SET_STATS);
 }
@@ -276,10 +429,11 @@ export function useObsSetStatsData(loaders, dataset, isRequired, matchOn, volcan
  * used to identify which loader to use.
  * @param {boolean} isRequired Should a warning be thrown if
  * loading is unsuccessful?
- * @returns {object} [attrs] { rows, cols } object containing cell and gene names.
+ * @param {object} matchOn Coordination values used to obtain a matching loader.
+ * @returns {object} [attrs, status, urls, error]
+ * where attrs is { rows, cols } object containing cell and gene names.
  */
 export function useObsFeatureMatrixIndices(loaders, dataset, isRequired, matchOn) {
-    const setWarning = useSetWarning();
     const placeholderObject = useMemo(() => ({}), []);
     const indicesQuery = useQuery({
         // TODO: only enable once `loaders` is available?
@@ -327,7 +481,7 @@ export function useObsFeatureMatrixIndices(loaders, dataset, isRequired, matchOn
             // No loader was found.
             if (isRequired) {
                 // Status: error
-                throw new LoaderNotFoundError(loaders, dataset, DataType.OBS_FEATURE_MATRIX, matchOn);
+                throw new LoaderNotFoundError(`Loader not found for parameters: ${dataset}, ${DataType.OBS_FEATURE_MATRIX}, ${JSON.stringify(matchOn)}`);
             }
             else {
                 // Status: success
@@ -340,13 +494,18 @@ export function useObsFeatureMatrixIndices(loaders, dataset, isRequired, matchOn
     const loadedData = data?.data || placeholderObject;
     const dataStatus = isFetching ? STATUS.LOADING : status;
     const urls = data?.urls;
-    useEffect(() => {
-        if (error) {
-            setWarning(error.message);
-        }
-    }, [error, setWarning]);
-    return [loadedData, dataStatus, urls];
+    return [loadedData, dataStatus, urls, error];
 }
+/**
+ * Wrapper around useDataTypeMulti.
+ * @param {object} coordinationScopes
+ * @param {object} coordinationScopesBy
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {function} mergeCoordination
+ * @param {string} viewUid
+ * @returns {array} [data, status, urls, errors]
+ */
 export function useMultiObsPoints(coordinationScopes, coordinationScopesBy, loaders, dataset, mergeCoordination, viewUid) {
     const obsTypeCoordination = useComplexCoordination([
         CoordinationType.OBS_TYPE,
@@ -356,9 +515,19 @@ export function useMultiObsPoints(coordinationScopes, coordinationScopesBy, load
     // use coordinationScopes and coordinationScopesBy which are
     // indirect dependencies here.
     [coordinationScopes, coordinationScopesBy]);
-    const [obsPointsData, obsPointsDataStatus, obsPointsUrls] = useDataTypeMulti(DataType.OBS_POINTS, loaders, dataset, false, {}, {}, matchOnObj, mergeCoordination, viewUid);
-    return [obsPointsData, obsPointsDataStatus, obsPointsUrls];
+    const [obsPointsData, obsPointsDataStatus, obsPointsUrls, obsPointsErrors] = useDataTypeMulti(DataType.OBS_POINTS, loaders, dataset, false, {}, {}, matchOnObj, mergeCoordination, viewUid);
+    return [obsPointsData, obsPointsDataStatus, obsPointsUrls, obsPointsErrors];
 }
+/**
+ * Wrapper around useDataTypeMulti.
+ * @param {object} coordinationScopes
+ * @param {object} coordinationScopesBy
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {function} mergeCoordination
+ * @param {string} viewUid
+ * @returns {array} [data, status, urls, errors]
+ */
 export function useMultiObsSpots(coordinationScopes, coordinationScopesBy, loaders, dataset, mergeCoordination, viewUid) {
     const obsTypeCoordination = useComplexCoordination([
         CoordinationType.OBS_TYPE,
@@ -368,9 +537,19 @@ export function useMultiObsSpots(coordinationScopes, coordinationScopesBy, loade
     // use coordinationScopes and coordinationScopesBy which are
     // indirect dependencies here.
     [coordinationScopes, coordinationScopesBy]);
-    const [obsSpotsData, obsSpotsDataStatus, obsSpotsUrls] = useDataTypeMulti(DataType.OBS_SPOTS, loaders, dataset, false, {}, {}, matchOnObj, mergeCoordination, viewUid);
-    return [obsSpotsData, obsSpotsDataStatus, obsSpotsUrls];
+    const [obsSpotsData, obsSpotsDataStatus, obsSpotsUrls, obsSpotsErrors] = useDataTypeMulti(DataType.OBS_SPOTS, loaders, dataset, false, {}, {}, matchOnObj, mergeCoordination, viewUid);
+    return [obsSpotsData, obsSpotsDataStatus, obsSpotsUrls, obsSpotsErrors];
 }
+/**
+ * Wrapper around useDataTypeMulti.
+ * @param {object} coordinationScopes
+ * @param {object} coordinationScopesBy
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {function} mergeCoordination
+ * @param {string} viewUid
+ * @returns {array} [data, status, urls, errors]
+ */
 export function useSpotMultiObsSets(coordinationScopes, coordinationScopesBy, loaders, dataset) {
     const obsTypeCoordination = useComplexCoordination([
         CoordinationType.OBS_TYPE,
@@ -380,9 +559,19 @@ export function useSpotMultiObsSets(coordinationScopes, coordinationScopesBy, lo
     // use coordinationScopes and coordinationScopesBy which are
     // indirect dependencies here.
     [coordinationScopes, coordinationScopesBy]);
-    const [obsSetsData, obsSetsDataStatus, obsSetsUrls] = useDataTypeMulti(DataType.OBS_SETS, loaders, dataset, false, {}, {}, matchOnObj);
-    return [obsSetsData, obsSetsDataStatus, obsSetsUrls];
+    const [obsSetsData, obsSetsDataStatus, obsSetsUrls, obsSetsErrors] = useDataTypeMulti(DataType.OBS_SETS, loaders, dataset, false, {}, {}, matchOnObj);
+    return [obsSetsData, obsSetsDataStatus, obsSetsUrls, obsSetsErrors];
 }
+/**
+ * Wrapper around useDataTypeMulti.
+ * @param {object} coordinationScopes
+ * @param {object} coordinationScopesBy
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {function} mergeCoordination
+ * @param {string} viewUid
+ * @returns {array} [data, status, urls, errors]
+ */
 export function useSpotMultiFeatureLabels(coordinationScopes, coordinationScopesBy, loaders, dataset) {
     const featureTypeCoordination = useComplexCoordination([
         CoordinationType.FEATURE_TYPE,
@@ -392,18 +581,43 @@ export function useSpotMultiFeatureLabels(coordinationScopes, coordinationScopes
     // use coordinationScopes and coordinationScopesBy which are
     // indirect dependencies here.
     [coordinationScopes, coordinationScopesBy]);
-    const [featureLabelsData, featureLabelsStatus, featureLabelsUrls] = useDataTypeMulti(DataType.FEATURE_LABELS, loaders, dataset, false, {}, {}, matchOnObj);
-    return [featureLabelsData, featureLabelsStatus, featureLabelsUrls];
+    const [featureLabelsData, featureLabelsStatus, featureLabelsUrls, featureLabelsErrors,] = useDataTypeMulti(DataType.FEATURE_LABELS, loaders, dataset, false, {}, {}, matchOnObj);
+    return [
+        featureLabelsData,
+        featureLabelsStatus,
+        featureLabelsUrls,
+        featureLabelsErrors,
+    ];
 }
+/**
+ * Wrapper around useDataTypeMulti.
+ * @param {object} coordinationScopes
+ * @param {object} coordinationScopesBy
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {function} mergeCoordination
+ * @param {string} viewUid
+ * @returns {array} [labelsTypes, data, status, urls, errors]
+ */
 export function useMultiObsLabels(coordinationScopes, obsType, loaders, dataset) {
     const obsLabelsTypes = useMultiCoordinationValues(CoordinationType.OBS_LABELS_TYPE, coordinationScopes);
     const obsLabelsMatchOnObj = useMemo(() => Object.fromEntries(Object.entries(obsLabelsTypes).map(([scope, obsLabelsType]) => ([
         scope,
         { obsLabelsType, obsType },
     ]))), [obsLabelsTypes, obsType]);
-    const [obsLabelsData, obsLabelsDataStatus, obsLabelsUrls] = useDataTypeMulti(DataType.OBS_LABELS, loaders, dataset, false, {}, {}, obsLabelsMatchOnObj);
-    return [obsLabelsTypes, obsLabelsData, obsLabelsDataStatus, obsLabelsUrls];
+    const [obsLabelsData, obsLabelsDataStatus, obsLabelsUrls, obsLabelsErrors] = useDataTypeMulti(DataType.OBS_LABELS, loaders, dataset, false, {}, {}, obsLabelsMatchOnObj);
+    return [obsLabelsTypes, obsLabelsData, obsLabelsDataStatus, obsLabelsUrls, obsLabelsErrors];
 }
+/**
+ * Wrapper around useDataTypeMulti.
+ * @param {object} coordinationScopes
+ * @param {object} coordinationScopesBy
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {function} mergeCoordination
+ * @param {string} viewUid
+ * @returns {array} [data, status, urls, errors]
+ */
 export function useMultiObsSegmentations(coordinationScopes, coordinationScopesBy, loaders, dataset, mergeCoordination, viewUid) {
     const imageCoordination = useComplexCoordination([
         CoordinationType.FILE_UID,
@@ -413,9 +627,24 @@ export function useMultiObsSegmentations(coordinationScopes, coordinationScopesB
     // use coordinationScopes and coordinationScopesBy which are
     // indirect dependencies here.
     [coordinationScopes, coordinationScopesBy]);
-    const [obsSegmentationsData, obsSegmentationsDataStatus, obsSegmentationsUrls,] = useDataTypeMulti(DataType.OBS_SEGMENTATIONS, loaders, dataset, false, {}, {}, matchOnObj, mergeCoordination, viewUid);
-    return [obsSegmentationsData, obsSegmentationsDataStatus, obsSegmentationsUrls];
+    const [obsSegmentationsData, obsSegmentationsDataStatus, obsSegmentationsUrls, obsSegmentationsErrors,] = useDataTypeMulti(DataType.OBS_SEGMENTATIONS, loaders, dataset, false, {}, {}, matchOnObj, mergeCoordination, viewUid);
+    return [
+        obsSegmentationsData,
+        obsSegmentationsDataStatus,
+        obsSegmentationsUrls,
+        obsSegmentationsErrors,
+    ];
 }
+/**
+ * Wrapper around useDataTypeMulti.
+ * @param {object} coordinationScopes
+ * @param {object} coordinationScopesBy
+ * @param {object} loaders
+ * @param {string} dataset
+ * @param {function} mergeCoordination
+ * @param {string} viewUid
+ * @returns {array} [data, status, urls, errors]
+ */
 export function useMultiImages(coordinationScopes, coordinationScopesBy, loaders, dataset, mergeCoordination, viewUid) {
     // TODO: delegate the generation of matchOnObj to a different hoook and pass as a parameter?
     // (in all of the useMulti data hooks)?
@@ -427,6 +656,6 @@ export function useMultiImages(coordinationScopes, coordinationScopesBy, loaders
     // use coordinationScopes and coordinationScopesBy which are
     // indirect dependencies here.
     [coordinationScopes, coordinationScopesBy]);
-    const [imageData, imageDataStatus, imageUrls] = useDataTypeMulti(DataType.IMAGE, loaders, dataset, false, {}, {}, matchOnObj, mergeCoordination, viewUid);
-    return [imageData, imageDataStatus, imageUrls];
+    const [imageData, imageDataStatus, imageUrls, imageErrors] = useDataTypeMulti(DataType.IMAGE, loaders, dataset, false, {}, {}, matchOnObj, mergeCoordination, viewUid);
+    return [imageData, imageDataStatus, imageUrls, imageErrors];
 }

package/dist-tsc/hooks.js

@@ -306,7 +306,7 @@ export function useExpandedFeatureLabelsMap(featureType, featureLabelsMap, optio
             ...(stripCuriePrefixes
                 ? Array.from(fetchedMapping).map(([k, v]) => ([k.split(':')[1], v.split(':')[1]]))
                 : fetchedMapping),
-            ...(featureLabelsMap || []),
+            ...Array.from(featureLabelsMap?.entries() || []),
         ]);
     }, [fetchedMapping, featureLabelsMap, stripCuriePrefixes]);
     // If not enabled, return success

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitessce/vit-s",
-  "version": "3.6.7",
+  "version": "3.6.8",
   "author": "HIDIVE Lab at HMS",
   "homepage": "http://vitessce.io",
   "repository": {
@@ -28,15 +28,16 @@
     "zustand": "^5.0.4",
     "react-aria": "^3.28.0",
     "react-error-boundary": "^5.0.0",
-    "@vitessce/styles": "3.6.7",
-    "@vitessce/abstract": "3.6.7",
-    "@vitessce/constants-internal": "3.6.7",
-    "@vitessce/plugins": "3.6.7",
-    "@vitessce/schemas": "3.6.7",
-    "@vitessce/utils": "3.6.7",
-    "@vitessce/sets-utils": "3.6.7",
-    "@vitessce/config": "3.6.7",
-    "@vitessce/globals": "3.6.7"
+    "@vitessce/styles": "3.6.8",
+    "@vitessce/abstract": "3.6.8",
+    "@vitessce/constants-internal": "3.6.8",
+    "@vitessce/plugins": "3.6.8",
+    "@vitessce/schemas": "3.6.8",
+    "@vitessce/error": "3.6.8",
+    "@vitessce/utils": "3.6.8",
+    "@vitessce/sets-utils": "3.6.8",
+    "@vitessce/config": "3.6.8",
+    "@vitessce/globals": "3.6.8"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",
@@ -45,7 +46,7 @@
     "react-dom": "^18.0.0",
     "vite": "^6.3.5",
     "vitest": "^3.1.4",
-    "@vitessce/types": "3.6.7"
+    "@vitessce/types": "3.6.8"
   },
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"