@bicharts/chart-host 0.5.44 → 0.5.46

package/dist/{chunk-BMYEYUEN.mjs → chunk-FC3XJPVX.mjs}

@@ -433,20 +433,20 @@ function A3(n) {
   if (r && i && c3(r) !== i && (r = null), n.city !== void 0 && n.city !== null) {
     let a2 = u(String(n.city)), s = O(a2), f = s ? F(s, n.mapKind) : null;
     if (f && f.length) {
-      let d = n.state === void 0 || n.state === null ? "" : String(n.state).trim(), R = d ? u(d) : "", g = d ? Y(d) : null, S2 = [], m2 = -1;
+      let d = n.state === void 0 || n.state === null ? "" : String(n.state).trim(), R = d ? u(d) : "", g = d ? Y(d) : null, S = [], m2 = -1;
       for (let c of f) {
         let l = c.row, A = 0;
         if (d && l.a1 !== "") if (g && l.a1 === g || u(l.a1) === R) A++;
         else continue;
         if (i) if (T(l.cc) === i) A++;
         else continue;
-        A > m2 ? (m2 = A, S2 = [c]) : A === m2 && S2.push(c);
+        A > m2 ? (m2 = A, S = [c]) : A === m2 && S.push(c);
       }
-      S2.some((c) => c.primary) && (S2 = S2.filter((c) => c.primary));
+      S.some((c) => c.primary) && (S = S.filter((c) => c.primary));
       let p2 = /* @__PURE__ */ new Map();
-      for (let c of S2) p2.set(c.row.lon.toFixed(2) + "," + c.row.lat.toFixed(2), c.row);
+      for (let c of S) p2.set(c.row.lon.toFixed(2) + "," + c.row.lat.toFixed(2), c.row);
       if (p2.size === 1) {
-        let c = S2[0].row;
+        let c = S[0].row;
         return { lat: c.lat, lon: c.lon, precision: "city" };
       }
       if (p2.size > 1) return { ambiguous: true, matches: p2.size };
@@ -469,26 +469,26 @@ function A3(n) {
 var G = { latlon: 0, city: 1, zip3: 2, state: 3, country: 4 };
 var x = 8;
 function y3(n, e) {
-  let t = new Array(n.length), o = new Array(n.length), i = new Array(n.length), r = /* @__PURE__ */ new Set(), a2 = [], s = /* @__PURE__ */ new Set(), f = [], d = /* @__PURE__ */ new Set(), R = [], g = { latlon: 0, city: 0, zip3: 0, state: 0, country: 0 }, S2 = 0, m2 = 0, p2 = null;
+  let t = new Array(n.length), o = new Array(n.length), i = new Array(n.length), r = /* @__PURE__ */ new Set(), a2 = [], s = /* @__PURE__ */ new Set(), f = [], d = /* @__PURE__ */ new Set(), R = [], g = { latlon: 0, city: 0, zip3: 0, state: 0, country: 0 }, S = 0, m2 = 0, p2 = null;
   for (let l = 0; l < n.length; ++l) {
-    let A = n[l], C2 = A3({ ...A, mapKind: e });
-    if (S3(C2)) {
+    let A = n[l], C = A3({ ...A, mapKind: e });
+    if (S3(C)) {
       t[l] = null, o[l] = null, i[l] = null, m2++;
-      let M = K(A);
-      M && !d.has(M.toLowerCase()) && (d.add(M.toLowerCase()), R.length < x && R.push(M));
-    } else if (C2) {
-      if (t[l] = C2.lat, o[l] = C2.lon, i[l] = C2.precision, S2++, g[C2.precision]++, (p2 === null || G[C2.precision] > G[p2]) && (p2 = C2.precision), G[C2.precision] > G.city) {
-        let M = K(A);
-        M && !s.has(M.toLowerCase()) && (s.add(M.toLowerCase()), f.length < x && f.push(M));
+      let M2 = K(A);
+      M2 && !d.has(M2.toLowerCase()) && (d.add(M2.toLowerCase()), R.length < x && R.push(M2));
+    } else if (C) {
+      if (t[l] = C.lat, o[l] = C.lon, i[l] = C.precision, S++, g[C.precision]++, (p2 === null || G[C.precision] > G[p2]) && (p2 = C.precision), G[C.precision] > G.city) {
+        let M2 = K(A);
+        M2 && !s.has(M2.toLowerCase()) && (s.add(M2.toLowerCase()), f.length < x && f.push(M2));
       }
     } else {
       t[l] = null, o[l] = null, i[l] = null;
-      let M = K(A);
-      M && !r.has(M.toLowerCase()) && (r.add(M.toLowerCase()), a2.push(M));
+      let M2 = K(A);
+      M2 && !r.has(M2.toLowerCase()) && (r.add(M2.toLowerCase()), a2.push(M2));
     }
   }
   let c = !n3() && n.some((l) => l.city !== null && l.city !== void 0 && String(l.city).trim() !== "");
-  return { lat: t, lon: o, precisions: i, precision: p2, precisionCounts: g, coarseExamples: f, unmatched: a2, ambiguousRows: m2, ambiguousExamples: R, matchedRows: S2, totalRows: n.length, ...c ? { cityTableMissing: true } : {} };
+  return { lat: t, lon: o, precisions: i, precision: p2, precisionCounts: g, coarseExamples: f, unmatched: a2, ambiguousRows: m2, ambiguousExamples: R, matchedRows: S, totalRows: n.length, ...c ? { cityTableMissing: true } : {} };
 }
 function K(n) {
   let e = [n.city, n.state, n.zip, n.country].filter((t) => t != null && String(t).trim() !== "").map((t) => String(t).trim()).join(", ");
@@ -569,13 +569,13 @@ function wn(n) {
 }
 function Kn(n, s) {
   let i = new Array(n.length), r = /* @__PURE__ */ new Set(), A = [], y2 = 0;
-  for (let S2 = 0; S2 < n.length; ++S2) {
-    let O3 = hn(n[S2], s);
-    if (i[S2] = O3, O3 !== null) y2++;
+  for (let S = 0; S < n.length; ++S) {
+    let O2 = hn(n[S], s);
+    if (i[S] = O2, O2 !== null) y2++;
     else {
-      let C2 = n[S2];
-      if (C2 != null) {
-        let d = String(C2).trim();
+      let C = n[S];
+      if (C != null) {
+        let d = String(C).trim();
         if (d.length > 0) {
           let g = d.toLowerCase();
           r.has(g) || (r.add(g), A.push(d));
@@ -588,142 +588,211 @@ function Kn(n, s) {
 
 // ../shape-core/dist/index.mjs
 /*! @bicharts/shape-core — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; US Census/TIGER (public domain). Full text: NOTICE in this package. */
-var w = 2;
-var j2 = 400;
-function N2(r) {
-  return !!E(r);
-}
-function P2(r) {
-  let n = /* @__PURE__ */ new Set();
-  for (let e of r) {
-    if (e == null) continue;
-    let s = u(String(e));
-    if (!V(s) && !n.has(s) && (n.add(s), n.size >= j2)) break;
+var W2 = ["rate", "ratio", "pct", "percent", "percentage", "rating", "share", "score", "index", "nps", "csat", "margin", "yield", "coverage", "utilization", "z[_-]?score", "average", "avg", "mean", "median", "stddev", "variance", "gpa", "percentile", "quantile", "efficiency", "accuracy", "probability", "multiplier", "coefficient", "correlation", "occupancy", "age", "bmi", "temperature", "density", "pressure", "humidity", "ph", "velocity", "speed", "elevation", "altitude", "latency", "throughput", "bandwidth", "iops"];
+var X2 = ["pct", "percent", "percentage", "rate", "ratio", "rating", "share", "score", "index", "nps", "csat", "margin", "yield", "coverage", "utilization", "gpa", "percentile", "quantile", "bmi", "density", "pressure", "humidity", "velocity", "efficiency", "occupancy", "latency", "throughput", "bandwidth", "iops"];
+var Y2 = ["latitude", "longitude"];
+var J2 = ["latitude", "longitude"];
+var Q2 = /^\s*(sum|count|count\s+distinct|distinct\s+count)\s+of\s+/i;
+var Ut = /(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Za-z])(?=[0-9])|(?<=[0-9])(?=[A-Za-z])/g;
+var Zt = new RegExp("\\b(" + W2.join("|") + ")\\b|(" + X2.join("|") + ")$", "i");
+var qt = new RegExp("\\b(" + Y2.join("|") + ")\\b|(" + J2.join("|") + ")$", "i");
+function M(e) {
+  return e ? String(e).replace(Q2, "").trim() : "";
+}
+function tt(e) {
+  return !!e && Q2.test(String(e));
+}
+function jt(e) {
+  let t = M(e);
+  return t.length === 0 ? "" : t.replace(Ut, " ");
+}
+function et(e, t) {
+  return t ? e.test(jt(t)) || e.test(M(t)) : false;
+}
+function L2(e) {
+  return et(qt, e);
+}
+function nt(e) {
+  return et(Zt, e) || L2(e);
+}
+var it = /int|double|decimal|single|float|number|currency|money/i;
+function Wt(e) {
+  let t = String(e?.valueNature ?? "").trim().toLowerCase();
+  return t === "categorical" ? "Categorical" : t === "ordinal" ? "Ordinal" : t === "continuous" || e?.isMeasure === true || it.test(String(e?.dataType ?? "")) ? "Continuous" : "Categorical";
+}
+function Xt(e) {
+  return e?.isMeasure === true || it.test(String(e?.dataType ?? ""));
+}
+function z2(e) {
+  let t = e ?? {}, i = Wt(t);
+  if (i !== "Continuous") return { nature: i, additivity: "unknown", basis: "role", suppressed: false };
+  if (L2(t.name)) return { nature: i, additivity: "positional", basis: "name", suppressed: true };
+  let r = String(t.additivity ?? "").trim().toLowerCase();
+  if (!(r === "additive" && tt(t.name))) {
+    if (r === "additive") return { nature: i, additivity: "additive", basis: "measured", suppressed: false };
+    if (r === "part_of_whole") return { nature: i, additivity: "part_of_whole", basis: "measured", suppressed: false };
+    if (r === "intensive_rate") return { nature: i, additivity: "intensive_rate", basis: "measured", suppressed: false };
   }
-  return Array.from(n);
-}
-function C(r) {
-  let n = P2(r);
-  if (n.length === 0 || E2(r) < 95) return false;
-  let e = n.filter((l) => N2(l) && !Y(l)).length, s = n.filter((l) => !N2(l) && !!Y(l)).length;
-  return e >= 1 && e >= s;
-}
-function q2(r, n) {
-  if (!Y(r)) return false;
-  let e = E(r);
-  return e ? n === "world" ? true : s3.has(e) : false;
-}
-function E2(r) {
-  let n = P2(r);
-  if (n.length === 0) return 0;
-  let e = 0;
-  for (let s of n) N2(s) && e++;
-  return Math.round(e / n.length * 1e3) / 10;
-}
-function S(r) {
-  let n = P2(r);
-  if (n.length === 0) return 0;
-  let e = 0;
-  for (let s of n) Y(s) && e++;
-  return Math.round(e / n.length * 1e3) / 10;
-}
-function D2(r) {
-  let n = /* @__PURE__ */ new Set();
-  for (let e of r) {
-    if (e == null) continue;
-    let s = String(e).trim();
-    if (!V(u(s)) && !n.has(s) && (n.add(s), n.size >= j2)) break;
+  return t.discourageAggregationAcrossGroups === true ? { nature: i, additivity: "intensive_rate", basis: "host-flag", suppressed: false } : nt(t.name) ? { nature: i, additivity: "intensive_rate", basis: "name", suppressed: false } : { nature: i, additivity: "additive", basis: "default", suppressed: false };
+}
+function G2(e) {
+  let t = z2(e), i = e ?? {};
+  if (t.nature === "Categorical") return ["first", "distinctcount", "count"];
+  if (t.nature === "Ordinal") return Xt(i) ? ["median", "min", "max", "first", "distinctcount", "count"] : ["first", "distinctcount", "count"];
+  switch (t.additivity) {
+    case "positional":
+      return ["min", "max", "count", "distinctcount", "first"];
+    case "intensive_rate":
+      return ["average", "median", "min", "max", "count", "distinctcount", "first"];
+    default:
+      return ["sum", "average", "median", "min", "max", "count", "distinctcount", "first"];
   }
-  return Array.from(n);
-}
-function O2(r) {
-  let n = D2(r);
-  if (n.length === 0) return 0;
-  let e = 0;
-  for (let s of n) Z(s).length > 0 && e++;
-  return Math.round(e / n.length * 1e3) / 10;
-}
-function Z2(r, n) {
-  return p(n, en) ? true : D2(r).some((e) => /^\d{5}(-\d{4})?$/.test(e.replace(/\.0+$/, "")));
-}
-function Gt(r, n) {
-  let e = P2(r);
-  if (e.length === 0) return 0;
-  let s = 0;
-  for (let l of e) p3(l, n) && s++;
-  return Math.round(s / e.length * 1e3) / 10;
-}
-function $2(r, n) {
-  let e = 0;
-  for (let s of P2(r)) n(s) && e++;
-  return e;
-}
-function _t(r, n) {
-  let e = 0;
-  for (let s of D2(r)) n(s) && e++;
-  return e;
 }
-function wt(r, n, e, s) {
-  let l = [], c = [], o = {}, v2 = {}, k2 = new Set(r), u2 = (t) => n.map((i) => i[t]);
-  for (let t of ["city", "lat", "lon", "country"]) {
-    let i = e?.[t];
-    i && k2.has(i) && (o[t] = i);
+function Yt(e) {
+  return G2(e)[0];
+}
+function Qt(e, t) {
+  if (t !== "sum" && t !== "count") return false;
+  if (t === "count") return true;
+  let i = z2(e);
+  return i.additivity === "additive" || i.additivity === "part_of_whole" || i.additivity === "unknown";
+}
+var F2 = 2;
+var st = 400;
+function D2(e) {
+  return !!E(e);
+}
+function v2(e) {
+  let t = /* @__PURE__ */ new Set();
+  for (let i of e) {
+    if (i == null) continue;
+    let r = u(String(i));
+    if (!V(r) && !t.has(r) && (t.add(r), t.size >= st)) break;
+  }
+  return Array.from(t);
+}
+function h2(e) {
+  let t = v2(e);
+  if (t.length === 0 || K2(e) < 95) return false;
+  let i = t.filter((u2) => D2(u2) && !Y(u2)).length, r = t.filter((u2) => !D2(u2) && !!Y(u2)).length;
+  return i >= 1 && i >= r;
+}
+function ot(e, t) {
+  if (!Y(e)) return false;
+  let i = E(e);
+  return i ? t === "world" ? true : s3.has(i) : false;
+}
+function K2(e) {
+  let t = v2(e);
+  if (t.length === 0) return 0;
+  let i = 0;
+  for (let r of t) D2(r) && i++;
+  return Math.round(i / t.length * 1e3) / 10;
+}
+function P2(e) {
+  let t = v2(e);
+  if (t.length === 0) return 0;
+  let i = 0;
+  for (let r of t) Y(r) && i++;
+  return Math.round(i / t.length * 1e3) / 10;
+}
+function H2(e) {
+  let t = /* @__PURE__ */ new Set();
+  for (let i of e) {
+    if (i == null) continue;
+    let r = String(i).trim();
+    if (!V(u(r)) && !t.has(r) && (t.add(r), t.size >= st)) break;
+  }
+  return Array.from(t);
+}
+function B2(e) {
+  let t = H2(e);
+  if (t.length === 0) return 0;
+  let i = 0;
+  for (let r of t) Z(r).length > 0 && i++;
+  return Math.round(i / t.length * 1e3) / 10;
+}
+function rt(e, t) {
+  return p(t, en) ? true : H2(e).some((i) => /^\d{5}(-\d{4})?$/.test(i.replace(/\.0+$/, "")));
+}
+function te(e, t) {
+  let i = v2(e);
+  if (i.length === 0) return 0;
+  let r = 0;
+  for (let u2 of i) p3(u2, t) && r++;
+  return Math.round(r / i.length * 1e3) / 10;
+}
+function $2(e, t) {
+  let i = 0;
+  for (let r of v2(e)) t(r) && i++;
+  return i;
+}
+function ee(e, t) {
+  let i = 0;
+  for (let r of H2(e)) t(r) && i++;
+  return i;
+}
+function ne(e, t, i, r) {
+  let u2 = [], c = [], o = {}, I2 = {}, R = new Set(e), l = (n) => t.map((s) => s[n]);
+  for (let n of ["city", "lat", "lon", "country"]) {
+    let s = i?.[n];
+    s && R.has(s) && (o[n] = s);
   }
-  let y2 = e?.zip;
-  if (y2 && k2.has(y2)) {
-    let t = u2(y2), i = O2(t);
-    i < 95 ? c.push(`zip=${y2} (only ${i}% of values read as ZIPs)`) : Z2(t, y2) ? o.zip = y2 : c.push(`zip=${y2} (all values are 3-4 digits with nothing to say they are postal)`);
+  let p2 = i?.zip;
+  if (p2 && R.has(p2)) {
+    let n = l(p2), s = B2(n);
+    s < 95 ? c.push(`zip=${p2} (only ${s}% of values read as ZIPs)`) : rt(n, p2) ? o.zip = p2 : c.push(`zip=${p2} (all values are 3-4 digits with nothing to say they are postal)`);
   }
-  let m2 = e?.state;
-  if (m2 && k2.has(m2)) {
-    let t = u2(m2), i = P2(t);
-    i.length > 0 && i.every((a2) => q2(a2, s)) ? c.push(`state=${m2} (every value is "CA", which is both Canada and California)`) : C(t) ? (c.push(`state=${m2} (every value is a country, not a state)`), o.country || (o.country = m2)) : S(t) < 95 ? c.push(`state=${m2} (only ${S(t)}% of values are states/provinces)`) : o.state = m2;
+  let f = i?.state;
+  if (f && R.has(f)) {
+    let n = l(f), s = v2(n);
+    s.length > 0 && s.every((a2) => ot(a2, r)) ? c.push(`state=${f} (every value is "CA", which is both Canada and California)`) : h2(n) ? (c.push(`state=${f} (every value is a country, not a state)`), o.country || (o.country = f)) : P2(n) < 95 ? c.push(`state=${f} (only ${P2(n)}% of values are states/provinces)`) : o.state = f;
   }
-  let d = new Set(Object.values(o).filter(Boolean)), x2 = r.filter((t) => !d.has(t) && !t.startsWith("__"));
+  let m2 = new Set(Object.values(o).filter(Boolean)), x2 = e.filter((n) => !m2.has(n) && !n.startsWith("__"));
   if (!o.state) {
-    let t = null;
-    for (let i of x2) {
-      let a2 = u2(i);
-      if (C(a2)) continue;
-      let f = S(a2);
-      if (f < 95) continue;
-      let z2 = $2(a2, (b2) => !!Y(b2)), W2 = $2(a2, (b2) => !!Y(b2) && !q2(b2, s));
-      z2 < w && W2 < 1 || (!t || f > t.pct) && (t = { name: i, pct: f });
+    let n = null;
+    for (let s of x2) {
+      let a2 = l(s);
+      if (h2(a2)) continue;
+      let d = P2(a2);
+      if (d < 95) continue;
+      let E2 = $2(a2, (C) => !!Y(C)), ut = $2(a2, (C) => !!Y(C) && !ot(C, r));
+      E2 < F2 && ut < 1 || (!n || d > n.pct) && (n = { name: s, pct: d });
     }
-    t && (o.state = t.name, d.add(t.name), l.push(`state=${t.name} (${t.pct}% states/provinces)`));
+    n && (o.state = n.name, m2.add(n.name), u2.push(`state=${n.name} (${n.pct}% states/provinces)`));
   }
-  if (!o.zip) for (let t of x2) {
-    if (d.has(t)) continue;
-    let i = u2(t), a2 = O2(i);
-    if (!(a2 < 95) && Z2(i, t) && !(_t(i, (f) => Z(f).length > 0) < w)) {
-      o.zip = t, d.add(t), l.push(`zip=${t} (${a2}% ZIP codes)`);
+  if (!o.zip) for (let n of x2) {
+    if (m2.has(n)) continue;
+    let s = l(n), a2 = B2(s);
+    if (!(a2 < 95) && rt(s, n) && !(ee(s, (d) => Z(d).length > 0) < F2)) {
+      o.zip = n, m2.add(n), u2.push(`zip=${n} (${a2}% ZIP codes)`);
       break;
     }
   }
-  let h2 = o.country;
-  if (!h2 || !C(u2(h2))) {
-    let t = null;
-    for (let i of x2) {
-      if (d.has(i) || !C(u2(i))) continue;
-      let a2 = E2(u2(i));
-      (!t || a2 > t.pct) && (t = { name: i, pct: a2 });
+  let A = o.country;
+  if (!A || !h2(l(A))) {
+    let n = null;
+    for (let s of x2) {
+      if (m2.has(s) || !h2(l(s))) continue;
+      let a2 = K2(l(s));
+      (!n || a2 > n.pct) && (n = { name: s, pct: a2 });
     }
-    t && (h2 && (c.push(`country=${h2} (only ${E2(u2(h2))}% of values are country identifiers; using ${t.name} instead)`), v2.country = h2), o.country = t.name, d.add(t.name), l.push(`country=${t.name}`));
+    n && (A && (c.push(`country=${A} (only ${K2(l(A))}% of values are country identifiers; using ${n.name} instead)`), I2.country = A), o.country = n.name, m2.add(n.name), u2.push(`country=${n.name}`));
   }
   if (!o.city) {
-    let t = null;
-    for (let i of x2) {
-      if (d.has(i)) continue;
-      let a2 = u2(i), f = Gt(a2, s);
-      f < m3 || $2(a2, (z2) => p3(z2, s)) < w || (!t || f > t.pct) && (t = { name: i, pct: f });
+    let n = null;
+    for (let s of x2) {
+      if (m2.has(s)) continue;
+      let a2 = l(s), d = te(a2, r);
+      d < m3 || $2(a2, (E2) => p3(E2, r)) < F2 || (!n || d > n.pct) && (n = { name: s, pct: d });
     }
-    t && (o.city = t.name, l.push(`city=${t.name} (${t.pct}% known cities)`));
+    n && (o.city = n.name, u2.push(`city=${n.name} (${n.pct}% known cities)`));
   }
-  let B2 = o.country ? u2(o.country) : [], I2 = !!o.country && C(B2), U2 = I2 ? new Set(B2.map((t) => E(t == null ? null : String(t))).filter(Boolean)).size : 0, F2 = I2 && U2 >= 2, L2 = !!(o.lat && o.lon) && n.some((t) => {
-    let i = +String(t[o.lat] ?? "").trim(), a2 = +String(t[o.lon] ?? "").trim();
-    return isFinite(i) && isFinite(a2) && i >= -90 && i <= 90 && a2 >= -180 && a2 <= 180 && String(t[o.lat] ?? "").trim() !== "" && String(t[o.lon] ?? "").trim() !== "";
+  let V2 = o.country ? l(o.country) : [], N2 = !!o.country && h2(V2), at = N2 ? new Set(V2.map((n) => E(n == null ? null : String(n))).filter(Boolean)).size : 0, U2 = N2 && at >= 2, O2 = !!(o.lat && o.lon) && t.some((n) => {
+    let s = +String(n[o.lat] ?? "").trim(), a2 = +String(n[o.lon] ?? "").trim();
+    return isFinite(s) && isFinite(a2) && s >= -90 && s <= 90 && a2 >= -180 && a2 <= 180 && String(n[o.lat] ?? "").trim() !== "" && String(n[o.lon] ?? "").trim() !== "";
   });
-  return o.lat && o.lon && !L2 && c.push(`lat/lon=${o.lat}/${o.lon} (no row holds a usable coordinate pair)`), o.country && !F2 && !(o.city || o.state || o.zip || L2) && c.push(I2 ? `country=${o.country} (every row resolves to the same country - nothing to place apart)` : `country=${o.country} (values are not country identifiers)`), { bind: !!(o.city || o.state || o.zip || F2 || L2) ? o : null, backfilled: l, refused: c, ...Object.keys(v2).length ? { labelFallback: v2 } : {} };
+  return o.lat && o.lon && !O2 && c.push(`lat/lon=${o.lat}/${o.lon} (no row holds a usable coordinate pair)`), o.country && !U2 && !(o.city || o.state || o.zip || O2) && c.push(N2 ? `country=${o.country} (every row resolves to the same country - nothing to place apart)` : `country=${o.country} (values are not country identifiers)`), { bind: !!(o.city || o.state || o.zip || U2 || O2) ? o : null, backfilled: u2, refused: c, ...Object.keys(I2).length ? { labelFallback: I2 } : {} };
 }
 
 // src/payload.ts
@@ -738,7 +807,7 @@ function resolvePointChannel(cols, rowObjs, point) {
   let labelCol;
   if (bind) {
     const dims = cols.filter((c) => !c.isMeasure).map((c) => c.name);
-    const res = wt(dims, rowObjs, bind, point?.mapKind);
+    const res = ne(dims, rowObjs, bind, point?.mapKind);
     bind = res.bind;
     rolesBackfilled = res.backfilled;
     rolesRefused = res.refused;
@@ -806,11 +875,11 @@ function buildRenderPayload(cols, rowObjs, geo, point, destination) {
     const row = rowObjs[r];
     const a2 = new Array(cols.length + extra);
     for (let c = 0; c < cols.length; c++) {
-      const v2 = row[colNames[c]];
-      if (v2 instanceof Date) {
-        a2[c] = v2.toISOString();
+      const v3 = row[colNames[c]];
+      if (v3 instanceof Date) {
+        a2[c] = v3.toISOString();
       } else {
-        a2[c] = v2 ?? null;
+        a2[c] = v3 ?? null;
       }
     }
     let k2 = cols.length;
@@ -862,8 +931,8 @@ function buildRenderPayload(cols, rowObjs, geo, point, destination) {
 function createMarkResolver(env) {
   const { root, doc, log } = env;
   const isElement = (t) => {
-    const E4 = doc?.defaultView?.Element ?? globalThis.Element;
-    if (E4 && t instanceof E4) return true;
+    const E2 = doc?.defaultView?.Element ?? globalThis.Element;
+    if (E2 && t instanceof E2) return true;
     return !!t && typeof t.closest === "function" && typeof t.getAttribute === "function";
   };
   const viewStyle = (n) => {
@@ -883,14 +952,14 @@ function createMarkResolver(env) {
     return s === "transparent" || s === "none" || so <= 0.01;
   };
   const distToPathCenterline = (el, x2, y2) => {
-    const L2 = el.getTotalLength();
-    if (!(L2 > 0)) return Number.MAX_VALUE;
+    const L4 = el.getTotalLength();
+    if (!(L4 > 0)) return Number.MAX_VALUE;
     const m2 = el.getScreenCTM();
     if (!m2) return Number.MAX_VALUE;
     let best = Number.MAX_VALUE;
-    const N3 = 64;
-    for (let i = 0; i <= N3; i++) {
-      const pt = el.getPointAtLength(L2 * i / N3);
+    const N2 = 64;
+    for (let i = 0; i <= N2; i++) {
+      const pt = el.getPointAtLength(L4 * i / N2);
       const dx = m2.a * pt.x + m2.c * pt.y + m2.e - x2;
       const dy = m2.b * pt.x + m2.d * pt.y + m2.f - y2;
       const d = dx * dx + dy * dy;
@@ -1086,6 +1155,42 @@ function ensureCrossfilterHitTargets(container, doc) {
   return report;
 }
 
+// src/blankRender.ts
+var EMPTY = { markCount: 0, legendMarkCount: 0, containerKind: "empty" };
+function censusMarks(container) {
+  if (!container || typeof container.querySelectorAll !== "function") return EMPTY;
+  try {
+    const marks = /* @__PURE__ */ new Set();
+    for (const el of Array.from(container.querySelectorAll(`.${MARK_CLASS}`))) marks.add(el);
+    for (const el of Array.from(container.querySelectorAll(`[${ROW_IDX_ATTR}]`))) marks.add(el);
+    const legend = /* @__PURE__ */ new Set();
+    for (const el of Array.from(container.querySelectorAll(`.${LEGEND_MARK_CLASS}`))) {
+      legend.add(el);
+      marks.delete(el);
+    }
+    const hasSvg = !!container.querySelector("svg");
+    const hasAnything = hasSvg || (container.childElementCount ?? 0) > 0;
+    return {
+      markCount: marks.size,
+      legendMarkCount: legend.size,
+      containerKind: hasSvg ? "svg" : hasAnything ? "html" : "empty"
+    };
+  } catch {
+    return EMPTY;
+  }
+}
+function isBlankRender(i) {
+  if (i.contractUntagged) return false;
+  if (i.animated) return false;
+  if (i.authoredNoDataText) return false;
+  if (!(i.rows > 0)) return false;
+  return i.markCount === 0;
+}
+function blankRenderFlag(lang, cause) {
+  const clean = (s) => String(s || "unknown").toLowerCase().replace(/[^a-z0-9-]+/g, "-");
+  return `blankrender:${clean(lang)}:${clean(cause)}`;
+}
+
 // src/host.ts
 var parseRowIdxs = (s) => (s || "").split(",").map((x2) => parseInt(x2, 10)).filter((n) => Number.isFinite(n));
 var D3_PLUGIN_PACKAGES = {
@@ -1158,7 +1263,7 @@ function createChartHost(container, config) {
   let data = config.data;
   {
     const stamped = config.data?.meta?.hostContract;
-    const major = (v2) => (v2 || "").split(".")[0];
+    const major = (v3) => (v3 || "").split(".")[0];
     if (stamped && major(stamped) !== major(HOST_CONTRACT_VERSION)) {
       try {
         (win?.console ?? console)?.warn(
@@ -1186,6 +1291,7 @@ function createChartHost(container, config) {
   let renderFn = config.renderFn ?? null;
   let destroyed = false;
   let warnedGeo = false;
+  let warnedBlank = false;
   let current = null;
   let activeTickEl = null;
   let selectionIsPeriod = false;
@@ -1193,9 +1299,9 @@ function createChartHost(container, config) {
   const ensureAffordanceStyles = () => {
     try {
       if (!doc || doc.getElementById("bic-chart-host-affordances")) return;
-      const st = doc.createElement("style");
-      st.id = "bic-chart-host-affordances";
-      st.textContent = `
+      const st2 = doc.createElement("style");
+      st2.id = "bic-chart-host-affordances";
+      st2.textContent = `
 /* TYPOGRAPHY FIREWALL. Generated charts set font-size but almost never line-height or
    letter-spacing, so they INHERIT whatever the host page cascades in. A page with
    \`:root { font: 18px/145% }\` (the stock Vite template does exactly this) hands every
@@ -1233,7 +1339,7 @@ function createChartHost(container, config) {
     font-weight: 700 !important;
     text-decoration: underline !important;
 }`;
-      (doc.head || doc.documentElement)?.appendChild(st);
+      (doc.head || doc.documentElement)?.appendChild(st2);
     } catch {
     }
   };
@@ -1353,6 +1459,27 @@ function createChartHost(container, config) {
       }
       ensureCrossfilterHitTargets(container, doc);
       paintSelection();
+      try {
+        const census = censusMarks(container);
+        if (isBlankRender({
+          markCount: census.markCount,
+          rows: data.rows ? data.rows.length : 0,
+          animated: config.animated,
+          contractUntagged: config.contractUntagged
+        })) {
+          if (!warnedBlank) {
+            warnedBlank = true;
+            try {
+              (win?.console ?? console)?.warn(
+                `[@bicharts/chart-host] this chart rendered without error but painted no data marks, against ${data.rows.length} row(s) \u2014 so the container is empty. The usual cause is that the generated code binds a column BY NAME that is no longer in the data, sending it down its own "no data" branch. Check that the columns in your table still match the ones the chart was generated for.`
+              );
+            } catch {
+            }
+          }
+          config.onBlankRender?.({ census, rows: data.rows ? data.rows.length : 0 });
+        }
+      } catch {
+      }
     },
     setOptions(partial) {
       raw = { ...raw, ...partial };
@@ -1445,9 +1572,16 @@ export {
   registerGeoAsset,
   clearGeoCache,
   L3,
+  z2 as z,
+  G2 as G,
+  Yt,
+  Qt,
   buildRenderPayload,
   createMarkResolver,
   ensureCrossfilterHitTargets,
+  censusMarks,
+  isBlankRender,
+  blankRenderFlag,
   requiredD3Plugins,
   explainRenderFailure,
   stripEsmExports,

package/dist/index.mjs

@@ -20,6 +20,7 @@ import {
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
   FLIP_MODE_DEFAULT,
+  G,
   GEO_POINT_PRECISIONS,
   HOST_CONTAINER_CLASS,
   HOST_CONTRACT_VERSION,
@@ -27,10 +28,14 @@ import {
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   MARK_SELECTED_CLASS,
+  Qt,
   ROW_IDX_ATTR,
   SELECTION_ACTIVE_CLASS,
   XFILTER_REFRESH_EVENT,
+  Yt,
+  blankRenderFlag,
   buildRenderPayload,
+  censusMarks,
   chartOwnsTimeline,
   clearGeoCache,
   compileRenderFn,
@@ -40,14 +45,16 @@ import {
   explainRenderFailure,
   geoAssetFor,
   geoFromCache,
+  isBlankRender,
   loadGeo,
   periodTickSuppressesFeedback,
   registerGeo,
   registerGeoAsset,
   requiredD3Plugins,
   resolveOptions,
-  stripEsmExports
-} from "./chunk-BMYEYUEN.mjs";
+  stripEsmExports,
+  z
+} from "./chunk-FC3XJPVX.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/trivial.ts
@@ -622,9 +629,6 @@ function normaliseAggregation(raw) {
   if (/^(distinctcount|dcount|countdistinct|uniques?)$/.test(s)) return "distinctcount";
   return "sum";
 }
-function isAdditive(agg) {
-  return agg === "sum" || agg === "count";
-}
 function aggLabel(agg) {
   switch (agg) {
     case "average":
@@ -651,6 +655,20 @@ function isMeasureColumn(col) {
   if (col.isMeasure === true) return true;
   return NUMERIC_DATATYPE.test(String(col.dataType ?? ""));
 }
+function isRealColumn(col) {
+  return !!col && !isSynthetic(col.name);
+}
+function isSuppressed(col) {
+  return z(col).suppressed;
+}
+function resolveAgg(col, requested, auto) {
+  const fallback = () => {
+    const d = Yt(col);
+    return d === "first" ? "count" : d;
+  };
+  if (auto) return fallback();
+  return G(col).indexOf(requested) >= 0 ? requested : fallback();
+}
 function toNumber(v) {
   if (v == null || v === "") return null;
   const n = typeof v === "number" ? v : Number(v);
@@ -706,9 +724,11 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
     if (pos != null && pos >= 0 && pos < rows.length) positions.push(pos);
   }
   if (!positions.length) return null;
+  const auto = String(opts.aggregation ?? "").trim().length === 0;
   const agg = normaliseAggregation(opts.aggregation);
   const maxMeasures = opts.maxMeasures ?? 4;
   const maxHeaderValues = opts.maxHeaderValues ?? 3;
+  const maxDimensions = opts.maxDimensions ?? 2;
   const dimIdx = columns.findIndex((c) => c && !isSynthetic(c.name) && !isMeasureColumn(c));
   let header;
   if (dimIdx >= 0) {
@@ -728,10 +748,20 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
     header = `${positions.length} mark${positions.length === 1 ? "" : "s"}`;
   }
   const measureCols = [];
-  for (let c = 0; c < columns.length; c++) if (isMeasureColumn(columns[c])) measureCols.push(c);
+  const suppressedColumns = [];
+  for (let c = 0; c < columns.length; c++) {
+    if (!isMeasureColumn(columns[c])) continue;
+    if (isSuppressed(columns[c])) {
+      suppressedColumns.push(String(columns[c]?.name ?? ""));
+      continue;
+    }
+    measureCols.push(c);
+  }
   const shown = measureCols.slice(0, maxMeasures);
   const lines = [];
   for (const c of shown) {
+    const col = columns[c];
+    const colAgg = resolveAgg(col, agg, auto);
     const selVals = [];
     const selRaw = [];
     for (const p of positions) {
@@ -739,9 +769,9 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
       selRaw.push(rows[p]?.[c]);
       if (n != null) selVals.push(n);
     }
-    const value = reduce(selVals, agg, selRaw);
+    const value = reduce(selVals, colAgg, selRaw);
     let sharePct = null;
-    if (isAdditive(agg) && value != null) {
+    if (Qt(col, colAgg) && value != null) {
       const allVals = [];
       const allRaw = [];
       for (let r = 0; r < rows.length; r++) {
@@ -749,21 +779,49 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
         allRaw.push(rows[r]?.[c]);
         if (n != null) allVals.push(n);
       }
-      const total = reduce(allVals, agg, allRaw);
+      const total = reduce(allVals, colAgg, allRaw);
       if (total != null && total > 0) sharePct = value / total * 100;
     }
     lines.push({
-      column: String(columns[c]?.name ?? ""),
-      label: `${aggLabel(agg)} of ${columns[c]?.name ?? ""}`,
+      column: String(col?.name ?? ""),
+      label: `${aggLabel(colAgg)} of ${col?.name ?? ""}`,
       value,
       valueText: value == null ? "\u2014" : fmtNumber(value, opts.cultureCode),
       sharePct,
-      shareText: sharePct == null ? "" : `${sharePct < 0.1 ? "<0.1" : sharePct.toFixed(1)}% of total`
+      shareText: sharePct == null ? "" : `${sharePct < 0.1 ? "<0.1" : sharePct.toFixed(1)}% of total`,
+      aggregation: colAgg
+    });
+  }
+  const dimensionLines = [];
+  for (let c = 0; c < columns.length && dimensionLines.length < maxDimensions; c++) {
+    if (c === dimIdx) continue;
+    if (!isRealColumn(columns[c]) || isMeasureColumn(columns[c])) continue;
+    const name = String(columns[c]?.name ?? "");
+    const distinct = /* @__PURE__ */ new Set();
+    let firstText = "";
+    for (const p of positions) {
+      const raw = rows[p]?.[c];
+      const s = raw == null || raw === "" ? "(blank)" : String(raw);
+      if (!distinct.size) firstText = s;
+      distinct.add(s);
+    }
+    if (!distinct.size) continue;
+    const single = distinct.size === 1;
+    dimensionLines.push({
+      column: name,
+      label: single ? name : `Distinct ${name}`,
+      value: single ? null : distinct.size,
+      valueText: single ? firstText : fmtNumber(distinct.size, opts.cultureCode),
+      sharePct: null,
+      shareText: "",
+      aggregation: single ? "first" : "distinctcount"
     });
   }
   return {
     header,
     lines,
+    dimensionLines,
+    suppressedColumns,
     rowsText: `${positions.length} of ${rows.length} rows`,
     selectedRows: positions.length,
     totalRows: rows.length,
@@ -811,10 +869,12 @@ export {
   actionFor,
   askApplyImprovements,
   bareBase64,
+  blankRenderFlag,
   buildRenderPayload,
   buildReviewWire,
   canConfirmLaunch,
   captureSvgSnapshot,
+  censusMarks,
   chartOwnsTimeline,
   chooserFitsViewport,
   clearGeoCache,
@@ -828,6 +888,7 @@ export {
   explainRenderFailure,
   geoAssetFor,
   geoFromCache,
+  isBlankRender,
   launchFavorStyle,
   launchGenerates,
   loadGeo,

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-BMYEYUEN.mjs";
+} from "./chunk-FC3XJPVX.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/react.tsx

package/dist/types/blankRender.d.ts

@@ -0,0 +1,60 @@
+export interface MarkCensus {
+    /** Data marks found anywhere in the container. */
+    markCount: number;
+    /** Legend swatches / axis furniture — clickable, but NOT evidence the data drew. */
+    legendMarkCount: number;
+    /** What the chart built. `html` is a first-class answer, not a failure — see below. */
+    containerKind: "svg" | "html" | "empty";
+}
+/**
+ * Count what the render actually left behind.
+ *
+ * NOT SCOPED TO `<svg>`, and that is what makes this work at all. Plenty of chart types are pure
+ * HTML - a table with embedded bars, a KPI card - and never create an SVG, so a census that
+ * starts from `container.querySelector("svg")` finds nothing for exactly the charts it most needs
+ * to measure. Those charts still honour the contract: their working path tags each row
+ * `class="d3-mark"` + `data-row-idx`, and their no-data branch appends a bare element with
+ * neither. The class and the attribute ARE the signal, in both DOM worlds; the element name never
+ * was.
+ *
+ * Counts by contract, never by tag: a chart marking `<rect>`, `<text>`, `<path>`, `<circle>` or
+ * `<div>` is equally visible here. Never throws — telemetry must not be why a delivered render
+ * fails.
+ */
+export declare function censusMarks(container: Element | null | undefined): MarkCensus;
+export interface BlankVerdictInput {
+    /** From censusMarks. */
+    markCount: number;
+    /** Rows the chart was HANDED. Zero rows is a different, already-handled story. */
+    rows: number;
+    /**
+     * This chart declares time keyframes. Its first frame is legitimately allowed to be empty
+     * (an animated map before any country enters the series), so a verdict on frame one would be
+     * a lie about the commonest animated opening.
+     */
+    animated?: boolean;
+    /**
+     * The author configured their own "No Data Text". They asked for this rectangle to say
+     * something when there is nothing to draw, and overruling them would be telling someone their
+     * deliberate empty state is a defect.
+     */
+    authoredNoDataText?: boolean;
+    /**
+     * The chart's marks are not tagged by our contract at all — a Vega lane, whose marks the
+     * generated spec names itself. Absence of `.d3-mark` there proves nothing, so the census is
+     * evidence-free and must not return a verdict.
+     */
+    contractUntagged?: boolean;
+}
+/**
+ * Did this render paint nothing, against data that had something to paint?
+ *
+ * EVERY CLAUSE IS A FALSE POSITIVE WE WOULD OTHERWISE SHIP. The value of this verdict is that a
+ * human believes it; one wrong accusation on a chart that is fine costs more than the case it
+ * catches, which is the same argument `columnsGoneFromDiff` makes about type narrowings.
+ */
+export declare function isBlankRender(i: BlankVerdictInput): boolean;
+/** A short, stable token a host can attach to its own per-render telemetry. Deliberately
+ *  formatted for an always-on channel rather than a debug log: a blank render is most
+ *  interesting in aggregate, and the charts worth counting are the ones nobody is watching. */
+export declare function blankRenderFlag(lang: string, cause: string): string;

package/dist/types/host.d.ts

@@ -1,5 +1,6 @@
 import { type RenderOptions } from "./contract";
 import { type ResolveOptionsInput } from "./defaults";
+import { type MarkCensus } from "./blankRender";
 export type RenderFn = (container: HTMLElement, data: any, options: RenderOptions) => void;
 export interface ChartHostConfig {
     data: {
@@ -36,6 +37,26 @@ export interface ChartHostConfig {
      *  already holds its assets (e.g. `geoForKind` from "@bicharts/chart-host/geo", or the
      *  data.geo.json the MCP wrote next to the chart). */
     geoProvider?: (geoKind: string) => any | undefined;
+    /**
+     * Called when a render completes cleanly having painted NO data marks against a non-empty
+     * table (2026-09-01). The chart did not throw, so nothing else will tell you — this is
+     * the only notification that the rectangle your reader is looking at is empty.
+     *
+     * The commonest cause by far is schema drift: generated code binds columns BY NAME, so a
+     * renamed or removed field sends its own `findIndex(...) === -1` guard down the no-data
+     * branch. A host that knows the binding can say WHICH column; one that does not should still
+     * surface it, because "empty and silent" is the state this exists to abolish.
+     */
+    onBlankRender?: (info: {
+        census: MarkCensus;
+        rows: number;
+    }) => void;
+    /** This chart declares time keyframes: frame one is allowed to be empty, so no blank verdict
+     *  is issued for it. */
+    animated?: boolean;
+    /** The chart's marks are not tagged with the shared contract (a Vega lane names its own
+     *  marks), so a mark count proves nothing and the blank verdict is suppressed. */
+    contractUntagged?: boolean;
 }
 export interface ChartHost {
     render(): void;

package/dist/types/index.d.ts

@@ -15,3 +15,4 @@ export { qualifyGroupHeadingFor, newQualifyGroupState, type QualifyGroupRow, typ
 export { qualifyPick, qualifyAuto, qualifyCancel, launchGenerates, launchFavorStyle, chooserFitsViewport, shouldOpenChooserOnGenerate, shouldOpenInlineChooserOnGenerate, canConfirmLaunch, confirmLaunch, qualifyFailureFallsOpen, CHOOSER_MIN_WIDTH_PX, CHOOSER_MIN_HEIGHT_PX, type QualifyLaunchOutcome, type ChooserGateInput, } from "./qualifyLaunch";
 export { computeSelectionCard, normaliseAggregation, type SelectionCardModel, type SelectionCardLine, type SelectionCardOptions, } from "./selectionCard";
 export { ensureCrossfilterHitTargets, type HitTargetReport } from "./hitTargets";
+export { censusMarks, isBlankRender, blankRenderFlag, type MarkCensus, type BlankVerdictInput } from "./blankRender";

package/dist/types/selectionCard.d.ts

@@ -1,7 +1,16 @@
 import type { RenderPayload } from "./payload";
 export interface SelectionCardOptions {
     /** The chart's own aggregation, so the card AGREES with the picture it sits on. A card
-     *  reading "Sum" beside a chart drawn from averages is two answers to one question. */
+     *  reading "Sum" beside a chart drawn from averages is two answers to one question.
+     *
+     *  BLANK MEANS AUTO, and Auto is now per COLUMN. The Excel settings panel has offered
+     *  "Auto — sum amounts, average rates" since the control shipped; `normaliseAggregation("")`
+     *  answered `sum` for every column alike, so the label described a rule the code did not
+     *  implement. A blank now resolves through `defaultAggregation` per column: amounts sum,
+     *  rates average, dimensions report their value. A NAMED aggregation is still honoured
+     *  wherever it is honest, and substituted per column where it is not — the label carries
+     *  the substitution, so "Average of ChurnRate" beside "Sum of Revenue" reads as the answer
+     *  it is rather than a silent override. */
     aggregation?: string;
     cultureCode?: string;
     /** Cards are capped at roughly a third of the tile, so the measure list is capped too.
@@ -10,29 +19,55 @@ export interface SelectionCardOptions {
     /** Past this many distinct dimension values the header becomes "N marks" — naming twelve
      *  cities in a header is not a header. */
     maxHeaderValues?: number;
+    /** How many DIMENSION lines to add below the measures. Capped separately and small on
+     *  purpose: dimensions must never crowd out the amounts, which is the failure the measure
+     *  cap already had (on the sample table the two coordinate columns took two of the four
+     *  measure slots and pushed the real measures under "+2 more"). Default 2. */
+    maxDimensions?: number;
 }
 export interface SelectionCardLine {
     column: string;
-    /** "Sum of Revenue" — the aggregation is named because it is not always sum. */
+    /** "Sum of Revenue" — the aggregation is named because it is not always sum. For a
+     *  dimension resolving to ONE value it is just the column name, because "First of Segment:
+     *  East" says nothing "Segment: East" does not. */
     label: string;
+    /** Null for a dimension line, whose answer is text. `valueText` is what a host renders. */
     value: number | null;
     valueText: string;
-    /** Share of the same aggregate over ALL rows. Null whenever a share would be a lie — see
-     *  isAdditive: the average of a subset is not a percentage of the average of the whole. */
+    /** Share of the same aggregate over ALL rows. Null whenever a share would be a lie — it
+     *  needs BOTH an additive aggregation and an additive COLUMN. The average of a subset is
+     *  not a percentage of the average of the whole; neither is a total of latitudes. */
     sharePct: number | null;
     shareText: string;
+    /** Which aggregation this line actually used, after any per-column substitution. */
+    aggregation: string;
 }
 export interface SelectionCardModel {
     header: string;
+    /** MEASURE lines. Kept measures-only so `maxMeasures` and `hiddenMeasures` keep meaning
+     *  exactly what they meant; dimensions have their own list and their own cap. */
     lines: SelectionCardLine[];
+    /** DIMENSION lines — the "First, Count, Distinct" half. Before 2026-09-01 the FIRST dimension
+     *  supplied the header and every other one was discarded, so on the sample table `Segment`
+     *  appeared nowhere at all. The header column is still excluded here: it is already on
+     *  screen. */
+    dimensionLines: SelectionCardLine[];
     /** "6 of 24 rows" — the one line that is true regardless of what the columns contain. */
     rowsText: string;
     selectedRows: number;
     totalRows: number;
     /** Measures the cap left out, so a host can say "+2 more" instead of implying there were none. */
     hiddenMeasures: number;
+    /** Columns the CLASSIFIER withheld rather than the cap — coordinates today. Not for display:
+     *  a reader does not need telling that a latitude was not totalled. It is here so a host can
+     *  log it, because a column vanishing from a card with no trace is the kind of thing that
+     *  costs an afternoon later. */
+    suppressedColumns: string[];
     aggregation: string;
 }
+/** The set this file reduces over. `first` is shape-core's eighth kind and is handled on the
+ *  dimension path only, which is why it is absent here — a `reduce` over numbers has nothing to
+ *  do with it. */
 type Agg = "sum" | "average" | "min" | "max" | "count" | "median" | "distinctcount";
 /** Normalise the many spellings the hosts use into the set this file reduces over. Unknown
  *  spellings fall back to sum rather than throwing: a card is a courtesy, and refusing to draw

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.5.44",
+  "version": "0.5.46",
   "description": "Run a BIC-generated D3 chart in any web host: compiles the generated render() function, applies the shared option defaults, resolves mark clicks (through tooltip overlays), owns the selection affordance, and translates row indices between cross-filtered charts. The same contract the BIC Power BI visual implements, minus Power BI. React bindings at @bicharts/chart-host/react.",
   "license": "Apache-2.0",
   "type": "module",