@haniffalab/cherita-react 1.3.0-dev.2025-06-06.f1eddad0 → 1.3.1-dev.2025-10-29.6de4119f

package/dist/cjs/components/violin/Violin.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.Violin = Violin;
-var _react = _interopRequireWildcard(require("react"));
+var _react = require("react");
 var _freeSolidSvgIcons = require("@fortawesome/free-solid-svg-icons");
 var _reactFontawesome = require("@fortawesome/react-fontawesome");
 var _lodash = _interopRequireDefault(require("lodash"));
@@ -16,16 +16,18 @@ var _FilterContext = require("../../context/FilterContext");
 var _SettingsContext = require("../../context/SettingsContext");
 var _LoadingIndicators = require("../../utils/LoadingIndicators");
 var _requests = require("../../utils/requests");
+var _Resolver = require("../../utils/Resolver");
+var _StyledTooltip = require("../../utils/StyledTooltip");
+var _PlotAlert = require("../full-page/PlotAlert");
 var _Toolbar = require("../toolbar/Toolbar");
+var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function Violin(_ref) {
-  var _settings$selectedVar, _settings$selectedVar2, _settings$selectedVar3, _settings$selectedVar4, _settings$selectedObs, _settings$selectedObs2, _settings$selectedObs3;
   let {
     mode = _constants.VIOLIN_MODES.MULTIKEY,
     showObsBtn = false,
@@ -33,9 +35,11 @@ function Violin(_ref) {
     showCtrlsBtn = false,
     setShowObs,
     setShowVars,
-    setShowControls
+    setShowControls,
+    plotType,
+    setPlotType
   } = _ref;
-  const ENDPOINT = "violin";
+  const ENDPOINT = 'violin';
   const dataset = (0, _DatasetContext.useDataset)();
   const settings = (0, _SettingsContext.useSettings)();
   const {
@@ -45,91 +49,63 @@ function Violin(_ref) {
   const [data, setData] = (0, _react.useState)([]);
   const [layout, setLayout] = (0, _react.useState)({});
   const [hasSelections, setHasSelections] = (0, _react.useState)(false);
-  const [params, setParams] = (0, _react.useState)(_objectSpread({
+  const selectedMultiVar = (0, _Resolver.useSelectedMultiVar)();
+  const selectedVar = (0, _Resolver.useSelectedVar)();
+  const selectedObs = (0, _Resolver.useSelectedObs)();
+  const params = (0, _react.useMemo)(() => _objectSpread({
     url: dataset.url,
     mode: mode,
     scale: settings.controls.scale.violinplot,
     varNamesCol: dataset.varNamesCol
   }, {
     [_constants.VIOLIN_MODES.MULTIKEY]: {
-      varKeys: settings.selectedMultiVar.map(i => i.isSet ? {
+      varKeys: selectedMultiVar.map(i => i.isSet ? {
         name: i.name,
         indices: i.vars.map(v => v.index)
       } : i.index),
       obsKeys: [] // @TODO: implement
     },
     [_constants.VIOLIN_MODES.GROUPBY]: {
-      varKey: (_settings$selectedVar = settings.selectedVar) !== null && _settings$selectedVar !== void 0 && _settings$selectedVar.isSet ? {
-        name: (_settings$selectedVar2 = settings.selectedVar) === null || _settings$selectedVar2 === void 0 ? void 0 : _settings$selectedVar2.name,
-        indices: (_settings$selectedVar3 = settings.selectedVar) === null || _settings$selectedVar3 === void 0 ? void 0 : _settings$selectedVar3.vars.map(v => v.index)
-      } : (_settings$selectedVar4 = settings.selectedVar) === null || _settings$selectedVar4 === void 0 ? void 0 : _settings$selectedVar4.index,
-      obsCol: settings.selectedObs,
-      obsValues: !((_settings$selectedObs = settings.selectedObs) !== null && _settings$selectedObs !== void 0 && _settings$selectedObs.omit.length) ? null : _lodash.default.difference(_lodash.default.values((_settings$selectedObs2 = settings.selectedObs) === null || _settings$selectedObs2 === void 0 ? void 0 : _settings$selectedObs2.codes), (_settings$selectedObs3 = settings.selectedObs) === null || _settings$selectedObs3 === void 0 ? void 0 : _settings$selectedObs3.omit).map(c => {
-        var _settings$selectedObs4;
-        return (_settings$selectedObs4 = settings.selectedObs) === null || _settings$selectedObs4 === void 0 ? void 0 : _settings$selectedObs4.codesMap[c];
-      }),
+      varKey: selectedVar !== null && selectedVar !== void 0 && selectedVar.isSet ? {
+        name: selectedVar === null || selectedVar === void 0 ? void 0 : selectedVar.name,
+        indices: selectedVar === null || selectedVar === void 0 ? void 0 : selectedVar.vars.map(v => v.index)
+      } : selectedVar === null || selectedVar === void 0 ? void 0 : selectedVar.index,
+      obsCol: selectedObs,
+      obsValues: !(selectedObs !== null && selectedObs !== void 0 && selectedObs.omit.length) ? null : _lodash.default.difference(selectedObs === null || selectedObs === void 0 ? void 0 : selectedObs.values, selectedObs === null || selectedObs === void 0 ? void 0 : selectedObs.omit),
       obsIndices: isSliced ? [...(obsIndices || [])] : null
     }
-  }[mode]));
+  }[mode]), [dataset.url, dataset.varNamesCol, isSliced, mode, obsIndices, selectedMultiVar, selectedObs, selectedVar === null || selectedVar === void 0 ? void 0 : selectedVar.index, selectedVar === null || selectedVar === void 0 ? void 0 : selectedVar.isSet, selectedVar === null || selectedVar === void 0 ? void 0 : selectedVar.name, selectedVar === null || selectedVar === void 0 ? void 0 : selectedVar.vars, settings.controls.scale.violinplot]);
   // @TODO: set default scale
 
   (0, _react.useEffect)(() => {
     if (mode === _constants.VIOLIN_MODES.MULTIKEY) {
-      if (settings.selectedMultiVar.length) {
+      if (selectedMultiVar.length) {
         setHasSelections(true);
       } else {
         setHasSelections(false);
       }
-      setParams(p => {
-        return _objectSpread(_objectSpread({}, p), {}, {
-          url: dataset.url,
-          mode: mode,
-          varKeys: settings.selectedMultiVar.map(i => i.isSet ? {
-            name: i.name,
-            indices: i.vars.map(v => v.index)
-          } : i.index),
-          scale: settings.controls.scale.violinplot,
-          varNamesCol: dataset.varNamesCol
-        });
-      });
     } else if (mode === _constants.VIOLIN_MODES.GROUPBY) {
-      if (settings.selectedObs && settings.selectedVar) {
+      if (selectedObs && selectedVar) {
         setHasSelections(true);
       } else {
         setHasSelections(false);
       }
-      setParams(p => {
-        var _settings$selectedVar5, _settings$selectedVar6, _settings$selectedVar7, _settings$selectedVar8, _settings$selectedObs5, _settings$selectedObs6, _settings$selectedObs7;
-        return _objectSpread(_objectSpread({}, p), {}, {
-          url: dataset.url,
-          mode: mode,
-          varKey: (_settings$selectedVar5 = settings.selectedVar) !== null && _settings$selectedVar5 !== void 0 && _settings$selectedVar5.isSet ? {
-            name: (_settings$selectedVar6 = settings.selectedVar) === null || _settings$selectedVar6 === void 0 ? void 0 : _settings$selectedVar6.name,
-            indices: (_settings$selectedVar7 = settings.selectedVar) === null || _settings$selectedVar7 === void 0 ? void 0 : _settings$selectedVar7.vars.map(v => v.index)
-          } : (_settings$selectedVar8 = settings.selectedVar) === null || _settings$selectedVar8 === void 0 ? void 0 : _settings$selectedVar8.index,
-          obsCol: settings.selectedObs,
-          obsValues: !((_settings$selectedObs5 = settings.selectedObs) !== null && _settings$selectedObs5 !== void 0 && _settings$selectedObs5.omit.length) ? null : _lodash.default.difference(_lodash.default.values((_settings$selectedObs6 = settings.selectedObs) === null || _settings$selectedObs6 === void 0 ? void 0 : _settings$selectedObs6.codes), (_settings$selectedObs7 = settings.selectedObs) === null || _settings$selectedObs7 === void 0 ? void 0 : _settings$selectedObs7.omit).map(c => {
-            var _settings$selectedObs8;
-            return (_settings$selectedObs8 = settings.selectedObs) === null || _settings$selectedObs8 === void 0 ? void 0 : _settings$selectedObs8.codesMap[c];
-          }),
-          obsIndices: isSliced ? [...(obsIndices || [])] : null,
-          scale: settings.controls.scale.violinplot,
-          varNamesCol: dataset.varNamesCol
-        });
-      });
     }
-  }, [settings.controls.scale.violinplot, settings.selectedMultiVar, settings.selectedObs, settings.selectedVar, dataset.url, dataset.varNamesCol, obsIndices, isSliced, mode]);
+  }, [settings.controls.scale.violinplot, selectedMultiVar, selectedObs, selectedVar, dataset.url, dataset.varNamesCol, obsIndices, isSliced, mode]);
   const {
     fetchedData,
     isPending,
     serverError
   } = (0, _requests.useDebouncedFetch)(ENDPOINT, params, 500, {
-    enabled: mode === _constants.VIOLIN_MODES.MULTIKEY && (!!params.varKeys.length || !!params.obsKeys.length) || mode === _constants.VIOLIN_MODES.GROUPBY && !!params.varKey && !!params.obsCol
+    isEnabled: mode === _constants.VIOLIN_MODES.MULTIKEY && (params => !!params.varKeys.length || !!params.obsKeys.length) || mode === _constants.VIOLIN_MODES.GROUPBY && (params => !!params.varKey && !!params.obsCol)
   });
   (0, _react.useEffect)(() => {
-    if (hasSelections && !isPending && !serverError) {
+    if (hasSelections && !!fetchedData && !isPending && !serverError) {
       setData(fetchedData.data);
       setLayout(fetchedData.layout);
+    } else {
+      setData([]);
+      setLayout({});
     }
   }, [fetchedData, hasSelections, isPending, serverError]);
   const customModeBarButtons = _lodash.default.compact([showObsBtn && (0, _Toolbar.ObsPlotlyToolbar)({
@@ -142,51 +118,87 @@ function Violin(_ref) {
   const modeBarButtons = customModeBarButtons.length ? [customModeBarButtons, _constants.PLOTLY_MODEBAR_BUTTONS] : [_constants.PLOTLY_MODEBAR_BUTTONS];
   if (!serverError) {
     if (hasSelections) {
-      return /*#__PURE__*/_react.default.createElement("div", {
-        className: "cherita-plot cherita-violin position-relative"
-      }, isPending && /*#__PURE__*/_react.default.createElement(_LoadingIndicators.LoadingSpinner, null), /*#__PURE__*/_react.default.createElement(_reactPlotly.default, {
-        data: data,
-        layout: layout,
-        useResizeHandler: true,
-        style: {
-          width: "100%",
-          height: "100%"
-        },
-        config: {
-          displaylogo: false,
-          modeBarButtons: modeBarButtons
-        }
-      }), (fetchedData === null || fetchedData === void 0 ? void 0 : fetchedData.resampled) && /*#__PURE__*/_react.default.createElement(_reactBootstrap.Alert, {
-        variant: "warning"
-      }, /*#__PURE__*/_react.default.createElement("b", null, "Warning:"), " For performance reasons this plot was generated with resampled data. It will not be exactly the same as one produced with the entire dataset. \xA0", /*#__PURE__*/_react.default.createElement(_reactBootstrap.OverlayTrigger, {
-        placement: "top",
-        overlay: /*#__PURE__*/_react.default.createElement(_reactBootstrap.Tooltip, null, "Resampled to 100K values following a Monte Carlo style approach to help ensure resampled data is a good representation of the original dataset's distribution.")
-      }, /*#__PURE__*/_react.default.createElement(_reactFontawesome.FontAwesomeIcon, {
-        icon: _freeSolidSvgIcons.faCircleInfo
-      }))));
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+        className: "cherita-plot cherita-violin",
+        children: [isPending && /*#__PURE__*/(0, _jsxRuntime.jsx)(_LoadingIndicators.LoadingSpinner, {}), /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+          className: "d-flex flex-column h-100",
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+            className: "flex-grow-1 position-relative",
+            style: {
+              minHeight: '0'
+            },
+            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactPlotly.default, {
+              data: data,
+              layout: layout,
+              useResizeHandler: true,
+              style: {
+                width: '100%',
+                height: '100%'
+              },
+              config: {
+                displaylogo: false,
+                modeBarButtons: modeBarButtons
+              }
+            })
+          }), (fetchedData === null || fetchedData === void 0 ? void 0 : fetchedData.resampled) && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+            className: "resampled-tooltip-container",
+            children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_StyledTooltip.StyledTooltip, {
+              title: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+                children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("strong", {
+                  children: "Note:"
+                }), " This plot uses resampled data to improve performance, so values may differ slightly from the full dataset. The data were resampled to exactly 100,000 values using a Monte Carlo\u2013style approach to provide a representative view of the full distribution while reducing processing time."]
+              }),
+              placement: "bottom",
+              children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactBootstrap.Badge, {
+                bg: "info",
+                children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactFontawesome.FontAwesomeIcon, {
+                  className: "fs-6",
+                  icon: _freeSolidSvgIcons.faCircleInfo
+                }), /*#__PURE__*/(0, _jsxRuntime.jsx)("span", {
+                  className: "d-none d-lg-inline ms-2 fs-6 text-uppercase",
+                  children: "Resampled"
+                })]
+              })
+            })
+          })]
+        })]
+      });
     }
-    return /*#__PURE__*/_react.default.createElement("div", {
-      className: "cherita-violin"
-    }, mode === _constants.VIOLIN_MODES.MULTIKEY && /*#__PURE__*/_react.default.createElement(_reactBootstrap.Alert, {
-      variant: "light"
-    }, "Select", " ", showVarsBtn ? /*#__PURE__*/_react.default.createElement(_reactBootstrap.Button, {
-      variant: "link",
-      className: "border-0 p-0 align-baseline",
-      onClick: setShowVars
-    }, "features") : "features"), mode === _constants.VIOLIN_MODES.GROUPBY && /*#__PURE__*/_react.default.createElement(_reactBootstrap.Alert, {
-      variant: "light"
-    }, "Select", " ", showObsBtn ? /*#__PURE__*/_react.default.createElement(_reactBootstrap.Button, {
-      variant: "link",
-      className: "border-0 p-0 align-baseline",
-      onClick: setShowObs
-    }, "categories") : "categories", " ", "and a", " ", showVarsBtn ? /*#__PURE__*/_react.default.createElement(_reactBootstrap.Button, {
-      variant: "link",
-      className: "border-0 p-0 align-baseline",
-      onClick: setShowVars
-    }, "feature") : "feature"));
+    return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_PlotAlert.PlotAlert, {
+      variant: "info",
+      heading: "Set up your violin plot",
+      plotType: plotType,
+      setPlotType: setPlotType,
+      children: [mode === _constants.VIOLIN_MODES.MULTIKEY && /*#__PURE__*/(0, _jsxRuntime.jsxs)("p", {
+        className: "p-0 m-0",
+        children: ["Select one or more", ' ', showVarsBtn ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactBootstrap.Button, {
+          variant: "link",
+          className: "border-0 p-0 align-baseline",
+          onClick: setShowVars,
+          children: "features"
+        }) : 'features', ' ', "to display their expression distributions across all observations."]
+      }), mode === _constants.VIOLIN_MODES.GROUPBY && /*#__PURE__*/(0, _jsxRuntime.jsxs)("p", {
+        className: "p-0 m-0",
+        children: ["Select a", ' ', showObsBtn ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactBootstrap.Button, {
+          variant: "link",
+          className: "border-0 p-0 align-baseline",
+          onClick: setShowObs,
+          children: "category"
+        }) : 'category', ' ', "to group observations, and choose a", ' ', showVarsBtn ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactBootstrap.Button, {
+          variant: "link",
+          className: "border-0 p-0 align-baseline",
+          onClick: setShowVars,
+          children: "feature"
+        }) : 'feature', ' ', "to view its distribution within each group."]
+      })]
+    });
   } else {
-    return /*#__PURE__*/_react.default.createElement("div", null, /*#__PURE__*/_react.default.createElement(_reactBootstrap.Alert, {
-      variant: "danger"
-    }, serverError.message));
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PlotAlert.PlotAlert, {
+      variant: "danger",
+      heading: "Error displaying the violin plot",
+      plotType: plotType,
+      setPlotType: setPlotType,
+      children: serverError.message || 'An unexpected error occurred while generating the plot.'
+    });
   }
 }

package/dist/cjs/components/violin/ViolinControls.js

@@ -4,12 +4,15 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.ViolinControls = ViolinControls;
-var _react = _interopRequireDefault(require("react"));
 var _reactBootstrap = require("react-bootstrap");
 var _Controls = require("../controls/Controls");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+var _jsxRuntime = require("react/jsx-runtime");
 function ViolinControls() {
-  return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement(_reactBootstrap.Form, null, /*#__PURE__*/_react.default.createElement(_Controls.ScaleSelect, {
-    plot: "violinplot"
-  })));
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactBootstrap.Form, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Controls.ScaleSelect, {
+        plot: "violinplot"
+      })
+    })
+  });
 }

package/dist/cjs/constants/colorscales.js

@@ -6,23 +6,23 @@ Object.defineProperty(exports, "__esModule", {
 exports.COLORSCALES = void 0;
 // From plotly https://github.com/plotly/plotly.js/blob/5bc25b490702e5ed61265207833dbd58e8ab27f1/src/components/colorscale/scales.js
 const COLORSCALES = exports.COLORSCALES = {
-  Greys: ["#000000", "#ffffff"],
-  YlGnBu: ["#081d58", "#253494", "#225ea8", "#1d91c0", "#41b6c4", "#7fcdbb", "#c7e9b4", "#edf8d9", "#ffffd9"],
-  Greens: ["#00441b", "#006d2c", "#238b45", "#41ab5d", "#74c476", "#a1d9a5", "#c7e9c0", "#e5f5e0", "#f7fcf5"],
-  YlOrRd: ["#800026", "#bd0026", "#e31a1c", "#fc4e2a", "#fd8d3c", "#feb24c", "#fed976", "#ffed9f", "#ffffcc"],
-  Bluered: ["#0000ff", "#ff0000"],
-  RdBu: ["#050aac", "#6a89f7", "#bebebe", "#dcaa84", "#e6915a", "#b20a1c"],
-  Reds: ["#dcdcdc", "#f5c39d", "#f5a069", "#b20a1c"],
-  Blues: ["#050aac", "#283cba", "#4664f5", "#5a78f5", "#6a89f7", "#dcdcdc"],
-  Picnic: ["#0000ff", "#3399ff", "#66ccff", "#99ccff", "#ccccff", "#ffffff", "#ffccff", "#ff99ff", "#ff66cc", "#ff6666", "#ff0000"],
-  Rainbow: ["#96005a", "#0000c8", "#0019ff", "#0098ff", "#2cff96", "#97ff00", "#ffe600", "#ff6f00", "#ff0000"],
-  Portland: ["#0c3383", "#0a88ba", "#f2d338", "#f28f38", "#d91e1e"],
-  Jet: ["#000083", "#003caa", "#05ffff", "#ffff00", "#fa0000", "#800000"],
-  Hot: ["#000000", "#e60000", "#ffd200", "#ffffff"],
-  Blackbody: ["#000000", "#e60000", "#e6d200", "#ffffff", "#a0c8ff"],
-  Earth: ["#000082", "#00b4b4", "#28d228", "#e6e632", "#784614", "#ffffff"],
-  Electric: ["#000000", "#1e0064", "#780064", "#a05a00", "#e6c800", "#fffadc"],
-  Viridis: ["#440154", "#48186a", "#472d7b", "#424086", "#3b528b", "#33638d", "#2c728e", "#26828e", "#21918c", "#1fa088", "#28ae80", "#3fbc73", "#5ec962", "#84d44b", "#addc30", "#d8e219", "#fde725"],
-  Cividis: ["#00204c", "#002a66", "#00346e", "#273f6c", "#3c4a6c", "#4c556b", "#5b5f6d", "#686a70", "#757575", "#838178", "#929c78", "#a19676", "#b0a572", "#c0af6d", "#d1ba65", "#e1c75c", "#f3db4f", "#ffe945"],
-  Accent: ["#7fc97f", "#beaed4", "#fdc086", "#ffff99", "#386cb0", "#f0027f", "#bf5b17", "#666666"]
+  Greys: ['#000000', '#ffffff'],
+  YlGnBu: ['#081d58', '#253494', '#225ea8', '#1d91c0', '#41b6c4', '#7fcdbb', '#c7e9b4', '#edf8d9', '#ffffd9'],
+  Greens: ['#00441b', '#006d2c', '#238b45', '#41ab5d', '#74c476', '#a1d9a5', '#c7e9c0', '#e5f5e0', '#f7fcf5'],
+  YlOrRd: ['#800026', '#bd0026', '#e31a1c', '#fc4e2a', '#fd8d3c', '#feb24c', '#fed976', '#ffed9f', '#ffffcc'],
+  Bluered: ['#0000ff', '#ff0000'],
+  RdBu: ['#050aac', '#6a89f7', '#bebebe', '#dcaa84', '#e6915a', '#b20a1c'],
+  Reds: ['#dcdcdc', '#f5c39d', '#f5a069', '#b20a1c'],
+  Blues: ['#050aac', '#283cba', '#4664f5', '#5a78f5', '#6a89f7', '#dcdcdc'],
+  Picnic: ['#0000ff', '#3399ff', '#66ccff', '#99ccff', '#ccccff', '#ffffff', '#ffccff', '#ff99ff', '#ff66cc', '#ff6666', '#ff0000'],
+  Rainbow: ['#96005a', '#0000c8', '#0019ff', '#0098ff', '#2cff96', '#97ff00', '#ffe600', '#ff6f00', '#ff0000'],
+  Portland: ['#0c3383', '#0a88ba', '#f2d338', '#f28f38', '#d91e1e'],
+  Jet: ['#000083', '#003caa', '#05ffff', '#ffff00', '#fa0000', '#800000'],
+  Hot: ['#000000', '#e60000', '#ffd200', '#ffffff'],
+  Blackbody: ['#000000', '#e60000', '#e6d200', '#ffffff', '#a0c8ff'],
+  Earth: ['#000082', '#00b4b4', '#28d228', '#e6e632', '#784614', '#ffffff'],
+  Electric: ['#000000', '#1e0064', '#780064', '#a05a00', '#e6c800', '#fffadc'],
+  Viridis: ['#440154', '#48186a', '#472d7b', '#424086', '#3b528b', '#33638d', '#2c728e', '#26828e', '#21918c', '#1fa088', '#28ae80', '#3fbc73', '#5ec962', '#84d44b', '#addc30', '#d8e219', '#fde725'],
+  Cividis: ['#00204c', '#002a66', '#00346e', '#273f6c', '#3c4a6c', '#4c556b', '#5b5f6d', '#686a70', '#757575', '#838178', '#929c78', '#a19676', '#b0a572', '#c0af6d', '#d1ba65', '#e1c75c', '#f3db4f', '#ffe945'],
+  Accent: ['#7fc97f', '#beaed4', '#fdc086', '#ffff99', '#386cb0', '#f0027f', '#bf5b17', '#666666']
 };

package/dist/cjs/constants/constants.js

@@ -3,104 +3,107 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.VIOLIN_MODES = exports.VIOLINPLOT_SCALES = exports.VAR_SORT_ORDER = exports.VAR_SORT = exports.UNSELECTED_POLYGON_FILLCOLOR = exports.SELECTION_MODES = exports.SELECTED_POLYGON_FILLCOLOR = exports.PSEUDOSPATIAL_PLOT_TYPES = exports.PSEUDOSPATIAL_CATEGORICAL_MODES = exports.PLOT_TYPES = exports.PLOTLY_MODEBAR_BUTTONS = exports.OBS_TYPES = exports.MATRIXPLOT_SCALES = exports.LOCAL_STORAGE_KEY = exports.DOTPLOT_SCALES = exports.DEFAULT_OBS_GROUP = exports.COLOR_ENCODINGS = exports.BREAKPOINTS = void 0;
-const LOCAL_STORAGE_KEY = exports.LOCAL_STORAGE_KEY = "CHERITA";
+exports.VIOLIN_MODES = exports.VIOLINPLOT_SCALES = exports.VAR_SORT_ORDER = exports.VAR_SORT = exports.UNSELECTED_POLYGON_FILLCOLOR = exports.SELECTION_MODES = exports.SELECTED_POLYGON_FILLCOLOR = exports.PSEUDOSPATIAL_PLOT_TYPES = exports.PSEUDOSPATIAL_CATEGORICAL_MODES = exports.PLOT_TYPES = exports.PLOTLY_MODEBAR_BUTTONS = exports.OBS_TYPES = exports.MATRIXPLOT_SCALES = exports.LOCAL_STORAGE_KEY = exports.DOTPLOT_SCALES = exports.DEFAULT_OBS_GROUP = exports.DEFAULT_OBSM_KEYS = exports.COLOR_ENCODINGS = exports.BREAKPOINTS = void 0;
+const LOCAL_STORAGE_KEY = exports.LOCAL_STORAGE_KEY = 'CHERITA';
 const PLOT_TYPES = exports.PLOT_TYPES = {
-  SCATTERPLOT: "scatterplot",
-  DOTPLOT: "dotplot",
-  HEATMAP: "heatmap",
-  MATRIXPLOT: "matrixplot",
-  VIOLINPLOT: "violinplot"
+  SCATTERPLOT: 'scatterplot',
+  DOTPLOT: 'dotplot',
+  HEATMAP: 'heatmap',
+  MATRIXPLOT: 'matrixplot',
+  VIOLINPLOT: 'violinplot'
 };
 const COLOR_ENCODINGS = exports.COLOR_ENCODINGS = {
-  VAR: "var",
-  OBS: "obs"
+  VAR: 'var',
+  OBS: 'obs'
 };
 const OBS_TYPES = exports.OBS_TYPES = {
-  CATEGORICAL: "categorical",
-  DISCRETE: "discrete",
-  CONTINUOUS: "continuous",
-  BOOLEAN: "boolean"
+  CATEGORICAL: 'categorical',
+  DISCRETE: 'discrete',
+  CONTINUOUS: 'continuous',
+  BOOLEAN: 'boolean'
 };
 const VAR_SORT = exports.VAR_SORT = {
   NONE: null,
-  NAME: "name",
-  MATRIX: "matrix"
+  NAME: 'name',
+  MATRIX: 'matrix'
 };
 const VAR_SORT_ORDER = exports.VAR_SORT_ORDER = {
-  ASC: "asc",
-  DESC: "desc"
+  ASC: 'asc',
+  DESC: 'desc'
 };
 const SELECTED_POLYGON_FILLCOLOR = exports.SELECTED_POLYGON_FILLCOLOR = [107, 170, 209, 255 / 2];
 const UNSELECTED_POLYGON_FILLCOLOR = exports.UNSELECTED_POLYGON_FILLCOLOR = [167, 191, 211, 255 / 3];
 const SELECTION_MODES = exports.SELECTION_MODES = {
-  SINGLE: "single",
-  MULTIPLE: "multiple"
+  SINGLE: 'single',
+  MULTIPLE: 'multiple'
 };
 const VIOLIN_MODES = exports.VIOLIN_MODES = {
-  MULTIKEY: "multikey",
-  GROUPBY: "groupby"
+  MULTIKEY: 'multikey',
+  GROUPBY: 'groupby'
 };
 const MATRIXPLOT_SCALES = exports.MATRIXPLOT_SCALES = {
   NONE: {
     value: null,
-    name: "None"
+    name: 'None'
   },
   GROUP: {
-    value: "group",
-    name: "Group"
+    value: 'group',
+    name: 'Group'
   },
   VAR: {
-    value: "var",
-    name: "Var"
+    value: 'var',
+    name: 'Var'
   }
 };
 const DOTPLOT_SCALES = exports.DOTPLOT_SCALES = {
   NONE: {
     value: null,
-    name: "None"
+    name: 'None'
   },
   GROUP: {
-    value: "group",
-    name: "Group"
+    value: 'group',
+    name: 'Group'
   },
   VAR: {
-    value: "var",
-    name: "Var"
+    value: 'var',
+    name: 'Var'
   }
 };
 const VIOLINPLOT_SCALES = exports.VIOLINPLOT_SCALES = {
   WIDTH: {
-    value: "width",
-    name: "Width"
+    value: 'width',
+    name: 'Width'
   },
   COUNT: {
-    value: "count",
-    name: "Count"
+    value: 'count',
+    name: 'Count'
   }
 };
 const PSEUDOSPATIAL_PLOT_TYPES = exports.PSEUDOSPATIAL_PLOT_TYPES = {
-  GENE: "gene",
-  CATEGORICAL: "categorical",
-  CONTINUOUS: "continuous",
-  MASKS: "masks"
+  GENE: 'gene',
+  CATEGORICAL: 'categorical',
+  CONTINUOUS: 'continuous',
+  MASKS: 'masks'
 };
 const PSEUDOSPATIAL_CATEGORICAL_MODES = exports.PSEUDOSPATIAL_CATEGORICAL_MODES = {
   ACROSS: {
-    value: "across",
-    name: "% across sections"
+    value: 'across',
+    name: '% across sections'
   },
   WITHIN: {
-    value: "within",
-    name: "% within section"
+    value: 'within',
+    name: '% within section'
   }
 };
 
 // `default` cols to be shown out of accordion, at top of obslist
 // default values from cellxgene schema
-const DEFAULT_OBS_GROUP = exports.DEFAULT_OBS_GROUP = ["assay", "cell_type", "development_stage", "disease", "donor_id", "organism", "self_reported_ethnicity", "sex", "suspension_type", "tissue", "tissue_type"];
-const PLOTLY_MODEBAR_BUTTONS = exports.PLOTLY_MODEBAR_BUTTONS = ["toImage", "zoom2d", "pan2d", "zoomIn2d", "zoomOut2d", "autoScale2d", "resetScale2d"];
+const DEFAULT_OBS_GROUP = exports.DEFAULT_OBS_GROUP = ['assay', 'cell_type', 'development_stage', 'disease', 'donor_id', 'organism', 'self_reported_ethnicity', 'sex', 'suspension_type', 'tissue', 'tissue_type'];
+const PLOTLY_MODEBAR_BUTTONS = exports.PLOTLY_MODEBAR_BUTTONS = ['toImage', 'zoom2d', 'pan2d', 'zoomIn2d', 'zoomOut2d', 'autoScale2d', 'resetScale2d'];
 const BREAKPOINTS = exports.BREAKPOINTS = {
-  LG: "(max-width: 991.98px)",
-  XL: "(max-width: 1199.98px)"
-};
+  LG: '(max-width: 991.98px)',
+  XL: '(max-width: 1199.98px)'
+};
+
+// In order of priority
+const DEFAULT_OBSM_KEYS = exports.DEFAULT_OBSM_KEYS = ['x_umap', 'x_tsne', 'x_scvi', 'x_pca'];

package/dist/cjs/context/DatasetContext.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.DatasetContext = void 0;
 exports.DatasetProvider = DatasetProvider;
 exports.useDataset = useDataset;
-var _react = _interopRequireWildcard(require("react"));
+var _react = require("react");
 var _querySyncStoragePersister = require("@tanstack/query-sync-storage-persister");
 var _reactQuery = require("@tanstack/react-query");
 var _reactQueryPersistClient = require("@tanstack/react-query-persist-client");
@@ -14,9 +14,9 @@ var _lodash = _interopRequireDefault(require("lodash"));
 var _FilterContext = require("./FilterContext");
 var _SettingsContext = require("./SettingsContext");
 var _ZarrDataContext = require("./ZarrDataContext");
+var _jsxRuntime = require("react/jsx-runtime");
 const _excluded = ["dataset_url", "children"];
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
@@ -43,7 +43,7 @@ const queryClient = new _reactQuery.QueryClient({
   })
 });
 // Type of queries to store responses
-const persistKeys = ["obs/cols", "var/names", "obsm/keys", "obs/bins", "obs/distribution"];
+const persistKeys = ['obs/cols', 'var/names', 'obsm/keys', 'obs/bins', 'obs/distribution'];
 const persistOptions = {
   persister: (0, _querySyncStoragePersister.createSyncStoragePersister)({
     storage: window.localStorage
@@ -54,13 +54,14 @@ const persistOptions = {
         queryKey,
         state
       } = _ref;
-      if (state.status === "success") {
+      if (state.status === 'success') {
         return persistKeys.includes(queryKey === null || queryKey === void 0 ? void 0 : queryKey[0]);
       }
       return false;
     }
-  }
-  // @TODO: add maxAge and buster (app and api version numbers as busters)
+  },
+  buster: "1.3.1-dev.2025-10-29.6de4119f" || '0.0.0'
+  // @TODO: add maxAge and api version numbers as buster
 };
 const initialDataset = {
   url: null,
@@ -70,7 +71,8 @@ const initialDataset = {
   imageUrl: null,
   defaultSettings: {},
   canOverrideSettings: true,
-  useUnsColors: false
+  useUnsColors: false,
+  isPseudospatial: false
 };
 function DatasetProvider(_ref2) {
   let {
@@ -81,16 +83,23 @@ function DatasetProvider(_ref2) {
   const dataset = _lodash.default.assign(initialDataset, _objectSpread({
     url: dataset_url
   }, dataset_params));
-  return /*#__PURE__*/_react.default.createElement(DatasetContext.Provider, {
-    value: dataset
-  }, /*#__PURE__*/_react.default.createElement(_SettingsContext.SettingsProvider, {
-    dataset_url: dataset.url,
-    defaultSettings: dataset.defaultSettings,
-    canOverrideSettings: dataset.canOverrideSettings
-  }, /*#__PURE__*/_react.default.createElement(_reactQueryPersistClient.PersistQueryClientProvider, {
-    client: queryClient,
-    persistOptions: persistOptions
-  }, /*#__PURE__*/_react.default.createElement(_FilterContext.FilterProvider, null, /*#__PURE__*/_react.default.createElement(_ZarrDataContext.ZarrDataProvider, null, children)))));
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(DatasetContext.Provider, {
+    value: dataset,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactQueryPersistClient.PersistQueryClientProvider, {
+      client: queryClient,
+      persistOptions: persistOptions,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_SettingsContext.SettingsProvider, {
+        dataset_url: dataset.url,
+        defaultSettings: dataset.defaultSettings,
+        canOverrideSettings: dataset.canOverrideSettings,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_FilterContext.FilterProvider, {
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ZarrDataContext.ZarrDataProvider, {
+            children: children
+          })
+        })
+      })
+    })
+  });
 }
 function useDataset() {
   return (0, _react.useContext)(DatasetContext);