@bicharts/chart-mcp 0.6.91 → 0.6.93

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-mcp",
-  "version": "0.6.91",
+  "version": "0.6.93",
   "description": "MCP (Model Context Protocol) stdio server for BIC AI charts: profile a dataset locally, then generate chart code that has passed the BIC backend's render gates. Works with any MCP-capable client (Claude Code, Claude Desktop, Cursor, Copilot Studio). An account pays to author charts; the code it writes is yours and runs with no licence.",
   "keywords": [
     "mcp",
@@ -47,8 +47,8 @@
   },
   "// dependencies": "NONE, deliberately. dist/ bundles every module the server uses, so a runtime dependency installs nothing it needs - it only makes npx fetch that package (and its tree) before the first start. Everything the bundle carries is a devDependency; scripts/verify-package.mjs fails the release if a dependency appears or a shipped file imports anything but Node's built-ins.",
   "devDependencies": {
-    "@bicharts/chart-host": "^0.6.91",
-    "@bicharts/shape-core": "^0.6.91",
+    "@bicharts/chart-host": "^0.6.93",
+    "@bicharts/shape-core": "^0.6.93",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@types/node": "^20.0.0",
     "@types/papaparse": "^5.3.14",

package/skills/bic-charts/CHART-SHAPES.md

@@ -33,6 +33,7 @@ on the same picture, not a looser one.
 | Bivariate World Choropleth | 1 categorical, 2 continuous, geo: country-iso3/country-iso2/country-name | <=250 categories, needs 400x300 px | D3 | Best for two country-level measures that might disagree: wealth vs inequality, revenue vs margin, cases vs deaths - at least 24 countries and two measures that do not simply track each other |
 | Box plot | 1 continuous | needs 460x340 px | D3, Matplotlib, Plotly, Seaborn | Requires one continuous variable (plus optional category) |
 | Bubble chart | 3 continuous | needs 520x380 px | D3, Matplotlib, Plotly, Seaborn | Three continuous variables (x, y, size); one mark per row on continuous axes. If you want both axes grouped into bands with one aggregated bubble per cell, pick Binned bubble matrix instead |
+| Budget allocator | 1 categorical, 2 continuous | needs 560x380 px | D3 | One spend measure and one outcome by channel and period - monthly spend and signups for five marketing channels, budget and sales by region - with at least eight periods per channel |
 | Bullet chart | 1 continuous, a reference value | needs 220x120 px | D3, PLOTLY | Best for actual-vs-target KPIs with thresholds (revenue vs goal, SLA vs target) — a denser, clearer replacement for gauges |
 | Bump chart | 1 categorical, 1 continuous, 3+ time points | <=15 categories, needs 320x280 px | D3, PLOTLY | Best for leaderboard/position dynamics: how a handful of regions, products, or teams change rank quarter to quarter |
 | Calendar heatmap | 1 continuous, 60+ time points | needs 600x420 px | D3, Matplotlib, Plotly, Seaborn | Requires daily datetime data with associated numeric values; best for activity/contribution tracking over time |
@@ -46,6 +47,7 @@ on the same picture, not a looser one.
 | Clustered heatmap | 2 categorical, 1 continuous | <=50 categories, needs 320x320 px | Plotly | Requires two variables for matrix values |
 | Connected scatterplot | 2 continuous, 6+ time points | needs 300x300 px | D3, PLOTLY | Best for the joint trajectory of two related metrics over time (e.g. units vs revenue, unemployment vs inflation) where the path shape is the insight |
 | Custom small multiples | 1 categorical, 1 continuous | <=16 categories, needs 320x240 px | D3, Matplotlib, Plotly, Seaborn | Best when comparing patterns across categories |
+| Cutoff tuner | 1 continuous | needs 560x360 px | D3 | One row per case with a model score or rating and the actual yes/no outcome - churn, fraud, default, conversion - when the question is where to draw the line and what each choice costs |
 | Cycle plot | 1 continuous, 24+ time points | needs 320x280 px | D3, PLOTLY | Best for multi-year monthly/quarterly/weekly data where the question is seasonality vs trend ('is Q4 always highest, and is each Q4 growing?') |
 | Delta KPI | 2 continuous | needs 200x120 px | D3 | Two comparable measures, or one measure at two points in time - this period against last, actual against plan, after against before |
 | Dendrogram (tree diagram) | 2 categorical, 1 continuous | <=60 leaves, needs 320x240 px | D3, Plotly | Best for 2-4 hierarchy levels with ≤ ~80 leaves |

package/skills/bic-charts/SKILL.md

@@ -314,14 +314,20 @@ export async function createGroup(sampleUrl, dotnet) {
     const group = createChartGroup(cols, rows);
     const off = group.onChange(sel => dotnet.invokeMethodAsync("OnSelectionChanged", sel.sourceId, [...sel.rows]));
     return {
-        async mount(el, spec) {                          // spec: { id, dir, height, respondsWith, geoKind }
+        async mount(el, spec) {                          // spec: { id, dir, height, respondsWith, geoKind, lasso }
             const code = await text(`${spec.dir}/chart.js`);   // TEXT: chart-host compiles it and injects d3
             if (spec.geoKind) await loadGeo(spec.geoKind);     // BEFORE the first render: render() is synchronous
             const opts = spec.respondsWith ? { respondsWith: spec.respondsWith } : {};
+            // The host lasso, for a chart whose generate_chart result carries capabilities.lasso (spec.lasso): a drag around
+            // marks selects the ones inside, through the group's own selection, so there is no handler to write. `capable` is
+            // the server's word for this chart; without it there is no lasso.
+            const lasso = spec.lasso
+                ? { capable: true, enabled: true, ...(spec.lasso.rowCap > 0 ? { rowCap: spec.lasso.rowCap } : {}) }
+                : null;
             const host = createChartHost(el, {
                 code, d3, geoKind: spec.geoKind || undefined,
                 data: group.memberPayload(spec.id, opts).payload,
-                options: { width: Math.floor(el.getBoundingClientRect().width), height: spec.height, ...theme(el) },
+                options: { width: Math.floor(el.getBoundingClientRect().width), height: spec.height, ...theme(el), ...(lasso ? { lasso } : {}) },
                 layoutPass: createLegendFitPass(),             // after every render: a legend slid clear of the plot, text brought inside the frame
             });
             host.render();
@@ -428,6 +434,10 @@ export async function createGroup(sampleUrl, dotnet) {
     [Parameter] public string? RespondsWith { get; set; }
     /// <summary>A map's geo.kind from the generate_chart result (e.g. "us-state-name").</summary>
     [Parameter] public string? GeoKind { get; set; }
+    /// <summary>True when the generate_chart result carries capabilities.lasso: a drag around marks selects the ones inside.</summary>
+    [Parameter] public bool Lasso { get; set; }
+    /// <summary>capabilities.lasso.rowCap from the same result, when it gives one: the most rows in view that still get a lasso.</summary>
+    [Parameter] public int? LassoRowCap { get; set; }
 
     ElementReference el;
     IJSObjectReference? chart;
@@ -437,7 +447,8 @@ export async function createGroup(sampleUrl, dotnet) {
         if (!firstRender) return;
         var group = await Group.Ready;
         chart = await group.InvokeAsync<IJSObjectReference>("mount", el,
-            new { id = Id, dir = Dir, height = Height, respondsWith = RespondsWith, geoKind = GeoKind });
+            new { id = Id, dir = Dir, height = Height, respondsWith = RespondsWith, geoKind = GeoKind,
+                  lasso = Lasso ? new { rowCap = LassoRowCap } : null });
     }
 
     /// <summary>A live restyle: merged into the chart's options and repainted.</summary>
@@ -490,6 +501,9 @@ Add `@using MyCharts.Components` to `_Imports.razor`, then on a page:
   `dropLines` says which applies: `ask` carries the question, `on`/`off` means the user already
   answered (the client asked them) and the generated component applies it. Keep the answer when
   the chart is regenerated; never ask again.
+- **Lasso** - when the result's `capabilities.lasso` is present, pass `Lasso="true"` (and `LassoRowCap` with its
+  `rowCap`): a drag around marks then selects the ones inside through the group's own selection, with no handler to
+  write. A chart whose result has none takes neither parameter and has no lasso.
 - **GeoKind** - the result's `geo.kind` (the text reply's `Geo:` line). Without it a map draws
   its marks over no land. `loadGeo` takes that geometry from chart-host itself, so the
   `data.geo.json` the tool also writes beside a map is the same shapes as a file: the page never
@@ -647,6 +661,11 @@ function CountryMap({ table, onPick }) {          // table = the live query resu
 - **`LAYOUT_PASS` is built once, at module scope, and needs `@bicharts/chart-host` 0.6.86 or later.** After
   every render it slides a legend clear of the plot and brings text that runs past the frame back inside; the
   chart component `generate_chart` writes does the same, and a new function on each render would rebuild the host.
+- **The result's `capabilities.lasso` means the chart takes chart-host's lasso (`@bicharts/chart-host` 0.6.84 or later).**
+  Pass `lasso: { capable: true, enabled: true }` in that chart's `options` (add `rowCap` when the result gives one), and a
+  drag around marks selects the ones inside through the same `onSelect` / `selects` a click uses: the gesture and the
+  selection are the host's, so there is no handler to write. The component `generate_chart` writes passes it already.
+  Without `capabilities.lasso` the chart has no lasso, and `lasso: { enabled: false }` turns it off.
 
 **Layout: a chart is never clipped or squashed.** Charts sit in cards, and a card is where they get cut off.
 - Render every chart inside `BicChartPanel`. It sizes the chart from its cell, never from the chart.