@haniffalab/cherita-react 1.4.1 → 1.4.2-dev.2025-10-29.81a6b906

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (138) hide show
  1. package/README.md +1 -1
  2. package/dist/cjs/components/controls/Controls.js +38 -30
  3. package/dist/cjs/components/dotplot/Dotplot.js +67 -69
  4. package/dist/cjs/components/dotplot/DotplotControls.js +103 -83
  5. package/dist/cjs/components/full-page/FullPage.js +100 -74
  6. package/dist/cjs/components/full-page/PlotAlert.js +45 -0
  7. package/dist/cjs/components/full-page/PlotTypeSelector.js +89 -44
  8. package/dist/cjs/components/heatmap/Heatmap.js +65 -65
  9. package/dist/cjs/components/heatmap/HeatmapControls.js +6 -3
  10. package/dist/cjs/components/icons/DotPlotIcon.js +64 -0
  11. package/dist/cjs/components/icons/HeatmapIcon.js +45 -0
  12. package/dist/cjs/components/icons/MatrixPlotIcon.1.js +57 -0
  13. package/dist/cjs/components/icons/MatrixPlotIcon.js +59 -0
  14. package/dist/cjs/components/icons/ScatterplotIcon.1.js +164 -0
  15. package/dist/cjs/components/icons/ScatterplotIcon.js +144 -0
  16. package/dist/cjs/components/icons/ViolinPlotIcon.js +42 -0
  17. package/dist/cjs/components/matrixplot/Matrixplot.js +65 -66
  18. package/dist/cjs/components/matrixplot/MatrixplotControls.js +8 -5
  19. package/dist/cjs/components/obs-list/ObsItem.js +258 -210
  20. package/dist/cjs/components/obs-list/ObsList.js +161 -133
  21. package/dist/cjs/components/obs-list/ObsToolbar.js +2 -3
  22. package/dist/cjs/components/obsm-list/ObsmList.js +53 -38
  23. package/dist/cjs/components/offcanvas/index.js +61 -31
  24. package/dist/cjs/components/pseudospatial/Pseudospatial.js +132 -76
  25. package/dist/cjs/components/pseudospatial/PseudospatialToolbar.js +122 -74
  26. package/dist/cjs/components/scatterplot/Scatterplot.js +127 -99
  27. package/dist/cjs/components/scatterplot/ScatterplotControls.js +45 -31
  28. package/dist/cjs/components/scatterplot/SpatialControls.js +140 -113
  29. package/dist/cjs/components/scatterplot/Toolbox.js +41 -30
  30. package/dist/cjs/components/search-bar/SearchBar.js +168 -121
  31. package/dist/cjs/components/search-bar/SearchInfo.js +76 -50
  32. package/dist/cjs/components/search-bar/SearchResults.js +93 -71
  33. package/dist/cjs/components/toolbar/Toolbar.js +46 -37
  34. package/dist/cjs/components/var-list/VarItem.js +115 -88
  35. package/dist/cjs/components/var-list/VarList.js +85 -69
  36. package/dist/cjs/components/var-list/VarListToolbar.js +59 -54
  37. package/dist/cjs/components/var-list/VarSet.js +126 -108
  38. package/dist/cjs/components/violin/Violin.js +109 -107
  39. package/dist/cjs/components/violin/ViolinControls.js +8 -5
  40. package/dist/cjs/constants/colorscales.js +19 -19
  41. package/dist/cjs/constants/constants.js +47 -47
  42. package/dist/cjs/context/DatasetContext.js +24 -16
  43. package/dist/cjs/context/FilterContext.js +11 -9
  44. package/dist/cjs/context/SettingsContext.js +255 -89
  45. package/dist/cjs/context/ZarrDataContext.js +6 -5
  46. package/dist/cjs/helpers/color-helper.js +2 -2
  47. package/dist/cjs/helpers/zarr-helper.js +3 -3
  48. package/dist/cjs/utils/Filter.js +16 -11
  49. package/dist/cjs/utils/Histogram.js +35 -33
  50. package/dist/cjs/utils/ImageViewer.js +11 -8
  51. package/dist/cjs/utils/Legend.js +37 -30
  52. package/dist/cjs/utils/LoadingIndicators.js +15 -13
  53. package/dist/cjs/utils/Resolver.js +213 -0
  54. package/dist/cjs/utils/Skeleton.js +10 -10
  55. package/dist/cjs/utils/StyledTooltip.js +44 -0
  56. package/dist/cjs/utils/VirtualizedList.js +34 -27
  57. package/dist/cjs/utils/errors.js +15 -15
  58. package/dist/cjs/utils/requests.js +21 -9
  59. package/dist/cjs/utils/search.js +4 -4
  60. package/dist/cjs/utils/string.js +6 -6
  61. package/dist/cjs/utils/zarrData.js +20 -21
  62. package/dist/css/cherita.css +64 -42
  63. package/dist/css/cherita.css.map +1 -1
  64. package/dist/esm/components/controls/Controls.js +43 -35
  65. package/dist/esm/components/dotplot/Dotplot.js +77 -78
  66. package/dist/esm/components/dotplot/DotplotControls.js +106 -85
  67. package/dist/esm/components/full-page/FullPage.js +120 -93
  68. package/dist/esm/components/full-page/PlotAlert.js +39 -0
  69. package/dist/esm/components/full-page/PlotTypeSelector.js +90 -45
  70. package/dist/esm/components/heatmap/Heatmap.js +75 -74
  71. package/dist/esm/components/heatmap/HeatmapControls.js +8 -4
  72. package/dist/esm/components/icons/DotPlotIcon.js +58 -0
  73. package/dist/esm/components/icons/HeatmapIcon.js +39 -0
  74. package/dist/esm/components/icons/MatrixPlotIcon.1.js +51 -0
  75. package/dist/esm/components/icons/MatrixPlotIcon.js +53 -0
  76. package/dist/esm/components/icons/ScatterplotIcon.1.js +158 -0
  77. package/dist/esm/components/icons/ScatterplotIcon.js +138 -0
  78. package/dist/esm/components/icons/ViolinPlotIcon.js +36 -0
  79. package/dist/esm/components/matrixplot/Matrixplot.js +75 -75
  80. package/dist/esm/components/matrixplot/MatrixplotControls.js +10 -6
  81. package/dist/esm/components/obs-list/ObsItem.js +273 -222
  82. package/dist/esm/components/obs-list/ObsList.js +176 -147
  83. package/dist/esm/components/obs-list/ObsToolbar.js +3 -3
  84. package/dist/esm/components/obsm-list/ObsmList.js +60 -44
  85. package/dist/esm/components/offcanvas/index.js +67 -37
  86. package/dist/esm/components/pseudospatial/Pseudospatial.js +145 -88
  87. package/dist/esm/components/pseudospatial/PseudospatialToolbar.js +127 -78
  88. package/dist/esm/components/scatterplot/Scatterplot.js +148 -119
  89. package/dist/esm/components/scatterplot/ScatterplotControls.js +50 -35
  90. package/dist/esm/components/scatterplot/SpatialControls.js +153 -125
  91. package/dist/esm/components/scatterplot/Toolbox.js +44 -32
  92. package/dist/esm/components/search-bar/SearchBar.js +180 -132
  93. package/dist/esm/components/search-bar/SearchInfo.js +86 -59
  94. package/dist/esm/components/search-bar/SearchResults.js +100 -77
  95. package/dist/esm/components/toolbar/Toolbar.js +49 -39
  96. package/dist/esm/components/var-list/VarItem.js +126 -98
  97. package/dist/esm/components/var-list/VarList.js +99 -82
  98. package/dist/esm/components/var-list/VarListToolbar.js +64 -58
  99. package/dist/esm/components/var-list/VarSet.js +134 -115
  100. package/dist/esm/components/violin/Violin.js +121 -118
  101. package/dist/esm/components/violin/ViolinControls.js +10 -6
  102. package/dist/esm/constants/colorscales.js +19 -19
  103. package/dist/esm/constants/constants.js +47 -47
  104. package/dist/esm/context/DatasetContext.js +31 -22
  105. package/dist/esm/context/FilterContext.js +11 -8
  106. package/dist/esm/context/SettingsContext.js +257 -90
  107. package/dist/esm/context/ZarrDataContext.js +8 -6
  108. package/dist/esm/helpers/color-helper.js +5 -5
  109. package/dist/esm/helpers/map-helper.js +2 -2
  110. package/dist/esm/helpers/zarr-helper.js +6 -6
  111. package/dist/esm/index.js +22 -22
  112. package/dist/esm/utils/Filter.js +22 -17
  113. package/dist/esm/utils/Histogram.js +39 -37
  114. package/dist/esm/utils/ImageViewer.js +12 -8
  115. package/dist/esm/utils/Legend.js +44 -36
  116. package/dist/esm/utils/LoadingIndicators.js +16 -13
  117. package/dist/esm/utils/Resolver.js +201 -0
  118. package/dist/esm/utils/Skeleton.js +11 -10
  119. package/dist/esm/utils/StyledTooltip.js +38 -0
  120. package/dist/esm/utils/VirtualizedList.js +35 -27
  121. package/dist/esm/utils/errors.js +15 -15
  122. package/dist/esm/utils/requests.js +24 -12
  123. package/dist/esm/utils/search.js +7 -7
  124. package/dist/esm/utils/string.js +7 -7
  125. package/dist/esm/utils/zarrData.js +27 -28
  126. package/package.json +21 -9
  127. package/scss/cherita-bootstrap.scss +2 -2
  128. package/scss/cherita.scss +43 -17
  129. package/scss/components/accordions.scss +4 -1
  130. package/scss/components/layouts.scss +15 -33
  131. package/scss/components/lists.scss +8 -4
  132. package/scss/components/plotly.scss +38 -26
  133. package/scss/components/plots.scss +14 -1
  134. package/dist/assets/images/plots/dotplot.svg +0 -152
  135. package/dist/assets/images/plots/heatmap.svg +0 -193
  136. package/dist/assets/images/plots/matrixplot.svg +0 -275
  137. package/dist/assets/images/plots/scatterplot.svg +0 -198
  138. package/dist/assets/images/plots/violin.svg +0 -50
@@ -3,28 +3,32 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
3
3
  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; }
4
4
  function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
5
5
  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); }
6
- import React, { useCallback, useEffect, useRef, useState } from "react";
7
- import _ from "lodash";
8
- import { Alert, Button } from "react-bootstrap";
9
- import Plot from "react-plotly.js";
10
- import { PLOTLY_MODEBAR_BUTTONS } from "../../constants/constants";
11
- import { useDataset } from "../../context/DatasetContext";
12
- import { useFilteredData } from "../../context/FilterContext";
13
- import { useSettings } from "../../context/SettingsContext";
14
- import { LoadingSpinner } from "../../utils/LoadingIndicators";
15
- import { useDebouncedFetch } from "../../utils/requests";
16
- import { ControlsPlotlyToolbar, ObsPlotlyToolbar, VarPlotlyToolbar } from "../toolbar/Toolbar";
6
+ import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
7
+ import _ from 'lodash';
8
+ import { Button } from 'react-bootstrap';
9
+ import Plot from 'react-plotly.js';
10
+ import { PLOTLY_MODEBAR_BUTTONS } from '../../constants/constants';
11
+ import { useDataset } from '../../context/DatasetContext';
12
+ import { useFilteredData } from '../../context/FilterContext';
13
+ import { useSettings } from '../../context/SettingsContext';
14
+ import { LoadingSpinner } from '../../utils/LoadingIndicators';
15
+ import { useDebouncedFetch } from '../../utils/requests';
16
+ import { useSelectedMultiVar, useSelectedObs } from '../../utils/Resolver';
17
+ import { PlotAlert } from '../full-page/PlotAlert';
18
+ import { ControlsPlotlyToolbar, ObsPlotlyToolbar, VarPlotlyToolbar } from '../toolbar/Toolbar';
19
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
17
20
  export function Matrixplot(_ref) {
18
- var _settings$selectedObs, _settings$selectedObs2, _settings$selectedObs3;
19
21
  let {
20
22
  showObsBtn = false,
21
23
  showVarsBtn = false,
22
24
  showCtrlsBtn = false,
23
25
  setShowObs,
24
26
  setShowVars,
25
- setShowControls
27
+ setShowControls,
28
+ plotType,
29
+ setPlotType
26
30
  } = _ref;
27
- const ENDPOINT = "matrixplot";
31
+ const ENDPOINT = 'matrixplot';
28
32
  const dataset = useDataset();
29
33
  const settings = useSettings();
30
34
  const {
@@ -35,46 +39,27 @@ export function Matrixplot(_ref) {
35
39
  const [data, setData] = useState([]);
36
40
  const [layout, setLayout] = useState({});
37
41
  const [hasSelections, setHasSelections] = useState(false);
38
- const [params, setParams] = useState({
42
+ const selectedObs = useSelectedObs();
43
+ const selectedMultiVar = useSelectedMultiVar();
44
+ const params = useMemo(() => ({
39
45
  url: dataset.url,
40
- obsCol: settings.selectedObs,
41
- obsValues: !((_settings$selectedObs = settings.selectedObs) !== null && _settings$selectedObs !== void 0 && _settings$selectedObs.omit.length) ? null : _.difference(_.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 => {
42
- var _settings$selectedObs4;
43
- return (_settings$selectedObs4 = settings.selectedObs) === null || _settings$selectedObs4 === void 0 ? void 0 : _settings$selectedObs4.codesMap[c];
44
- }),
45
- varKeys: settings.selectedMultiVar.map(i => i.isSet ? {
46
+ obsCol: selectedObs,
47
+ obsValues: !(selectedObs !== null && selectedObs !== void 0 && selectedObs.omit.length) ? null : _.difference(selectedObs === null || selectedObs === void 0 ? void 0 : selectedObs.values, selectedObs === null || selectedObs === void 0 ? void 0 : selectedObs.omit),
48
+ varKeys: selectedMultiVar.map(i => i.isSet ? {
46
49
  name: i.name,
47
50
  indices: i.vars.map(v => v.index)
48
51
  } : i.index),
49
52
  obsIndices: isSliced ? [...(obsIndices || [])] : null,
50
53
  standardScale: settings.controls.scale.matrixplot,
51
54
  varNamesCol: dataset.varNamesCol
52
- });
55
+ }), [dataset.url, dataset.varNamesCol, isSliced, obsIndices, selectedMultiVar, selectedObs, settings.controls.scale.matrixplot]);
53
56
  useEffect(() => {
54
- if (settings.selectedObs && settings.selectedMultiVar.length) {
57
+ if (selectedObs && selectedMultiVar.length) {
55
58
  setHasSelections(true);
56
59
  } else {
57
60
  setHasSelections(false);
58
61
  }
59
- setParams(p => {
60
- var _settings$selectedObs5, _settings$selectedObs6, _settings$selectedObs7;
61
- return _objectSpread(_objectSpread({}, p), {}, {
62
- url: dataset.url,
63
- obsCol: settings.selectedObs,
64
- obsValues: !((_settings$selectedObs5 = settings.selectedObs) !== null && _settings$selectedObs5 !== void 0 && _settings$selectedObs5.omit.length) ? null : _.difference(_.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 => {
65
- var _settings$selectedObs8;
66
- return (_settings$selectedObs8 = settings.selectedObs) === null || _settings$selectedObs8 === void 0 ? void 0 : _settings$selectedObs8.codesMap[c];
67
- }),
68
- varKeys: settings.selectedMultiVar.map(i => i.isSet ? {
69
- name: i.name,
70
- indices: i.vars.map(v => v.index)
71
- } : i.index),
72
- obsIndices: isSliced ? [...(obsIndices || [])] : null,
73
- standardScale: settings.controls.scale.matrixplot,
74
- varNamesCol: dataset.varNamesCol
75
- });
76
- });
77
- }, [settings.controls.scale.matrixplot, settings.selectedMultiVar, settings.selectedObs, dataset.url, dataset.varNamesCol, obsIndices, isSliced]);
62
+ }, [selectedMultiVar.length, selectedObs]);
78
63
  const updateColorscale = useCallback(colorscale => {
79
64
  setLayout(l => {
80
65
  return _objectSpread(_objectSpread({}, l), {}, {
@@ -89,13 +74,16 @@ export function Matrixplot(_ref) {
89
74
  isPending,
90
75
  serverError
91
76
  } = useDebouncedFetch(ENDPOINT, params, 500, {
92
- enabled: !!params.obsCol && !!params.varKeys.length
77
+ isEnabled: params => !!params.obsCol && !!params.varKeys.length
93
78
  });
94
79
  useEffect(() => {
95
- if (hasSelections && !isPending && !serverError) {
80
+ if (hasSelections && !!fetchedData && !isPending && !serverError) {
96
81
  setData(fetchedData.data);
97
82
  setLayout(fetchedData.layout);
98
83
  updateColorscale(colorscale.current);
84
+ } else {
85
+ setData([]);
86
+ setLayout({});
99
87
  }
100
88
  }, [fetchedData, hasSelections, isPending, serverError, updateColorscale]);
101
89
  useEffect(() => {
@@ -112,38 +100,50 @@ export function Matrixplot(_ref) {
112
100
  const modeBarButtons = customModeBarButtons.length ? [customModeBarButtons, PLOTLY_MODEBAR_BUTTONS] : [PLOTLY_MODEBAR_BUTTONS];
113
101
  if (!serverError) {
114
102
  if (hasSelections) {
115
- return /*#__PURE__*/React.createElement("div", {
116
- className: "cherita-plot cherita-matrixplot position-relative"
117
- }, isPending && /*#__PURE__*/React.createElement(LoadingSpinner, null), /*#__PURE__*/React.createElement(Plot, {
118
- data: data,
119
- layout: layout,
120
- useResizeHandler: true,
121
- style: {
122
- width: "100%",
123
- height: "100%"
124
- },
125
- config: {
126
- displaylogo: false,
127
- modeBarButtons: modeBarButtons
128
- }
129
- }));
103
+ return /*#__PURE__*/_jsxs("div", {
104
+ className: "cherita-plot cherita-matrixplot position-relative",
105
+ children: [isPending && /*#__PURE__*/_jsx(LoadingSpinner, {}), /*#__PURE__*/_jsx(Plot, {
106
+ data: data,
107
+ layout: layout,
108
+ useResizeHandler: true,
109
+ style: {
110
+ width: '100%',
111
+ height: '100%'
112
+ },
113
+ config: {
114
+ displaylogo: false,
115
+ modeBarButtons: modeBarButtons
116
+ }
117
+ })]
118
+ });
130
119
  }
131
- return /*#__PURE__*/React.createElement("div", {
132
- className: "cherita-matrixplot"
133
- }, /*#__PURE__*/React.createElement(Alert, {
134
- variant: "light"
135
- }, "Select", " ", showVarsBtn ? /*#__PURE__*/React.createElement(Button, {
136
- variant: "link",
137
- className: "border-0 p-0 align-baseline",
138
- onClick: setShowVars
139
- }, "features") : "features", " ", "and a", " ", showObsBtn ? /*#__PURE__*/React.createElement(Button, {
140
- variant: "link",
141
- className: "border-0 p-0 align-baseline",
142
- onClick: setShowObs
143
- }, "category") : "category"));
120
+ return /*#__PURE__*/_jsx(PlotAlert, {
121
+ variant: "info",
122
+ heading: "Set up your matrix plot",
123
+ plotType: plotType,
124
+ setPlotType: setPlotType,
125
+ children: /*#__PURE__*/_jsxs("p", {
126
+ className: "p-0 m-0",
127
+ children: ["Select a", ' ', showObsBtn ? /*#__PURE__*/_jsx(Button, {
128
+ variant: "link",
129
+ className: "border-0 p-0 align-baseline",
130
+ onClick: setShowObs,
131
+ children: "category"
132
+ }) : 'category', ' ', "to group observations, then choose one or more", ' ', showVarsBtn ? /*#__PURE__*/_jsx(Button, {
133
+ variant: "link",
134
+ className: "border-0 p-0 align-baseline",
135
+ onClick: setShowVars,
136
+ children: "features"
137
+ }) : 'features', ' ', "to display the matrix plot."]
138
+ })
139
+ });
144
140
  } else {
145
- return /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement(Alert, {
146
- variant: "danger"
147
- }, serverError.message));
141
+ return /*#__PURE__*/_jsx(PlotAlert, {
142
+ variant: "danger",
143
+ heading: "Error displaying the matrix plot",
144
+ plotType: plotType,
145
+ setPlotType: setPlotType,
146
+ children: serverError.message || 'An unexpected error occurred while generating the plot.'
147
+ });
148
148
  }
149
149
  }
@@ -1,8 +1,12 @@
1
- import React from "react";
2
- import { Form } from "react-bootstrap";
3
- import { ColorscaleSelect, ScaleSelect } from "../controls/Controls";
1
+ import { Form } from 'react-bootstrap';
2
+ import { ColorscaleSelect, ScaleSelect } from '../controls/Controls';
3
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
4
4
  export function MatrixplotControls() {
5
- return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Form, null, /*#__PURE__*/React.createElement(ColorscaleSelect, null), /*#__PURE__*/React.createElement(ScaleSelect, {
6
- plot: "matrixplot"
7
- })));
5
+ return /*#__PURE__*/_jsx(_Fragment, {
6
+ children: /*#__PURE__*/_jsxs(Form, {
7
+ children: [/*#__PURE__*/_jsx(ColorscaleSelect, {}), /*#__PURE__*/_jsx(ScaleSelect, {
8
+ plot: "matrixplot"
9
+ })]
10
+ })
11
+ });
8
12
  }