plotagents 0.7.0 → 0.8.0

package/src/charts/treemap.js

@@ -10,7 +10,7 @@ import { formatNumber } from '../format.js';
 import { humanize } from '../data.js';
 import { createFrame } from '../frame.js';
 import { ctx } from '../context.js';
-import { buildHierarchy, findNode, assignColors, shareFmt, breadcrumb, height, SEP } from '../hierarchy.js';
+import { buildHierarchy, focusNode, assignColors, shareFmt, breadcrumb, height, SEP } from '../hierarchy.js';
 
 /** Algoritmo squarified (Bruls, Huizing & van Wijk, 2000). */
 export function squarify(items, x, y, w, h) {
@@ -57,7 +57,7 @@ export function treemap(spec, theme) {
   const locale = spec.locale || 'es';
   const en = String(locale).startsWith('en');
   const { root, fields, valueField } = buildHierarchy(spec);
-  const focus = findNode(root, spec.focus);
+  const focus = focusNode(root, spec.focus);
   const levels = height(focus);
   // El color sigue a la entidad: se asigna sobre el árbol completo, así al
   // entrar a un grupo sus elementos conservan la familia de color del padre.

package/src/charts/wordcloud.js

@@ -31,15 +31,26 @@ const STOP = new Set((
   + ' a about above after again all am an and any are as at be because been before being below between both but by can could did do does doing down during each few for from further had has have having he her here hers him his how i if in into is it its itself just me more most my no nor not now of off on once only or other our ours out over own same she should so some such than that the their them then there these they this those through to too under until up very was we were what when where which while who whom why will with would you your yours also get got really much many one two'
 ).split(/\s+/));
 
+// Palabras vacías extra por idioma (se suman a es/en solo si el locale las pide).
+const STOP_BY = {
+  pt: 'não uma uns umas dos das nas nos pelo pela pelos pelas com para por que mas como mais muito já também são foi era tem têm ele ela eles elas isso isto esse essa este esta aos àquele seu sua seus suas meu minha nós você vocês ser estar ter há então quando onde',
+  fr: 'les des une dans pour que qui est sont mais comme plus par sur pas avec ces cette cet aux ils elles nous vous ont été être avoir fait très aussi donc ainsi sans sous entre leur leurs son ses mes tes notre votre',
+  de: 'der die das den dem des ein eine einer einem einen und oder aber nicht mit von zu für auf ist sind war waren wird werden hat haben auch als wie bei nach aus über sich es sie wir ihr ich du er an im am zum zur dass noch nur sehr',
+};
+// Compara sin tildes: "tambien" y "también" son la misma palabra vacía.
+const plain = (w) => w.normalize('NFD').replace(/\p{M}/gu, '');
+const STOP_PLAIN = new Set([...STOP].map(plain));
+
 /** Texto crudo → [{ text, value }] por frecuencia. */
 export function countWords(input, { locale, minLength = 3, stopwords = [] } = {}) {
   const extra = new Set([].concat(stopwords).map((w) => String(w).toLowerCase()));
+  for (const w of (STOP_BY[String(locale || '').slice(0, 2)] || '').split(' ')) if (w) extra.add(w);
   const counts = new Map(), shown = new Map();
   const docs = [].concat(input).filter((d) => typeof d === 'string');
   for (const d of docs) for (const m of d.matchAll(/[\p{L}\p{N}][\p{L}\p{N}'’-]*/gu)) {
     const raw = m[0].replace(/['’-]+$/, '');
     const k = raw.toLowerCase();
-    if (k.length < minLength || STOP.has(k) || extra.has(k) || /^\d+$/.test(k)) continue;
+    if (k.length < minLength || STOP.has(k) || STOP_PLAIN.has(plain(k)) || extra.has(k) || /^\d+$/.test(k)) continue;
     counts.set(k, (counts.get(k) || 0) + 1);
     // Se muestra la forma más común (respeta "Biobío", "IA", "ChatGPT").
     const f = shown.get(k) || new Map();
@@ -76,9 +87,12 @@ export function wordcloud(spec, theme) {
       if (!t) continue;
       const v = valueF ? num(r[valueF]) : 1;
       if (!Number.isFinite(v) || v <= 0) continue;
-      const e = acc.get(t) || { text: t, value: 0, group: groupF ? String(r[groupF]) : null };
+      // Con `series`, la misma palabra en dos grupos son dos entradas (no se funde con el primero).
+      const gk = groupF ? String(r[groupF]) : null;
+      const key = gk === null ? t : gk + '\u0000' + t;
+      const e = acc.get(key) || { text: t, value: 0, group: gk };
       e.value += v;
-      acc.set(t, e);
+      acc.set(key, e);
     }
     words = [...acc.values()];
   }

package/src/colorscales.js

@@ -141,6 +141,17 @@ const LOWER = new Map();
 for (const k of [...Object.keys(COLORMAPS), ...Object.keys(QUALITATIVE)]) LOWER.set(k.toLowerCase(), k);
 const unpack = (s) => s.match(/.{6}/g).map((h) => '#' + h);
 const isHex = (c) => typeof c === 'string' && /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.test(c.trim());
+// Nombres CSS comunes en listas de colores (["white", "steelblue"]): antes se
+// descartaban en silencio y la escala caía a la por defecto.
+const NAMED = {
+  black: '#000000', white: '#ffffff', gray: '#808080', grey: '#808080', lightgray: '#d3d3d3', lightgrey: '#d3d3d3', darkgray: '#a9a9a9', darkgrey: '#a9a9a9', silver: '#c0c0c0',
+  red: '#ff0000', darkred: '#8b0000', crimson: '#dc143c', tomato: '#ff6347', salmon: '#fa8072', pink: '#ffc0cb', maroon: '#800000',
+  orange: '#ffa500', darkorange: '#ff8c00', gold: '#ffd700', yellow: '#ffff00', khaki: '#f0e68c', beige: '#f5f5dc', ivory: '#fffff0', wheat: '#f5deb3', brown: '#a52a2a',
+  green: '#008000', darkgreen: '#006400', lime: '#00ff00', limegreen: '#32cd32', olive: '#808000', seagreen: '#2e8b57', forestgreen: '#228b22', teal: '#008080',
+  cyan: '#00ffff', aqua: '#00ffff', turquoise: '#40e0d0', lightblue: '#add8e6', skyblue: '#87ceeb', steelblue: '#4682b4', blue: '#0000ff', darkblue: '#00008b', navy: '#000080', royalblue: '#4169e1', cornflowerblue: '#6495ed', dodgerblue: '#1e90ff',
+  purple: '#800080', indigo: '#4b0082', violet: '#ee82ee', magenta: '#ff00ff', fuchsia: '#ff00ff', orchid: '#da70d6', lavender: '#e6e6fa', plum: '#dda0dd',
+};
+const toHex = (c) => (isHex(c) ? c.trim() : typeof c === 'string' ? NAMED[c.trim().toLowerCase()] : undefined);
 
 /** Nombres disponibles, por tipo. */
 export function colorScaleNames() {
@@ -161,7 +172,7 @@ export function colorScaleNames() {
 export function resolveColorScale(v) {
   if (!v) return null;
   if (Array.isArray(v)) {
-    const stops = v.filter(isHex);
+    const stops = v.map(toHex).filter(Boolean);
     return stops.length >= 2 ? { name: 'custom', stops, kind: 'sequential' } : null;
   }
   if (typeof v === 'object') {

package/src/dashboard.js

@@ -30,12 +30,19 @@ let core = null;
 /** index.js registra plot/resolve/lint aquí (evita una importación circular). */
 export function _bindDashboard(fns) { core = fns; }
 
+/** Spec tolerante: charts/kpis/filters siempre listas de objetos (los nulos y valores sueltos se descartan). */
+function tidy(spec) {
+  const list = (v) => (v == null || v === false ? [] : [].concat(v)).filter((x) => x != null);
+  return { ...spec, charts: list(spec.charts).filter((c) => typeof c === 'object'), kpis: list(spec.kpis), filters: list(spec.filters).filter((f) => typeof f === 'string' || (typeof f === 'object' && typeof f.field === 'string')) };
+}
+const hasField = (r, f) => r !== null && typeof r === 'object' && f in r;
+
 const T = (locale, es, en) => (String(locale || 'es').startsWith('en') ? en : es);
 
 // Ancho (de 12) según el tipo: lo que se lee de izquierda a derecha, ancho.
 const WIDE = new Set(['line', 'area', 'gantt', 'heatmap', 'sankey', 'flowchart', 'network', 'jointplot']);
 const NARROW = new Set(['donut', 'pie', 'radar', 'kpi', 'hist', 'kde', 'ecdf', 'count']);
-const AUTO_HEIGHT = new Set(['kpi', 'gantt', 'flowchart']);
+const AUTO_HEIGHT = new Set(['kpi', 'gantt', 'flowchart', 'table']);
 
 function spanFor(s) {
   if (s.size === 'full' || s.span === 12) return 12;
@@ -131,6 +138,7 @@ const colorField = (s) => s.series ?? s.hue ?? (Array.isArray(s.path) ? s.path[0
 export function planDashboard(spec = {}) {
   if (!core) throw new PlotError('plotagents no está inicializado.');
   if (!spec || typeof spec !== 'object') throw new PlotError('El dashboard debe ser un objeto.', 'dashboard({ title, kpis, charts: [...] })');
+  spec = tidy(spec);
   const locale = spec.locale || 'es';
   const shared = spec.data ? ensureData(spec) : null;
   const base = {};
@@ -191,7 +199,7 @@ export function planDashboard(spec = {}) {
   const filters = [].concat(spec.filters || []).map((f) => {
     const o = typeof f === 'string' ? { field: f } : { ...f };
     const pool = [...(shared || []), ...panels.flatMap((p) => (Array.isArray(p.spec.data) && p.spec.data !== shared ? p.spec.data : []))];
-    const vals = uniq(pool.map((r) => r[o.field]).filter((v) => v !== undefined && v !== null && v !== ''));
+    const vals = uniq(pool.filter((r) => hasField(r, o.field)).map((r) => r[o.field]).filter((v) => v !== undefined && v !== null && v !== ''));
     const kind = pool.length ? fieldKind(pool, o.field) : 'category';
     vals.sort((a, b) => (kind === 'date' ? parseDate(a) - parseDate(b) : kind === 'year' || kind === 'number' ? num(a) - num(b) : 0));
     return { field: o.field, label: o.label ?? o.field.charAt(0).toUpperCase() + o.field.slice(1), values: vals.map(String), control: o.control ?? (vals.length <= 6 ? 'buttons' : 'select'), value: o.value ?? o.default ?? null, all: o.all ?? T(locale, 'Todos', 'All') };
@@ -205,6 +213,7 @@ export function planDashboard(spec = {}) {
 
 // ── Revisión (lint) ────────────────────────────────────────────────────────
 export function lintDashboard(spec = {}) {
+  spec = tidy(spec && typeof spec === 'object' ? spec : {});
   const locale = spec.locale || 'es';
   const L = (es, en) => T(locale, es, en);
   const errors = [], warnings = [], suggestions = [];
@@ -226,7 +235,7 @@ export function lintDashboard(spec = {}) {
   if (untitled) suggestions.push({ code: 'dash-chart-titles', message: L(`${untitled} gráfico(s) sin título.`, `${untitled} chart(s) without a title.`), fix: L('Cada panel necesita su hallazgo como título.', 'Every panel needs its finding as the title.') });
   for (const f of [].concat(spec.filters || [])) {
     const field = typeof f === 'string' ? f : f.field;
-    const has = [spec.data, ...charts.map((c) => c.data)].some((d) => Array.isArray(d) && d.some((r) => r && field in r));
+    const has = [spec.data, ...charts.map((c) => c.data)].some((d) => Array.isArray(d) && d.some((r) => hasField(r, field)));
     if (!has) warnings.push({ code: 'dash-filter-field', message: L(`El filtro "${field}" no existe en los datos de ningún gráfico.`, `The filter "${field}" is not in any chart's data.`), fix: L('Usa un campo de `data`.', 'Use a field of `data`.') });
   }
   // Revisión de cada gráfico, con su número y título.
@@ -291,7 +300,9 @@ export function kpiMarkup(plan, rows) {
     if (k.trendBy && !k.trend && rows && rows.length) {
       const by = new Map();
       for (const r of cmp ? inPeriod(cmp.current) : rows) { const key = r[k.trendBy]; if (!by.has(key)) by.set(key, []); by.get(key).push(r); }
-      const ks = [...by.keys()].sort((x, y) => (String(x) < String(y) ? -1 : 1));
+      // Periodos numéricos (1…12) se ordenan como números; el resto, como texto (fechas ISO).
+      const allNum = [...by.keys()].every((x) => Number.isFinite(num(x)));
+      const ks = [...by.keys()].sort((x, y) => (allNum ? num(x) - num(y) : String(x) < String(y) ? -1 : String(x) > String(y) ? 1 : 0));
       k = { ...k, trend: ks.map((x) => computeKpi(k, by.get(x))) };
     }
     const fmt = makeFormat(k.format, locale, [v]);
@@ -344,7 +355,7 @@ export function filterSpec(spec, plan, active, locale) {
     const v = active[i];
     if (v === null || v === undefined || v === '') return;
     if (s.time === f.field) { s = { ...s, timeValue: v }; return; }
-    if (Array.isArray(s.data) && s.data.some((r) => r && f.field in r)) { s = { ...s, data: s.data.filter((r) => String(r[f.field]) === String(v)) }; tags.push(`${f.label}: ${v}`); }
+    if (Array.isArray(s.data) && s.data.some((r) => hasField(r, f.field))) { s = { ...s, data: s.data.filter((r) => hasField(r, f.field) && String(r[f.field]) === String(v)) }; tags.push(`${f.label}: ${v}`); }
   });
   if (tags.length) s = { ...s, subtitle: [s.subtitle, tags.join(' · ')].filter(Boolean).join(' · ') };
   return s;
@@ -368,7 +379,7 @@ export function mountDashboard(root, plan) {
     }
     // KPIs calculados: se recalculan con los filtros.
     if (plan.data && plan.kpis.some((k) => k.value === undefined)) {
-      const rows = plan.data.filter((r) => plan.filters.every((f, i) => active[i] === null || active[i] === '' || !(f.field in r) || String(r[f.field]) === String(active[i])));
+      const rows = plan.data.filter((r) => plan.filters.every((f, i) => active[i] === null || active[i] === '' || !hasField(r, f.field) || String(r[f.field]) === String(active[i])));
       const slot = root.querySelector('.pa-kslot');
       if (slot) slot.innerHTML = kpiMarkup(plan, rows);
     }
@@ -430,9 +441,11 @@ ${bundle ? `<script>${bundle.replace(/<\/(script)/gi, '<\\/$1')}</script>
 
 /** Nunca lanza: { ok, html, plan, errors, warnings, suggestions } (para agentes). */
 export function safeDashboard(spec) {
-  const rep = lintDashboard(spec || {});
+  let rep;
+  try { rep = lintDashboard(spec || {}); }
+  catch (e) { return { ok: false, html: null, plan: null, errors: [{ code: 'render', message: String(e.message).split('\n')[0], fix: e.hint || 'Revisa que `charts` sea una lista de specs y `kpis` una lista de objetos.' }], warnings: [], suggestions: [] }; }
   if (!rep.ok) return { ...rep, html: null, plan: null };
   try { const html = dashboard(spec); return { ...rep, ok: true, html, plan: planDashboard(spec) }; }
-  catch (e) { return { ...rep, ok: false, html: null, plan: null, errors: [...rep.errors, { code: 'render', message: e.message.split('\n')[0], fix: e.hint }] }; }
+  catch (e) { return { ...rep, ok: false, html: null, plan: null, errors: [...rep.errors, { code: 'render', message: e.message.split('\n')[0], fix: e.hint || 'Revisa `charts`, `kpis` y `data` del dashboard.' }] }; }
 }
 

package/src/data.js

@@ -15,6 +15,8 @@ export function num(v) {
   if (typeof v === 'number') return v;
   if (v === null || v === undefined || v === '' || typeof v === 'boolean') return NaN;
   let s = String(v).trim().replace(/[\s$€£%]|US\$|CLP|UF/g, '').replace('−', '-');
+  // Solo símbolos ("%", "$", " ") no es el 0; y nada de "0x10" ni "Infinity".
+  if (!/^[+-]?(\d[\d.,]*|[.,]\d[\d.,]*)(e[+-]?\d+)?$/i.test(s)) return NaN;
   const hasC = s.includes(','), hasD = s.includes('.');
   if (hasC && hasD) s = s.lastIndexOf(',') > s.lastIndexOf('.') ? s.replace(/\./g, '').replace(',', '.') : s.replace(/,/g, '');
   else if (hasC) s = /,\d{3}(?!\d)/.test(s) && !/,\d{1,2}$/.test(s) ? s.replace(/,/g, '') : s.replace(',', '.');

package/src/facet.js

@@ -32,9 +32,10 @@ export function facet(spec, theme, renderOne) {
   const frame = createFrame({ ...spec, height: 200 }, theme, { width: 720 });
   const area = frame.layout(legend);
   const gap = spec.panelGap ?? 14;
-  // Columnas pedidas, pero nunca paneles de menos de ~150 px (en móvil se apilan).
-  const fit = Math.max(1, Math.floor((area.w + gap) / 150));
-  const want = spec.columns ?? spec.colWrap ?? spec.col_wrap ?? Math.max(1, Math.floor((area.w + gap) / 230));
+  // Columnas pedidas, pero nunca paneles más angostos que el mínimo de un gráfico
+  // (240 px, ver createFrame): más angostos se montarían unos sobre otros.
+  const fit = Math.max(1, Math.floor((area.w + gap) / 240));
+  const want = (typeof spec.columns === 'number' ? spec.columns : undefined) ?? spec.colWrap ?? spec.col_wrap ?? Math.max(1, Math.floor((area.w + gap) / 230));
   const cols = Math.max(1, Math.min(keys.length, want, fit));
   const pw = (area.w - gap * (cols - 1)) / cols;
   const ph = spec.panelHeight ?? Math.round(Math.min(300, Math.max(160, pw * 0.66)));

package/src/format.js

@@ -4,19 +4,29 @@
 const SEP = {
   es: { group: '.', dec: ',' },
   en: { group: ',', dec: '.' },
+  pt: { group: '.', dec: ',' },
+  de: { group: '.', dec: ',' },
+  fr: { group: '\u202F', dec: ',' }, // espacio fino: 1 234,5
 };
 
 const COMPACT = {
   es: [[1e12, ' B'], [1e6, ' M'], [1e3, ' mil']],
   en: [[1e12, 'T'], [1e9, 'B'], [1e6, 'M'], [1e3, 'K']],
+  pt: [[1e12, ' tri'], [1e9, ' bi'], [1e6, ' mi'], [1e3, ' mil']],
+  fr: [[1e12, ' Bn'], [1e9, ' Md'], [1e6, ' M'], [1e3, ' k']],
+  de: [[1e12, ' Bio.'], [1e9, ' Mrd.'], [1e6, ' Mio.'], [1e3, ' Tsd.']],
 };
 
 export const MONTHS = {
   es: ['ene', 'feb', 'mar', 'abr', 'may', 'jun', 'jul', 'ago', 'sep', 'oct', 'nov', 'dic'],
   en: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
+  pt: ['jan', 'fev', 'mar', 'abr', 'mai', 'jun', 'jul', 'ago', 'set', 'out', 'nov', 'dez'],
+  fr: ['janv.', 'févr.', 'mars', 'avr.', 'mai', 'juin', 'juil.', 'août', 'sept.', 'oct.', 'nov.', 'déc.'],
+  de: ['Jan.', 'Feb.', 'März', 'Apr.', 'Mai', 'Juni', 'Juli', 'Aug.', 'Sep.', 'Okt.', 'Nov.', 'Dez.'],
 };
 
-const loc = (l) => (l && String(l).toLowerCase().startsWith('en') ? 'en' : 'es');
+/** Idioma de formato: es, en, pt, fr o de ("pt-BR" → pt); cualquier otro, es. */
+const loc = (l) => { const k = String(l || 'es').toLowerCase().slice(0, 2); return k in SEP ? k : 'es'; };
 
 /** Número con separadores. `decimals` fijo; `trim` quita ceros finales. */
 export function formatNumber(v, decimals = 0, locale = 'es', trim = false) {
@@ -24,7 +34,8 @@ export function formatNumber(v, decimals = 0, locale = 'es', trim = false) {
   if (!Number.isFinite(v)) return v > 0 ? '∞' : '-∞';
   const { group, dec } = SEP[loc(locale)];
   const neg = v < 0;
-  let [int, frac = ''] = Math.abs(v).toFixed(Math.max(0, Math.min(20, Math.round(+decimals) || 0))).split('.');
+  const fixed = Math.abs(v) >= 1e21 ? BigInt(Math.abs(v)).toString() : Math.abs(v).toFixed(Math.max(0, Math.min(20, Math.round(+decimals) || 0))); // toFixed pasa a "1e+21"
+  let [int, frac = ''] = fixed.split('.');
   int = int.replace(/\B(?=(\d{3})+(?!\d))/g, group);
   if (trim) frac = frac.replace(/0+$/, '');
   const out = frac ? int + dec + frac : int;
@@ -44,10 +55,16 @@ export function smartDecimals(v) {
 export function formatCompact(v, locale = 'es', decimals) {
   const l = loc(locale);
   const a = Math.abs(v);
-  for (const [n, suf] of COMPACT[l]) {
+  const tbl = COMPACT[l];
+  for (let i = 0; i < tbl.length; i++) {
+    let [n, suf] = tbl[i];
     if (a >= n) {
-      const s = v / n;
-      const d = decimals ?? (Math.abs(s) < 10 ? 1 : 0);
+      let s = v / n;
+      let d = decimals ?? (Math.abs(s) < 10 ? 1 : 0);
+      // 999.999 → "1.000 mil" no: al redondear llega a 1000, sube a la unidad siguiente (1 M).
+      if (i > 0 && tbl[i - 1][0] / n === 1000 && Math.abs(+Math.abs(s).toFixed(d)) >= 1000) {
+        [n, suf] = tbl[i - 1]; s = v / n; d = decimals ?? (Math.abs(s) < 10 ? 1 : 0);
+      }
       return formatNumber(s, d, l, decimals === undefined) + suf;
     }
   }
@@ -109,7 +126,7 @@ export function makeFormat(fmt, locale = 'es', values = []) {
   return f;
 }
 
-function currencyPrefix(cur, l) {
+export function currencyPrefix(cur, l) {
   if (!cur) return '$';
   const c = String(cur).toUpperCase();
   return { USD: 'US$', CLP: '$', EUR: '€', UF: 'UF ', GBP: '£', PEN: 'S/ ', MXN: 'MX$', BRL: 'R$' }[c] || c + ' ';
@@ -121,8 +138,8 @@ function tickFormat(step, o, type, l, pre, suf, max, dFixed, ticks) {
   const decFor = (s) => {
     const a = Math.abs(s) || 1;
     let d = Math.max(0, -Math.floor(Math.log10(a) + 1e-9));
-    while (d < 6 && Math.abs(Math.round(a * 10 ** d) - a * 10 ** d) > 1e-6 * 10 ** d) d++;
-    return Math.min(6, d);
+    while (d < 12 && Math.abs(Math.round(a * 10 ** d) - a * 10 ** d) > 1e-6 * 10 ** d) d++;
+    return Math.min(12, d);
   };
   let core;
   if (type === 'year') core = (v) => String(Math.round(v));
@@ -141,9 +158,12 @@ function tickFormat(step, o, type, l, pre, suf, max, dFixed, ticks) {
       ? (v) => formatNumber(v, decFor(step), l)
       : (v) => formatNumber(v / unit, decFor(step / unit), l, true) + sufx;
   } else core = (v) => formatNumber(v, dFixed ?? decFor(step), l);
+  // Una marca entera se escribe sin ",0" (600, no 600,0); las fraccionarias
+  // conservan sus decimales (0 · 0,5 · 1 · 1,5).
+  const zeroFrac = new RegExp('\\' + SEP[l].dec + '0+(?!\\d)');
   return (v) => {
     if (v === 0 && dFixed === undefined && type !== 'year') return pre + '0' + (type === 'percent' ? '%' : '') + suf;
-    const s = core(v);
+    const s = core(v).replace(zeroFrac, '');
     if (pre && s.startsWith('−')) return '−' + pre + s.slice(1) + suf;
     return pre + s + suf;
   };
@@ -163,7 +183,8 @@ export function parseDate(v) {
   if (v instanceof Date) return v.getTime();
   if (typeof v === 'string') {
     const m = ISO.exec(v.trim());
-    if (m) {
+    // Rangos válidos: "2020-21" (temporada) o "2024-13" no son fechas.
+    if (m && +m[2] >= 1 && +m[2] <= 12 && +(m[3] || 1) >= 1 && +(m[3] || 1) <= new Date(Date.UTC(+m[1], +m[2], 0)).getUTCDate() && +(m[4] || 0) < 24 && +(m[5] || 0) < 60 && +(m[6] || 0) < 60) {
       const ms = m[7] ? Math.round(+('0.' + m[7]) * 1000) : 0;
       let t = Date.UTC(+m[1], +m[2] - 1, +(m[3] || 1), +(m[4] || 0), +(m[5] || 0), +(m[6] || 0), ms);
       const z = m[8];
@@ -178,7 +199,7 @@ export function parseDate(v) {
   return NaN;
 }
 
-export const isDateLike = (v) => v instanceof Date || (typeof v === 'string' && ISO.test(v.trim()));
+export const isDateLike = (v) => v instanceof Date || (typeof v === 'string' && Number.isFinite(parseDate(v)));
 
 /**
  * Fecha legible. `unit`: 'year' | 'quarter' | 'month' | 'day' | 'hour' | 'minute'.
@@ -196,8 +217,10 @@ export function formatDate(ms, unit, locale = 'es', withYear = true) {
     return formatDate(ms, 'day', l, withYear !== 'day') + ' ' + hm;
   }
   if (unit === 'year') return String(y);
-  if (unit === 'quarter') return `T${Math.floor(d.getUTCMonth() / 3) + 1}${withYear ? ' ' + y : ''}`.replace('T', l === 'en' ? 'Q' : 'T');
+  if (unit === 'quarter') return `T${Math.floor(d.getUTCMonth() / 3) + 1}${withYear ? ' ' + y : ''}`.replace('T', l === 'en' || l === 'de' ? 'Q' : 'T');
   if (unit === 'month') return withYear ? `${m} ${y}` : m;
   const day = d.getUTCDate();
-  return l === 'en' ? `${m} ${day}${withYear ? ', ' + y : ''}` : `${day} ${m}${withYear ? ' ' + y : ''}`;
+  if (l === 'en') return `${m} ${day}${withYear ? ', ' + y : ''}`;
+  if (l === 'de') return `${day}. ${m}${withYear ? ' ' + y : ''}`;
+  return `${day} ${m}${withYear ? ' ' + y : ''}`;
 }

package/src/frame.js

@@ -4,6 +4,7 @@ import { el, esc, g, text, r2 } from './svg.js';
 import { measure, wrap, truncate } from './text.js';
 import { FONT, FONT_CSS } from './theme.js';
 import { ctx } from './context.js';
+import { words } from './i18n.js';
 
 export const SIZES = {
   title: 22,
@@ -49,7 +50,7 @@ export function createFrame(spec, theme, defaults = {}) {
   if (subLines.length) y += subLines.length * slh + 2;
   if (titleLines.length || subLines.length) y += 10;
 
-  const srcText = spec.source ? (/^fuente|^source/i.test(spec.source) ? spec.source : (String(spec.locale || 'es').startsWith('en') ? 'Source: ' : 'Fuente: ') + spec.source) : '';
+  const srcText = spec.source ? (/^(fuente|source|fonte|quelle)/i.test(spec.source) ? spec.source : words(spec.locale).source + spec.source) : '';
   // Una fuente larga salta a una segunda línea en vez de salirse por la izquierda.
   const srcLines = srcText ? wrap(srcText, innerW, T.source, 400, 2) : [];
   const srcLH = Math.round(T.source * X * 1.35);
@@ -97,7 +98,7 @@ export function createFrame(spec, theme, defaults = {}) {
     },
     /** Permite a gráficos de alto automático (kpi) fijar el alto final. */
     setHeight(h) { height = h; },
-    finish(body, { desc = '', type = 'chart', defs = '' } = {}) {
+    finish(body, { desc = '', type = 'chart', defs = '', role = 'img', css = '' } = {}) {
       if (legendBottom) {
         const { svg } = drawLegend(legendBottom.items, pad, height - pad - sourceH - legendBottom.h - 2, innerW, theme, { ...legendBottom.opts, size: T.legend });
         header.push(svg);
@@ -108,7 +109,8 @@ export function createFrame(spec, theme, defaults = {}) {
       const fontImport = spec.fontImport ? `@import url('${theme.font?.import || FONT_CSS}');` : '';
       const style = `${fontImport}.pa-m{transition:opacity .15s ease}.pa-focus .pa-m{opacity:.28}.pa-focus .pa-m.pa-on{opacity:1}@media (prefers-reduced-motion:reduce){.pa-m{transition:none}}.pa-chart:focus-visible{outline:2px solid ${theme.categorical[0]};outline-offset:2px}`
         + (type === 'network' ? '.pa-focus .pa-net .pa-m{opacity:.12}.pa-focus .pa-net .pa-m.pa-on{opacity:1}' : '')
-        + (/^(choropleth|symbolmap|pointmap)$/.test(type) ? '.pa-zoom path,.pa-zoom circle,.pa-zoom rect{vector-effect:non-scaling-stroke}.pa-zoom-hide{transition:opacity .2s ease}.pa-zoomed .pa-zoom-hide{opacity:0}' : '');
+        + (/^(choropleth|symbolmap|pointmap)$/.test(type) ? '.pa-zoom path,.pa-zoom circle,.pa-zoom rect{vector-effect:non-scaling-stroke}.pa-zoom-hide{transition:opacity .2s ease}.pa-zoomed .pa-zoom-hide{opacity:0}' : '')
+        + css;
       return el(
         'svg',
         {
@@ -116,8 +118,9 @@ export function createFrame(spec, theme, defaults = {}) {
           viewBox: `0 0 ${width} ${r2(height)}`,
           width,
           height: r2(height),
-          role: 'img',
-          'aria-labelledby': `${id}-t ${id}-d`,
+          role,
+          'aria-labelledby': role === 'img' ? `${id}-t ${id}-d` : `${id}-t`,
+          'aria-describedby': role === 'img' ? null : `${id}-d`,
           fontFamily: spec.fontFamily || theme.font?.family || FONT,
           class: 'pa-chart',
           'data-pa-type': type,

package/src/geo/projection.js

@@ -95,8 +95,10 @@ export const projections = {
  */
 export function makeProjection(p) {
   if (!p) return null;
-  if (typeof p === 'string') { const f = projections[p] || projections[p.toLowerCase()]; return f ? f() : null; }
-  if (typeof p === 'object') { const f = projections[p.type || p.name]; return f ? f(p) : null; }
+  // Sin distinguir mayúsculas ni guiones: "equalearth", "Equal-Earth" y "equalEarth" son lo mismo.
+  const find = (n) => { const k = String(n ?? '').toLowerCase().replace(/[-_\s]/g, ''); const hit = Object.keys(projections).find((x) => x.toLowerCase().replace(/[-_\s]/g, '') === k); return hit ? projections[hit] : null; };
+  if (typeof p === 'string') { const f = projections[p] || find(p); return f ? f() : null; }
+  if (typeof p === 'object') { const f = projections[p.type || p.name] || find(p.type || p.name); return f ? f(p) : null; }
   return null;
 }
 

package/src/hierarchy.js

@@ -66,6 +66,12 @@ export function findNode(root, focus = []) {
   return node;
 }
 
+/** Nodo de foco para dibujar: una hoja no se puede "abrir" (quedaría vacío), se usa su padre. */
+export function focusNode(root, focus = []) {
+  const n = findNode(root, focus);
+  return !n.children.length && n.parent ? n.parent : n;
+}
+
 export const height = (n) => (n.children.length ? 1 + Math.max(...n.children.map(height)) : 0);
 export const descendants = (n) => [n, ...n.children.flatMap(descendants)];
 

package/src/i18n.js

@@ -0,0 +1,107 @@
+// Idioma: reconocimiento a partir del texto del spec y las pocas palabras que
+// la biblioteca escribe por su cuenta (fuente, total, buscar…). Lo demás
+// (paginación, flechas, ✓) se dibuja con símbolos que no dependen del idioma.
+//
+//   detectLocale(['Ventas por región, 2025', 'Biobío'])  → 'es'
+//   detectLocale(['Sales grew 12% in the South'])          → 'en'
+//   locale: 'auto' en cualquier spec (y por defecto en `table`) lo usa.
+
+export const LANGS = ['es', 'en', 'pt', 'fr', 'de'];
+
+const WORDS = {
+  es: { source: 'Fuente: ', total: 'Total', search: 'Buscar', none: 'Sin resultados', clear: 'Borrar', page: 'Página', prev: 'Anterior', next: 'Siguiente', sort: 'Ordenar por', yes: 'Sí', no: 'No', rows: 'filas', table: 'Tabla', of: 'de' },
+  en: { source: 'Source: ', total: 'Total', search: 'Search', none: 'No results', clear: 'Clear', page: 'Page', prev: 'Previous', next: 'Next', sort: 'Sort by', yes: 'Yes', no: 'No', rows: 'rows', table: 'Table', of: 'of' },
+  pt: { source: 'Fonte: ', total: 'Total', search: 'Buscar', none: 'Sem resultados', clear: 'Limpar', page: 'Página', prev: 'Anterior', next: 'Próxima', sort: 'Ordenar por', yes: 'Sim', no: 'Não', rows: 'linhas', table: 'Tabela', of: 'de' },
+  fr: { source: 'Source : ', total: 'Total', search: 'Rechercher', none: 'Aucun résultat', clear: 'Effacer', page: 'Page', prev: 'Précédente', next: 'Suivante', sort: 'Trier par', yes: 'Oui', no: 'Non', rows: 'lignes', table: 'Tableau', of: 'sur' },
+  de: { source: 'Quelle: ', total: 'Gesamt', search: 'Suchen', none: 'Keine Treffer', clear: 'Löschen', page: 'Seite', prev: 'Zurück', next: 'Weiter', sort: 'Sortieren nach', yes: 'Ja', no: 'Nein', rows: 'Zeilen', table: 'Tabelle', of: 'von' },
+};
+
+/** Código de idioma soportado ('es', 'en', 'pt', 'fr', 'de') a partir de cualquier etiqueta ('pt-BR', 'en_US'…). */
+export function langOf(locale) {
+  const k = String(locale || 'es').toLowerCase().slice(0, 2);
+  return LANGS.includes(k) ? k : 'es';
+}
+
+/** Palabras de interfaz en el idioma del gráfico. */
+export const words = (locale) => WORDS[langOf(locale)];
+
+// Palabras funcionales frecuentes de cada idioma. Una palabra compartida
+// (de, la, que…) reparte su peso entre los idiomas que la usan.
+const STOP = {
+  es: 'de la el los las y en por con para del que una un se al más es son sus su según entre como año años sin hasta desde ventas región regiones total mil millones porcentaje hogares personas este esta sobre cada ha han fue lidera mayor menor tasa crecimiento meta comuna comunas mes meses semana proyecto estado avance',
+  en: 'the of and in by for with to is are from on at than more its as per was were this that which share sales region regions total thousand million percent households people over each has have had leads largest smallest rate growth target month months week project status progress revenue year years',
+  pt: 'de da do das dos e em por com para que uma um ao mais é são sua seu entre como ano anos não até desde pelo pela no na nos nas vendas região total mil milhões taxa crescimento meta mês meses projeto estado cada foi tem',
+  fr: 'de la le les et en par pour avec du des que une un au aux plus est sont sa son ses entre comme année années sans jusqu depuis sur dans ventes région total mille millions taux croissance objectif mois semaine projet état chaque été',
+  de: 'der die das und in von mit für zu ist sind den dem des ein eine einer im am mehr als nach bei auf aus nicht jahr jahre umsatz region gesamt tausend millionen anteil wachstum ziel monat monate woche projekt status jede wurde hat',
+};
+const INDEX = new Map();
+for (const [lang, list] of Object.entries(STOP)) for (const w of list.split(' ')) { if (!INDEX.has(w)) INDEX.set(w, []); INDEX.get(w).push(lang); }
+
+// Letras que delatan un idioma (se suman a las palabras).
+const CHARS = [
+  [/[ñ¿¡]/g, { es: 3 }],
+  [/[ãõ]/g, { pt: 3 }],
+  [/ç/g, { pt: 1.5, fr: 1.5 }],
+  [/[èêëàâùûœî]/g, { fr: 2 }],
+  [/[äöüß]/g, { de: 3 }],
+  [/[áíóú]/g, { es: 1, pt: 1 }],
+  [/é/g, { es: 0.5, pt: 0.5, fr: 0.8 }],
+];
+
+/**
+ * Idioma más probable de unos textos (títulos, encabezados, categorías), o
+ * null si no hay señal suficiente. Determinista y sin diccionarios grandes.
+ */
+export function detectLocale(texts) {
+  const s = [].concat(texts || []).filter((t) => typeof t === 'string' && t).join(' \n ').toLowerCase().slice(0, 6000);
+  if (!s) return null;
+  const score = { es: 0, en: 0, pt: 0, fr: 0, de: 0 };
+  for (const tok of s.split(/[^\p{L}]+/u)) {
+    const langs = tok && INDEX.get(tok);
+    if (langs) for (const l of langs) score[l] += 1 / langs.length;
+  }
+  for (const [re, w] of CHARS) {
+    const n = (s.match(re) || []).length;
+    if (n) for (const [l, v] of Object.entries(w)) score[l] += Math.min(6, n) * v;
+  }
+  const ranked = Object.entries(score).sort((a, b) => b[1] - a[1]);
+  const [[best, a], [, b]] = ranked;
+  if (a < 1 || a < b * 1.25 + 0.25) return null;
+  return best;
+}
+
+/** Idioma del documento en el navegador (`<html lang>` o el del sistema), o null. */
+export function browserLocale() {
+  // Solo en un navegador: Node 21+ también define `navigator`, y el SVG del servidor no debe depender de él.
+  if (typeof document === 'undefined') return null;
+  try {
+    const l = (document.documentElement && document.documentElement.lang) || (typeof navigator !== 'undefined' && navigator.language) || '';
+    const k = String(l).toLowerCase().slice(0, 2);
+    return LANGS.includes(k) ? k : null;
+  } catch { return null; }
+}
+
+/**
+ * Textos de un spec que delatan su idioma: título, bajada, fuente, nombres de
+ * columna y algunas categorías.
+ */
+export function specTexts(spec, data) {
+  const out = [spec.title, spec.subtitle, spec.source, spec.dashedLabel];
+  for (const c of [].concat(Array.isArray(spec.columns) ? spec.columns : [])) {
+    if (typeof c === 'string') out.push(c);
+    else if (c && typeof c === 'object') out.push(c.label, c.field);
+  }
+  if (Array.isArray(data)) {
+    const rows = data.slice(0, 40);
+    const keys = new Set();
+    for (const r of rows) if (r && typeof r === 'object') for (const [k, v] of Object.entries(r)) { keys.add(k); if (typeof v === 'string' && v.length > 2 && !/^[\d\s.,%$€£-]+$/.test(v)) out.push(v); }
+    // Nombres de campo con guiones bajos o camelCase: "ventas_region" → "ventas region".
+    for (const k of keys) out.push(String(k).replace(/[_-]+/g, ' ').replace(/([a-z])([A-Z])/g, '$1 $2'));
+  }
+  return out;
+}
+
+/** Resuelve `locale: "auto"`: idioma del texto, luego el del navegador, luego español. */
+export function autoLocale(spec, data) {
+  return detectLocale(specTexts(spec, data)) || browserLocale() || 'es';
+}

package/src/index.js

@@ -31,8 +31,11 @@ import './geo/chile.js';
 import './geo/world.js';
 import './geo/usa.js';
 import { heatmap } from './charts/heatmap.js';
+import { corr, pairplot, correlations } from './charts/corr.js';
 import { sankey } from './charts/sankey.js';
 import { kpi } from './charts/kpi.js';
+import { table } from './charts/table.js';
+import { autoLocale, detectLocale } from './i18n.js';
 import { ensureData, PlotError, fieldKind, uniq, num } from './data.js';
 import { facet } from './facet.js';
 import { parseDate } from './format.js';
@@ -59,8 +62,11 @@ const RENDERERS = {
   donut: (s, t) => donut(s, t),
   pie: (s, t) => pie(s, t),
   heatmap: (s, t) => heatmap(s, t),
+  corr: (s, t) => corr(s, t),
+  pairplot: (s, t) => pairplot(s, t),
   sankey: (s, t) => sankey(s, t),
   kpi: (s, t) => kpi(s, t),
+  table: (s, t) => table(s, t),
   hist: (s, t) => hist(s, t),
   kde: (s, t) => kde(s, t),
   ecdf: (s, t) => ecdf(s, t),
@@ -93,7 +99,7 @@ export function resolve(spec = {}) {
   // refLines / annotations: un objeto suelto vale como lista de uno.
   for (const k of ['refLines', 'annotations']) if (s[k] != null && !Array.isArray(s[k]) && typeof s[k] === 'object') s[k] = [s[k]];
   if (s.color && !s.series && typeof s.color === 'string' && !s.color.startsWith('#')) s.series = s.color;
-  let type = s.type && s.type !== 'auto' ? String(s.type).toLowerCase() : null;
+  let type = s.type && s.type !== 'auto' ? String(s.type).trim().toLowerCase() : null;
   if (type) {
     const [t, extra] = normalizeType(type);
     type = t;
@@ -105,6 +111,10 @@ export function resolve(spec = {}) {
   }
   if (!RENDERERS[type]) throw new PlotError(`Tipo de gráfico "${s.type}" no soportado.`, `Usa uno de: ${TYPES.join(', ')} o "auto".`);
   s.type = type;
+  // Idioma: `locale: "auto"` (y las tablas sin `locale`) lo reconocen del texto del spec.
+  if (s.locale === 'auto' || (s.locale === undefined && type === 'table')) {
+    s.locale = autoLocale(s, Array.isArray(s.data) ? s.data : []);
+  }
   // Colormap divergente (RdBu, coolwarm…): centrada en 0 si los datos lo cruzan; si no, en el medio.
   const cs = resolveColorScale(s.colorScale ?? s.cmap ?? s.colormap);
   if (cs && cs.kind === 'diverging' && s.midpoint === undefined && s.diverging === undefined) {
@@ -260,7 +270,7 @@ export function safePlot(spec) {
     // Se dibujó (con valores de respaldo), pero los errores de lint igual se devuelven: ok = sin errores.
     return { ok: report.errors.length === 0, svg, type: report.type, description: describeSvg(svg), errors: report.errors, warnings: report.warnings, suggestions: report.suggestions };
   } catch (e) {
-    const errors = report.errors.length ? report.errors : [{ code: 'render', message: e.message.split('\n')[0], fix: e.hint }];
+    const errors = report.errors.length ? report.errors : [{ code: 'render', message: e.message.split('\n')[0], fix: e.hint || 'Revisa los campos del spec contra el schema (`toolDefinition()`): textos donde van textos, listas donde van listas.' }];
     return { ok: false, svg: null, type: report.type, description: '', errors, warnings: report.warnings, suggestions: report.suggestions };
   }
 }
@@ -299,7 +309,7 @@ export function toHTML(specs, { title = 'Gráficos', lang = 'es', columns = 1 }
 ${[...new Set([FONT_CSS, ...list.map((s) => themeFor(withDefaults(s)).font?.import).filter(Boolean)])].map((u) => `<link rel="stylesheet" href="${esc(u)}">`).join('\n')}
 <style>
 :root{color-scheme:${dark ? 'dark' : 'light'}}
-body{margin:0;background:${bg};font-family:${esc(themeFor(withDefaults(list[0])).font?.family || "'Mozilla Text',system-ui,sans-serif")}}
+body{margin:0;background:${cssText(bg)};font-family:${cssText(themeFor(withDefaults(list[0])).font?.family || "'Mozilla Text',system-ui,sans-serif")}}
 main{max-width:${columns > 1 ? 1500 : 820}px;margin:0 auto;padding:24px 16px;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,${columns > 1 ? 560 : 320}px),1fr));gap:24px}
 figure.pa{margin:0;min-width:0}
 figure.pa svg{width:100%;height:auto;display:block}
@@ -311,6 +321,9 @@ ${boot}
 </body></html>`;
 }
 
+/** Texto dentro de <style>: las entidades HTML no se decodifican ahí (esc() rompería las comillas), así que se quitan los caracteres que cierran la regla o la etiqueta. */
+const cssText = (v) => String(v ?? '').replace(/[<>{};\\&]/g, '');
+
 /** Código de la biblioteca en un archivo (para incrustar en HTML). */
 export function bundleSource(file = 'plotagents.js') {
   try {
@@ -327,7 +340,7 @@ _bindDashboard({ plot, resolve, lint, bundleSource, resolveDefaults: withDefault
 _setProbe((s) => plot(s));
 export { render };
 
-export { countWords, dashboardSchema };
+export { countWords, dashboardSchema, detectLocale, correlations };
 export { resolveColorScale, colorScaleNames, interpolateColor, COLORMAPS, QUALITATIVE };
 export { dashboard, renderDashboard, planDashboard, lintDashboard, safeDashboard, mountDashboard, packRows, balancedRows };
 export { RENDERERS, ALIASES, registerGeo, getGeo, registeredGeo, toFeatureCollection, loadGeo };