plotagents 0.7.0 → 0.8.0

package/AGENTS.md

@@ -14,7 +14,7 @@ const svg = plot({ type, data, x, y, series, title, subtitle, source });
 3. **Always set `source`.** If the data is made up, use `source: "illustrative data"`.
 4. `data` is a list of rows (`[{ region: "Biobío", sales: 1240 }]`). For a wide table, pass `y: ["revenue", "costs"]`.
 5. Call `safePlot(spec)` as your tool: it never throws and returns `errors`, `warnings` and `suggestions`, each with a `fix`. If `ok` is `false`, fix the spec and call again.
-6. Set `locale: "en"` for English number formats (default is Spanish: `1.234,5`).
+6. Set `locale: "en"` for English number formats (default is Spanish: `1.234,5`); also `"pt"`, `"fr"`, `"de"`, or `"auto"` to recognize it from the text. Tables recognize it on their own.
 
 ## Which type
 
@@ -30,6 +30,8 @@ const svg = plot({ type, data, x, y, series, title, subtitle, source });
 | Exponential growth | `line` + `yScale: "log"` | |
 | Relationship between two measures | `regplot` (fit + CI) / `scatter` / `bubble` | `x`, `y`, `hue?`, `size?`, `label?` |
 | Relationship + marginals | `jointplot` | `x`, `y` |
+| Which measures move together | `corr` (`correlation`) | `vars?` (default: every numeric field), `method?` (`"spearman"`), `alpha?: 0.05`; `cluster: true` or `type: "clustermap"` groups them with a dendrogram |
+| Every pair of measures at once | `pairplot` (`splom`) | `vars` (3–6), `hue?`, `corner?`, `kind?: "reg"` |
 | Distribution of one measure | `hist` (`kde: true`), `kde`, `ecdf` | `x`, `hue?` |
 | Distribution by category | `box`, `violin`, `strip`, `swarm` | `x` category, `y` measure, `hue?` |
 | Multi-dimensional profile | `radar` | `axis`, `value`, `series` (≤ 4 series) |
@@ -44,6 +46,7 @@ const svg = plot({ type, data, x, y, series, title, subtitle, source });
 | A process with decisions | `flowchart` | `nodes` (`type`, `lane`), `edges` (`label`) |
 | Flows between stages | `sankey` | `from`, `to`, `value` |
 | One or more numbers | `kpi` | `items: [{ label, value, delta, period, trend, target, good }]` |
+| Exact values to look up | `table` | `columns?: [field \| { field, type, label, format, good, target }]`, `sortBy?`, `total?`, `group?`; types `bar`, `delta`, `heat`, `sparkline`, `progress`, `badge`, `check` are inferred when omitted |
 | What comes up most in text | `wordcloud` | `text` (field or raw text), `value?`, `series?`; prefer `bar` + `top` to compare exactly |
 
 seaborn names work (`histplot`, `kdeplot`, `boxplot`, `violinplot`, `lmplot`, `stripplot`, `swarmplot`, `pointplot`), and `hue` is an alias of `series`. Leave `type` out to infer it from the data.
@@ -59,6 +62,7 @@ seaborn names work (`histplot`, `kdeplot`, `boxplot`, `violinplot`, `lmplot`, `s
 - `refLines: [{ y: 600, label: "Target" }]` and `annotations: [{ x: "2024-01", label: "New branch" }]`.
 - `format: "percent" | "currency" | "compact" | "integer"` or `{ prefix, suffix, decimals }`.
 - `xScale` / `yScale: "log"`.
+- `table`: give a title that states the finding like any chart. More than 15 rows paginate in tens (`pageSize`), phones get one card per row, and the browser adds sort, search and paging. Use `good: "down"` on costs so ▲ turns red, `progress` with `target: "budget"` for spent vs budget, and `total: true` for a totals row. Keep 4–7 columns.
 - `theme: "noche"` or a JSON object (`{ extends, categorical, type, marks, font }`); `palette: [...]` for your own colors.
 - `font: "Poppins"` and `textScale: 1.5` (presentation mode); `configure({ font, textScale })` sets them for every chart.
 - `network` + `focus: "node id"`: center a node and highlight its neighbors.

package/README.md

@@ -55,7 +55,7 @@ Agents are good at data and bad at charts: dual axes, 12-slice pies, titles that
 |---|---|
 | Compare categories | `bar` (`barplot` with confidence intervals), `count` (`countplot`) |
 | Change over time | `line` (`lineplot`, `ci` for a confidence band), `area` |
-| Relationships | `scatter`, `bubble`, `regplot` (`lmplot`), `residplot`, `jointplot` |
+| Relationships | `scatter`, `bubble`, `regplot` (`lmplot`), `residplot`, `jointplot`, `corr` (correlation matrix; `clustermap` with a dendrogram), `pairplot` (`splom`) |
 | Profiles | `radar` (`spider`) |
 | Distributions | `hist` (`histplot`), `kde` (`kdeplot`), `ecdf`, `box` (`boxplot`), `violin`, `strip`, `swarm` (`beeswarm`), `point` (`pointplot`) |
 | Part-to-whole | `treemap` (any depth, with % change over time), `sunburst`, `donut`, `pie` |
@@ -65,6 +65,7 @@ Agents are good at data and bad at charts: dual axes, 12-slice pies, titles that
 | Populations | `pyramid` |
 | Grids | `heatmap` |
 | Numbers | `kpi` |
+| Exact values | `table`: an indicator per column (data bars, ▲/▼ changes, cell colors, sparklines, progress against a target, status pills, ✓), pages of 10, cards on phones, click-to-sort and search in the browser, language recognized from the text |
 | Text | `wordcloud` (words sized by frequency, or raw text to count) |
 | Dashboards | `dashboard({ title, kpis, charts, filters })`: a whole HTML dashboard with best-practice layout ([guide](docs/dashboards.md)) |
 
@@ -168,6 +169,22 @@ import { plot, safePlot, lint, describe, render, toHTML, schema, toolDefinition,
 
 In the browser without a bundler, `<script src="dist/plotagents.js"></script>` defines `window.plotagents`. Full types are in [`index.d.ts`](index.d.ts) and every option in [`schema.json`](schema.json).
 
+## Teach your AI to use it (Agent Skill)
+
+[`skills/plotagents/SKILL.md`](skills/plotagents/SKILL.md) tells any AI assistant to make its charts with plotagents, with the essentials built in. It also checks npm for a newer release and reads the latest guide when there is one.
+
+```bash
+npx skills add carlosnavarreteliz/plotagents
+```
+
+That works for Claude Code, Cursor, Codex and other agents that read skills. By hand, for Claude Code:
+
+```bash
+mkdir -p ~/.claude/skills/plotagents && curl -sL https://raw.githubusercontent.com/carlosnavarreteliz/plotagents/master/skills/plotagents/SKILL.md -o ~/.claude/skills/plotagents/SKILL.md
+```
+
+In the Claude app, zip the `skills/plotagents` folder and upload it under Settings → Capabilities → Skills.
+
 ## As an agent tool
 
 ```js

package/bin/plotagents.js

@@ -8,6 +8,8 @@ import { plot, toHTML, lint, schema, toolDefinition, describe, dashboard, lintDa
 // `plotagents … | head` closes the pipe early: exit quietly instead of crashing.
 for (const stream of [process.stdout, process.stderr]) {
   stream.on('error', (e) => { if (e && e.code === 'EPIPE') process.exit(0); throw e; });
+  // Escritura bloqueante: process.exit() no corta una salida larga (> 64 KB) en un pipe.
+  stream._handle?.setBlocking?.(true);
 }
 
 const args = process.argv.slice(2);
@@ -47,7 +49,7 @@ try { raw = input ? readFileSync(input, 'utf8') : readFileSync(0, 'utf8'); } cat
 let spec;
 try { spec = JSON.parse(raw); } catch (e) { console.error('El spec no es JSON válido:', e.message); process.exit(2); }
 
-const isDashboard = (s) => !!s && typeof s === 'object' && !Array.isArray(s) && Array.isArray(s.charts);
+const isDashboard = (s) => !!s && typeof s === 'object' && !Array.isArray(s) && (Array.isArray(s.charts) || (Array.isArray(s.kpis) && s.type === undefined));
 
 if (flag('--lint')) {
   const list = Array.isArray(spec) ? spec : [spec];

package/dist/plotagents-geo.js

@@ -1,4 +1,4 @@
-/*! plotagents 0.7.0 · MIT · https://github.com/carlosnavarreteliz/plotagents */
+/*! plotagents 0.8.0 · MIT · https://github.com/carlosnavarreteliz/plotagents */
 (function (global) {
 'use strict';
 var __defs = {}, __cache = {};