@vitessce/scatterplot-gating 3.4.10 → 3.4.12

package/dist/{deflate-c70054b2.js → deflate-acef7820.js}

@@ -1,5 +1,5 @@
 import { i as inflate_1 } from "./pako.esm-68f84e2a.js";
-import { B as BaseDecoder } from "./index-d8a3c555.js";
+import { B as BaseDecoder } from "./index-c5949f9a.js";
 import "react";
 import "@vitessce/vit-s";
 import "react-dom";

package/dist/{index-d8a3c555.js → index-c5949f9a.js}

@@ -11162,6 +11162,7 @@ const CoordinationType$1 = {
   FEATURE_TYPE: "featureType",
   FEATURE_VALUE_TYPE: "featureValueType",
   OBS_LABELS_TYPE: "obsLabelsType",
+  FEATURE_LABELS_TYPE: "featureLabelsType",
   // Other types
   EMBEDDING_TYPE: "embeddingType",
   EMBEDDING_ZOOM: "embeddingZoom",
@@ -11276,6 +11277,23 @@ const CoordinationType$1 = {
   CONTOUR_COLOR_ENCODING: "contourColorEncoding",
   CONTOUR_COLOR: "contourColor"
 };
+const ViewHelpMapping = {
+  SCATTERPLOT: "The scatterplot displays two-dimensional (pre-computed) dimensionality reduction results (such as from t-SNE or UMAP). Each point on the scatterplot represents an observation (e.g., cell).",
+  HEATMAP: "The heatmap displays an observation-by-feature (e.g., cell-by-gene) matrix, typically with transformed (e.g., normalized or standardized) values.",
+  SPATIAL: "The spatial view displays (potentially layered) spatially-resolved data including RGB or multiplexed images, segmentations of observations (bitmask- or polygon-based), and/or points (e.g., representing FISH transcripts).",
+  DESCRIPTION: "The description view displays additional information about a dataset. When images are included in a dataset, the description view also includes image metadata (if contained in the image files).",
+  STATUS: "The status view displays debugging messages, including app-wide error messages when datasets fail to load or when schemas fail to validate. Details about the entity under the mouse cursor (cell, gene, and/or molecule) are displayed during hover interactions.",
+  LAYER_CONTROLLER: "The spatial layer controller provides an interface for manipulating the visualization layers displayed in the spatial view.",
+  GENOMIC_PROFILES: "The genomic profiles view displays genome browser tracks (using the genomic-profiles data type) containing bar plots, where the genome is along the x-axis and the value at each genome position is encoded with a bar along the y-axis.",
+  GATING: "The gating scatterplot displays expression data for two genes (along the X and Y axes). Users can select two genes, and the scatterplot is dynamically generated using observation-by-feature matrix data. Gating can then be performed by using the lasso or box select tools.",
+  FEATURE_LIST: "The feature list controller displays an interactive list of features (e.g., genes).",
+  OBS_SETS: "The observation sets controller displays an interactive list of (potentially hierarchical) observation sets (e.g., cell clusters or cell type annotations).",
+  OBS_SET_SIZES: "The observation set sizes view displays a bar plot with the currently-selected observation sets (e.g., cell types) on the x-axis and bars representing their size (e.g., number of cells) on the y-axis.",
+  OBS_SET_FEATURE_VALUE_DISTRIBUTION: "The observation set feature value distribution view displays a violin plot with values (e.g., expression values) per set (e.g., cell type) for the selected feature (e.g., gene).",
+  FEATURE_VALUE_HISTOGRAM: "The feature value histogram displays the distribution of values (e.g., expression) for the selected feature (e.g., gene).",
+  DOT_PLOT: "The dot plot displays summary information about expression of the selected features (e.g., genes) for each selected observation set (e.g., cell type).",
+  FEATURE_BAR_PLOT: "The feature bar plot displays one bar per observation (e.g., cell) along the x-axis, where the value of a selected feature (e.g., gene) is encoded along the y-axis."
+};
 const COMPONENT_COORDINATION_TYPES = {
   [ViewType$1.SCATTERPLOT]: [
     CoordinationType$1.DATASET,
@@ -11954,7 +11972,7 @@ const annDataObsSetsArr = z.array(z.object({
   ]),
   scorePath: z.string().optional().describe("The location in the AnnData store for the set confidence scores, like 'obs/celltype_prediction_score.'")
 }));
-const annDataObsSets = z.object({
+z.object({
   obsSets: annDataObsSetsArr
 });
 const annDataObsFeatureColumnsArr = z.array(z.object({
@@ -12016,7 +12034,7 @@ const obsFeatureMatrixSpatialdataSchema = annDataObsFeatureMatrix.extend({
 const obsSetsSpatialdataSchema = z.object({
   region: z.string().describe("The name of a region to use to filter instances (i.e., rows) in the table").optional(),
   tablePath: z.string().optional().describe("The path to a table which contains the index for the set values."),
-  obsSets: annDataObsSets
+  obsSets: annDataObsSetsArr
 });
 z.object({
   targetX: z.number(),
@@ -123793,16 +123811,16 @@ function addDecoder(cases, importFn) {
   }
   cases.forEach((c2) => registry$1.set(c2, importFn));
 }
-addDecoder([void 0, 1], () => import("./raw-be8b369a.js").then((m2) => m2.default));
-addDecoder(5, () => import("./lzw-80267e13.js").then((m2) => m2.default));
+addDecoder([void 0, 1], () => import("./raw-61e39bd3.js").then((m2) => m2.default));
+addDecoder(5, () => import("./lzw-857aa477.js").then((m2) => m2.default));
 addDecoder(6, () => {
   throw new Error("old style JPEG compression is not supported.");
 });
-addDecoder(7, () => import("./jpeg-1af419b8.js").then((m2) => m2.default));
-addDecoder([8, 32946], () => import("./deflate-c70054b2.js").then((m2) => m2.default));
-addDecoder(32773, () => import("./packbits-a7eab764.js").then((m2) => m2.default));
-addDecoder(34887, () => import("./lerc-408b2bde.js").then((m2) => m2.default));
-addDecoder(50001, () => import("./webimage-61be8bd4.js").then((m2) => m2.default));
+addDecoder(7, () => import("./jpeg-7e5e6ad5.js").then((m2) => m2.default));
+addDecoder([8, 32946], () => import("./deflate-acef7820.js").then((m2) => m2.default));
+addDecoder(32773, () => import("./packbits-f7f733c7.js").then((m2) => m2.default));
+addDecoder(34887, () => import("./lerc-94ffa556.js").then((m2) => m2.default));
+addDecoder(50001, () => import("./webimage-a60dfc27.js").then((m2) => m2.default));
 function decodeRowAcc(row, stride) {
   let length2 = row.length - stride;
   let offset5 = 0;
@@ -151054,7 +151072,8 @@ function GatingSubscriber(props) {
     disableTooltip = false,
     title: titleOverride,
     // Average fill density for dynamic opacity calculation.
-    averageFillDensity
+    averageFillDensity,
+    helpText = ViewHelpMapping.GATING
   } = props;
   const loaders = useLoaders();
   const setComponentHover = useSetComponentHover();
@@ -151375,6 +151394,7 @@ function GatingSubscriber(props) {
       urls,
       theme,
       isReady,
+      helpText,
       options: /* @__PURE__ */ jsxRuntimeExports.jsx(
         ScatterplotOptions,
         {

package/dist/index.js

@@ -1,4 +1,4 @@
-import { G } from "./index-d8a3c555.js";
+import { G } from "./index-c5949f9a.js";
 import "react";
 import "@vitessce/vit-s";
 import "react-dom";

package/dist/{jpeg-1af419b8.js → jpeg-7e5e6ad5.js}

@@ -1,4 +1,4 @@
-import { B as BaseDecoder } from "./index-d8a3c555.js";
+import { B as BaseDecoder } from "./index-c5949f9a.js";
 import "react";
 import "@vitessce/vit-s";
 import "react-dom";

package/dist/{lerc-408b2bde.js → lerc-94ffa556.js}

@@ -1,5 +1,5 @@
 import { i as inflate_1 } from "./pako.esm-68f84e2a.js";
-import { g as getDefaultExportFromCjs, B as BaseDecoder } from "./index-d8a3c555.js";
+import { g as getDefaultExportFromCjs, B as BaseDecoder } from "./index-c5949f9a.js";
 import "react";
 import "@vitessce/vit-s";
 import "react-dom";

package/dist/{lzw-80267e13.js → lzw-857aa477.js}

@@ -1,4 +1,4 @@
-import { B as BaseDecoder } from "./index-d8a3c555.js";
+import { B as BaseDecoder } from "./index-c5949f9a.js";
 import "react";
 import "@vitessce/vit-s";
 import "react-dom";

package/dist/{packbits-a7eab764.js → packbits-f7f733c7.js}

@@ -1,4 +1,4 @@
-import { B as BaseDecoder } from "./index-d8a3c555.js";
+import { B as BaseDecoder } from "./index-c5949f9a.js";
 import "react";
 import "@vitessce/vit-s";
 import "react-dom";

package/dist/{raw-be8b369a.js → raw-61e39bd3.js}

@@ -1,4 +1,4 @@
-import { B as BaseDecoder } from "./index-d8a3c555.js";
+import { B as BaseDecoder } from "./index-c5949f9a.js";
 import "react";
 import "@vitessce/vit-s";
 import "react-dom";

package/dist/{webimage-61be8bd4.js → webimage-a60dfc27.js}

@@ -1,4 +1,4 @@
-import { B as BaseDecoder } from "./index-d8a3c555.js";
+import { B as BaseDecoder } from "./index-c5949f9a.js";
 import "react";
 import "@vitessce/vit-s";
 import "react-dom";

package/dist-tsc/GatingSubscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GatingSubscriber.d.ts","sourceRoot":"","sources":["../src/GatingSubscriber.js"],"names":[],"mappings":"AAmCA;;;;;;;;;;;;KAYK;AACL,wCAVK;IAAsB,IAAI,EAAlB,MAAM;IACQ,KAAK,EAAnB,MAAM;IACQ,kBAAkB,EAAhC,MAAM;IAES,cAAc,EAA7B,OAAO;IACS,mBAAmB;IAErB,kBAAkB,EAAhC,MAAM;CAEhB,eA8ZF"}
+{"version":3,"file":"GatingSubscriber.d.ts","sourceRoot":"","sources":["../src/GatingSubscriber.js"],"names":[],"mappings":"AAmCA;;;;;;;;;;;;KAYK;AACL,wCAVK;IAAsB,IAAI,EAAlB,MAAM;IACQ,KAAK,EAAnB,MAAM;IACQ,kBAAkB,EAAhC,MAAM;IAES,cAAc,EAA7B,OAAO;IACS,mBAAmB;IAErB,kBAAkB,EAAhC,MAAM;CAEhB,eAgaF"}

package/dist-tsc/GatingSubscriber.js

@@ -6,7 +6,7 @@ import { pluralize as plur, capitalize, commaNumber, getValueTransformFunction,
 import { TitleInfo, useDeckCanvasSize, useReady, useUrls, useUint8FeatureSelection, useExpressionValueGetter, useObsSetsData, useFeatureSelection, useObsFeatureMatrixIndices, useCoordination, useLoaders, useSetComponentHover, useSetComponentViewInfo, } from '@vitessce/vit-s';
 import { getCellSetPolygons, mergeObsSets, setObsSelection, getCellColors, } from '@vitessce/sets-utils';
 import { Scatterplot, ScatterplotTooltipSubscriber, ScatterplotOptions, getPointSizeDevicePixels, getPointOpacity, EmptyMessage, } from '@vitessce/scatterplot';
-import { ViewType, COMPONENT_COORDINATION_TYPES } from '@vitessce/constants-internal';
+import { ViewType, COMPONENT_COORDINATION_TYPES, ViewHelpMapping } from '@vitessce/constants-internal';
 import GatingScatterplotOptions from './GatingScatterplotOptions.js';
 /**
    * A subscriber component for the gating scatterplot.
@@ -24,7 +24,7 @@ import GatingScatterplotOptions from './GatingScatterplotOptions.js';
 export function GatingSubscriber(props) {
     const { uuid, coordinationScopes, closeButtonVisible, downloadButtonVisible, removeGridComponent, theme, disableTooltip = false, title: titleOverride, 
     // Average fill density for dynamic opacity calculation.
-    averageFillDensity, } = props;
+    averageFillDensity, helpText = ViewHelpMapping.GATING, } = props;
     const loaders = useLoaders();
     const setComponentHover = useSetComponentHover();
     const setComponentViewInfo = useSetComponentViewInfo(uuid);
@@ -192,7 +192,7 @@ export function GatingSubscriber(props) {
     }, [obsXY, obsIndex, featureValueTransform,
         gatingFeatureSelectionX, gatingFeatureSelectionY, obsType,
     ]);
-    return (_jsxs(TitleInfo, { title: title, info: `${commaNumber(cellsCount)} ${plur(obsType, cellsCount)}`, closeButtonVisible: closeButtonVisible, downloadButtonVisible: downloadButtonVisible, removeGridComponent: removeGridComponent, urls: urls, theme: theme, isReady: isReady, options: (_jsx(ScatterplotOptions, { observationsLabel: obsType, cellRadius: cellRadiusFixed, setCellRadius: setCellRadiusFixed, cellRadiusMode: cellRadiusMode, setCellRadiusMode: setCellRadiusMode, cellOpacity: cellOpacityFixed, setCellOpacity: setCellOpacityFixed, cellOpacityMode: cellOpacityMode, setCellOpacityMode: setCellOpacityMode, cellSetLabelsVisible: cellSetLabelsVisible, setCellSetLabelsVisible: setCellSetLabelsVisible, cellSetLabelSize: cellSetLabelSize, setCellSetLabelSize: setCellSetLabelSize, cellSetPolygonsVisible: cellSetPolygonsVisible, setCellSetPolygonsVisible: setCellSetPolygonsVisible, cellColorEncoding: cellColorEncoding, setCellColorEncoding: setCellColorEncoding, geneExpressionColormap: geneExpressionColormap, setGeneExpressionColormap: setGeneExpressionColormap, geneExpressionColormapRange: geneExpressionColormapRange, setGeneExpressionColormapRange: setGeneExpressionColormapRange, children: _jsx(GatingScatterplotOptions, { featureType: featureType, gatingFeatureSelectionX: gatingFeatureSelectionX, setGatingFeatureSelectionX: setGatingFeatureSelectionX, gatingFeatureSelectionY: gatingFeatureSelectionY, setGatingFeatureSelectionY: setGatingFeatureSelectionY, gatingFeatureValueTransform: featureValueTransform, setGatingFeatureValueTransform: (newValue) => {
+    return (_jsxs(TitleInfo, { title: title, info: `${commaNumber(cellsCount)} ${plur(obsType, cellsCount)}`, closeButtonVisible: closeButtonVisible, downloadButtonVisible: downloadButtonVisible, removeGridComponent: removeGridComponent, urls: urls, theme: theme, isReady: isReady, helpText: helpText, options: (_jsx(ScatterplotOptions, { observationsLabel: obsType, cellRadius: cellRadiusFixed, setCellRadius: setCellRadiusFixed, cellRadiusMode: cellRadiusMode, setCellRadiusMode: setCellRadiusMode, cellOpacity: cellOpacityFixed, setCellOpacity: setCellOpacityFixed, cellOpacityMode: cellOpacityMode, setCellOpacityMode: setCellOpacityMode, cellSetLabelsVisible: cellSetLabelsVisible, setCellSetLabelsVisible: setCellSetLabelsVisible, cellSetLabelSize: cellSetLabelSize, setCellSetLabelSize: setCellSetLabelSize, cellSetPolygonsVisible: cellSetPolygonsVisible, setCellSetPolygonsVisible: setCellSetPolygonsVisible, cellColorEncoding: cellColorEncoding, setCellColorEncoding: setCellColorEncoding, geneExpressionColormap: geneExpressionColormap, setGeneExpressionColormap: setGeneExpressionColormap, geneExpressionColormapRange: geneExpressionColormapRange, setGeneExpressionColormapRange: setGeneExpressionColormapRange, children: _jsx(GatingScatterplotOptions, { featureType: featureType, gatingFeatureSelectionX: gatingFeatureSelectionX, setGatingFeatureSelectionX: setGatingFeatureSelectionX, gatingFeatureSelectionY: gatingFeatureSelectionY, setGatingFeatureSelectionY: setGatingFeatureSelectionY, gatingFeatureValueTransform: featureValueTransform, setGatingFeatureValueTransform: (newValue) => {
                     setFeatureValueTransform(newValue);
                     setTargetX(null);
                     setTargetY(null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitessce/scatterplot-gating",
-  "version": "3.4.10",
+  "version": "3.4.12",
   "author": "Gehlenborg Lab",
   "homepage": "http://vitessce.io",
   "repository": {
@@ -20,11 +20,11 @@
     "d3-array": "^2.4.0",
     "lodash-es": "^4.17.21",
     "react-aria": "^3.28.0",
-    "@vitessce/constants-internal": "3.4.10",
-    "@vitessce/scatterplot": "3.4.10",
-    "@vitessce/sets-utils": "3.4.10",
-    "@vitessce/utils": "3.4.10",
-    "@vitessce/vit-s": "3.4.10"
+    "@vitessce/constants-internal": "3.4.12",
+    "@vitessce/scatterplot": "3.4.12",
+    "@vitessce/sets-utils": "3.4.12",
+    "@vitessce/utils": "3.4.12",
+    "@vitessce/vit-s": "3.4.12"
   },
   "devDependencies": {
     "react": "^18.0.0",

package/src/GatingSubscriber.js

@@ -30,7 +30,7 @@ import {
   getPointOpacity,
   EmptyMessage,
 } from '@vitessce/scatterplot';
-import { ViewType, COMPONENT_COORDINATION_TYPES } from '@vitessce/constants-internal';
+import { ViewType, COMPONENT_COORDINATION_TYPES, ViewHelpMapping } from '@vitessce/constants-internal';
 import GatingScatterplotOptions from './GatingScatterplotOptions.js';
 
 /**
@@ -58,6 +58,7 @@ export function GatingSubscriber(props) {
     title: titleOverride,
     // Average fill density for dynamic opacity calculation.
     averageFillDensity,
+    helpText = ViewHelpMapping.GATING,
   } = props;
 
   const loaders = useLoaders();
@@ -361,6 +362,7 @@ export function GatingSubscriber(props) {
       urls={urls}
       theme={theme}
       isReady={isReady}
+      helpText={helpText}
       options={(
         <ScatterplotOptions
           observationsLabel={obsType}