@czi-sds/mcp 0.18.0 → 0.18.1

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.
@@ -261,7 +261,7 @@ export default App;
261
261
 
262
262
  ### Residue value overlay
263
263
 
264
- A `residueOverlay` paints arbitrary per-residue values over the structure, taking over from pLDDT coloring while it is set. The `values` map is keyed by 0-based residue index, so the first residue of the chain is `0`. Values are normalized into `min`-`max` and sampled from a color scale; residues at or below `min`, and those missing from the map, render in a neutral gray. The legend switches to the overlay's scale and its `label`, and the per-residue readout reports the value under the cursor.
264
+ A `residueOverlay` paints arbitrary per-residue values over the structure, taking over from pLDDT coloring while it is set. The `values` map is keyed by 0-based residue index, so the first residue of the chain is `0`. Values are normalized into `min`-`max` and sampled from a color scale; residues at or below `min`, and those missing from the map, render in a neutral gray. The legend switches to the overlay's scale and its `label`, and the per-residue readout reports the value under the cursor. `tooltip` is a string on the help icon next to the caption; `tooltipProps` is the SDS Tooltip API, for a subtitle, a custom body, or a different placement.
265
265
 
266
266
  **Example: ProteinStructureViewerWithOverlay**
267
267
 
@@ -275,7 +275,8 @@ A `residueOverlay` paints arbitrary per-residue values over the structure, takin
275
275
  // so "no value here" reads differently from "a low value here".
276
276
  //
277
277
  // label captions the legend, readoutLabel names the slot that reports the value
278
- // under the cursor, and tooltip attaches a help icon to the caption.
278
+ // under the cursor, and tooltip is the help title on the caption. tooltipProps
279
+ // reaches the SDS Tooltip for a subtitle, a custom body, or placement.
279
280
  //
280
281
  // The structure below is crambin (PDB 1CRN), trimmed to the backbone atoms the
281
282
  // polymer cartoon traces. An overlay needs a chain long enough to see it on:
@@ -500,6 +501,9 @@ function App() {
500
501
  max: 2.4,
501
502
  readoutLabel: "Activation",
502
503
  tooltip: "Max activation across all residues for this feature",
504
+ tooltipProps: {
505
+ subtitle: "Residues at or below min stay gray.",
506
+ },
503
507
  values: RESIDUE_VALUES,
504
508
  }}
505
509
  />
@@ -1026,15 +1030,16 @@ The viewer spreads any remaining props onto its root div, so standard HTML attri
1026
1030
 
1027
1031
  ### ResidueValueOverlay
1028
1032
 
1029
- | Name | Type | Default | Description |
1030
- | -------------- | --------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
1031
- | `values` | `Map<number, number>` | - (required) | 0-based residue index to value. Residues absent from the map read as `0`, so they render in the neutral gray rather than at the bottom of the scale. |
1032
- | `max` | `number` | - (required) | The value mapped to the top of the color scale. |
1033
- | `min` | `number` | `0` | Values at or below this render in a neutral gray rather than on the scale. |
1034
- | `colorScale` | `ColorScale` | `PLASMA_COLOR_SCALE` | Scale used to color residues and to draw the legend. |
1035
- | `label` | `string` | - | Legend caption, for example "Feature activation". |
1036
- | `tooltip` | `string` | - | Help tooltip attached to the legend caption. |
1037
- | `readoutLabel` | `string` | `"Value"` | Label for the per-residue readout that replaces a stat slot on hover. |
1033
+ | Name | Type | Default | Description |
1034
+ | -------------- | ----------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1035
+ | `values` | `Map<number, number>` | - (required) | 0-based residue index to value. Residues absent from the map read as `0`, so they render in the neutral gray rather than at the bottom of the scale. |
1036
+ | `max` | `number` | - (required) | The value mapped to the top of the color scale. |
1037
+ | `min` | `number` | `0` | Values at or below this render in a neutral gray rather than on the scale. |
1038
+ | `colorScale` | `ColorScale` | `PLASMA_COLOR_SCALE` | Scale used to color residues and to draw the legend. |
1039
+ | `label` | `string` | - | Legend caption, for example "Feature activation". |
1040
+ | `tooltip` | `string` | - | Help tooltip title on the legend caption. A string is enough for the common case; use `tooltipProps` for a subtitle, a custom body, or placement. Overrides `tooltipProps.title` when both are set. |
1041
+ | `tooltipProps` | `Partial<Omit<TooltipProps, "children">>` | - | Props forwarded to the SDS Tooltip on the legend caption. The trigger is the caption's help icon, so `children` is omitted. |
1042
+ | `readoutLabel` | `string` | `"Value"` | Label for the per-residue readout that replaces a stat slot on hover. |
1038
1043
 
1039
1044
  ### StructureStat
1040
1045
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@czi-sds/mcp",
3
3
  "description": "The official MCP server for SDS",
4
- "version": "0.18.0",
4
+ "version": "0.18.1",
5
5
  "main": "dist/stdio.js",
6
6
  "files": [
7
7
  "dist",
@@ -66,5 +66,5 @@
66
66
  "turndown": "^7.2.4",
67
67
  "typescript": "^5.9.2"
68
68
  },
69
- "gitHead": "90a8e57f0c92c4bdea1f0cb4d1cd417461c50280"
69
+ "gitHead": "8fc0fe0e1562922e7e569f6e983968491d6db485"
70
70
  }