@bicharts/chart-host 0.6.30 → 0.6.32

package/dist/{chunk-KONJ3DXV.mjs → chunk-P22NUGCZ.mjs}

@@ -142,7 +142,7 @@ var require_papaparse_min = __commonJS({
           return "greedy" === m2.skipEmptyLines ? "" === e2.join("").trim() : 1 === e2.length && 0 === e2[0].length;
         }
         function g4() {
-          if (p4 && a5 && (k4("Delimiter", "UndetectableDelimiter", "Unable to auto-detect delimiting character; defaulted to '" + v4.DefaultDelimiter + "'"), a5 = false), m2.skipEmptyLines && (p4.data = p4.data.filter(function(e4) {
+          if (p4 && a5 && (k3("Delimiter", "UndetectableDelimiter", "Unable to auto-detect delimiting character; defaulted to '" + v4.DefaultDelimiter + "'"), a5 = false), m2.skipEmptyLines && (p4.data = p4.data.filter(function(e4) {
             return !y6(e4);
           })), _3()) {
             let t4 = function(e4, t5) {
@@ -164,7 +164,7 @@ var require_papaparse_min = __commonJS({
               })(t5) ? parseFloat(t5) : d3.test(t5) ? new Date(t5) : "" === t5 ? null : t5) : t5)(n4 = m2.header ? r5 >= c4.length ? "__parsed_extra" : c4[r5] : n4, s4 = m2.transform ? m2.transform(s4, n4) : s4);
               "__parsed_extra" === n4 ? (i5[n4] = i5[n4] || [], i5[n4].push(s4)) : i5[n4] = s4;
             }
-            return m2.header && (r5 > c4.length ? k4("FieldMismatch", "TooManyFields", "Too many fields: expected " + c4.length + " fields but parsed " + r5, f5 + t4) : r5 < c4.length && k4("FieldMismatch", "TooFewFields", "Too few fields: expected " + c4.length + " fields but parsed " + r5, f5 + t4)), i5;
+            return m2.header && (r5 > c4.length ? k3("FieldMismatch", "TooManyFields", "Too many fields: expected " + c4.length + " fields but parsed " + r5, f5 + t4) : r5 < c4.length && k3("FieldMismatch", "TooFewFields", "Too few fields: expected " + c4.length + " fields but parsed " + r5, f5 + t4)), i5;
           }
           var r4;
           p4 && (m2.header || m2.dynamicTyping || m2.transform) && (r4 = 1, !p4.data.length || Array.isArray(p4.data[0]) ? (p4.data = p4.data.map(i4), r4 = p4.data.length) : p4.data = i4(p4.data, 0), m2.header && p4.meta && (p4.meta.fields = c4), f5 += r4);
@@ -172,7 +172,7 @@ var require_papaparse_min = __commonJS({
         function _3() {
           return m2.header && 0 === c4.length;
         }
-        function k4(e2, t2, i4, r4) {
+        function k3(e2, t2, i4, r4) {
           e2 = { type: e2, code: t2, message: i4 };
           void 0 !== r4 && (e2.row = r4), p4.errors.push(e2);
         }
@@ -211,7 +211,7 @@ var require_papaparse_min = __commonJS({
         return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       }
       function E4(C2) {
-        var S = (C2 = C2 || {}).delimiter, O3 = C2.newline, x2 = C2.comments, I4 = C2.step, A2 = C2.preview, T4 = C2.fastMode, D3 = null, L2 = false, F3 = null == C2.quoteChar ? '"' : C2.quoteChar, j3 = F3;
+        var S = (C2 = C2 || {}).delimiter, O3 = C2.newline, x2 = C2.comments, I4 = C2.step, A2 = C2.preview, T4 = C2.fastMode, D3 = null, L4 = false, F3 = null == C2.quoteChar ? '"' : C2.quoteChar, j3 = F3;
         if (void 0 !== C2.escapeChar && (j3 = C2.escapeChar), ("string" != typeof S || -1 < v4.BAD_DELIMITERS.indexOf(S)) && (S = ","), x2 === S) throw new Error("Comment character same as delimiter");
         true === x2 ? x2 = "#" : ("string" != typeof x2 || -1 < v4.BAD_DELIMITERS.indexOf(x2)) && (x2 = false), "\n" !== O3 && "\r" !== O3 && "\r\n" !== O3 && (O3 = "\n");
         var z4 = 0, M = false;
@@ -225,8 +225,8 @@ var require_papaparse_min = __commonJS({
               else if (r2) return w3();
               if (!x2 || d3.substring(0, a5) !== x2) {
                 if (o2) {
-                  if (h4 = [], k4(d3.split(S)), R2(), M) return w3();
-                } else k4(d3.split(S));
+                  if (h4 = [], k3(d3.split(S)), R2(), M) return w3();
+                } else k3(d3.split(S));
                 if (A2 && A2 <= c4) return h4 = h4.slice(0, A2), w3(true);
               }
             }
@@ -262,7 +262,7 @@ var require_papaparse_min = __commonJS({
             if (A2 && h4.length >= A2) return w3(true);
           }
           return E5();
-          function k4(e2) {
+          function k3(e2) {
             h4.push(e2), f5 = z4;
           }
           function v5(e2) {
@@ -270,13 +270,13 @@ var require_papaparse_min = __commonJS({
             return t2 = -1 !== e2 && (e2 = i2.substring(m2 + 1, e2)) && "" === e2.trim() ? e2.length : t2;
           }
           function E5(e2) {
-            return r2 || (void 0 === e2 && (e2 = i2.substring(z4)), d3.push(e2), z4 = n2, k4(d3), o2 && R2()), w3();
+            return r2 || (void 0 === e2 && (e2 = i2.substring(z4)), d3.push(e2), z4 = n2, k3(d3), o2 && R2()), w3();
           }
           function b5(e2) {
-            z4 = e2, k4(d3), d3 = [], g4 = i2.indexOf(O3, z4);
+            z4 = e2, k3(d3), d3 = [], g4 = i2.indexOf(O3, z4);
           }
           function w3(e2) {
-            if (C2.header && !t && h4.length && !L2) {
+            if (C2.header && !t && h4.length && !L4) {
               var s4 = h4[0], a6 = /* @__PURE__ */ Object.create(null), o4 = new Set(s4);
               let n4 = false;
               for (let r4 = 0; r4 < s4.length; r4++) {
@@ -288,7 +288,7 @@ var require_papaparse_min = __commonJS({
                 } else a6[i4] = 1, s4[r4] = i4;
                 o4.add(i4);
               }
-              n4 && console.warn("Duplicate headers found and renamed."), L2 = true;
+              n4 && console.warn("Duplicate headers found and renamed."), L4 = true;
             }
             return { data: h4, errors: u4, meta: { delimiter: S, linebreak: O3, aborted: M, truncated: !!e2, cursor: f5 + (t || 0), renamedHeaders: D3 } };
           }
@@ -368,7 +368,7 @@ var require_papaparse_min = __commonJS({
         function n2(e2, t2, i4) {
           var r4 = "", n4 = ("string" == typeof e2 && (e2 = JSON.parse(e2)), "string" == typeof t2 && (t2 = JSON.parse(t2)), Array.isArray(e2) && 0 < e2.length), s4 = !Array.isArray(t2[0]);
           if (n4 && _3) {
-            for (var a6 = 0; a6 < e2.length; a6++) 0 < a6 && (r4 += m2), r4 += k4(e2[a6], a6);
+            for (var a6 = 0; a6 < e2.length; a6++) 0 < a6 && (r4 += m2), r4 += k3(e2[a6], a6);
             0 < t2.length && (r4 += y6);
           }
           for (var o4 = 0; o4 < t2.length; o4++) {
@@ -384,14 +384,14 @@ var require_papaparse_min = __commonJS({
               for (var p4 = 0; p4 < h5; p4++) {
                 0 < p4 && !d3 && (r4 += m2);
                 var g4 = n4 && s4 ? e2[p4] : p4;
-                r4 += k4(t2[o4][g4], p4);
+                r4 += k3(t2[o4][g4], p4);
               }
               o4 < t2.length - 1 && (!i4 || 0 < h5 && !d3) && (r4 += y6);
             }
           }
           return r4;
         }
-        function k4(e2, t2) {
+        function k3(e2, t2) {
           var i4, r4, n4;
           return null == e2 ? "" : e2.constructor === Date ? JSON.stringify(e2).slice(1, 25) : (n4 = false, h4 && "string" == typeof e2 && h4.test(e2) && (e2 = "'" + e2, n4 = true), r4 = (i4 = e2.toString()).replace(u4, o2), (n4 = n4 || true === s2 || "function" == typeof s2 && s2(e2, t2) || Array.isArray(s2) && s2[t2] || ((e4, t4) => {
             for (var i5 = 0; i5 < t4.length; i5++) if (-1 < e4.indexOf(t4[i5])) return true;
@@ -451,9 +451,9 @@ var CONTAINER_SLOT_UI_STATE = "__lchUiState";
 var VIEW_ONLY_UI_STATE_KEYS = Object.freeze(["camera", "llmZoom"]);
 function withoutViewOnlyKeys(bag) {
   if (!bag || typeof bag !== "object") return bag;
-  if (!VIEW_ONLY_UI_STATE_KEYS.some((k4) => Object.prototype.hasOwnProperty.call(bag, k4))) return bag;
+  if (!VIEW_ONLY_UI_STATE_KEYS.some((k3) => Object.prototype.hasOwnProperty.call(bag, k3))) return bag;
   const out = { ...bag };
-  for (const k4 of VIEW_ONLY_UI_STATE_KEYS) delete out[k4];
+  for (const k3 of VIEW_ONLY_UI_STATE_KEYS) delete out[k3];
   return out;
 }
 var HOST_CONTAINER_CLASS = "bic-chart-host";
@@ -666,10 +666,10 @@ function censusColourSpread(container, doc) {
     for (const { rgb } of counted) {
       marks++;
       distinct.add(rgb.join(","));
-      const k4 = cellKey(rgb);
-      const cur = cells.get(k4);
+      const k3 = cellKey(rgb);
+      const cur = cells.get(k3);
       if (cur) cur.n++;
-      else cells.set(k4, { rgb, n: 1 });
+      else cells.set(k3, { rgb, n: 1 });
     }
     if (marks < MIN_MARKS || distinct.size < MIN_RAMP_FILLS) return EMPTY;
     const top = [...cells.values()].sort((a4, b4) => b4.n - a4.n).slice(0, MAX_CELLS);
@@ -748,8 +748,8 @@ function autoRampMinStep(low, high, canvas, classes = AUTO_RAMP_CLASSES, opacity
   const bg = normHex(canvas);
   if (!lo || !hi || !bg || classes < 2) return NaN;
   let prev = null, min = Infinity;
-  for (let k4 = 0; k4 < classes; k4++) {
-    const painted = paintedOver(labToHex(mixLab(lo, hi, k4 / (classes - 1))), bg, opacity);
+  for (let k3 = 0; k3 < classes; k3++) {
+    const painted = paintedOver(labToHex(mixLab(lo, hi, k3 / (classes - 1))), bg, opacity);
     if (prev) min = Math.min(min, deltaE2000(prev, painted));
     prev = painted;
   }
@@ -784,9 +784,9 @@ function resolveAutoColorScale(p2) {
   let high = { ...A2 };
   let highHex = labToHex(high);
   for (let step = 0; step < 80 && autoRampMinStep(lowHex, highHex, canvas) < AUTO_RAMP_MIN_STEP_DELTA_E; step++) {
-    const L2 = Math.max(4, Math.min(98, high.L + (darkCanvas ? 1 : -1)));
-    if (L2 === high.L) break;
-    high = { ...high, L: L2 };
+    const L4 = Math.max(4, Math.min(98, high.L + (darkCanvas ? 1 : -1)));
+    if (L4 === high.L) break;
+    high = { ...high, L: L4 };
     highHex = labToHex(high);
   }
   memoKey = key;
@@ -953,12 +953,12 @@ var byAsset = /* @__PURE__ */ new Map();
 var _na;
 function geoAssetFor(geoKind) {
   if (!geoKind) return null;
-  const k4 = geoKind.toLowerCase();
-  if (/^country/.test(k4)) return "world";
-  if (k4 === "north-america") return "world";
-  if (k4 === "world") return "world";
-  if (k4 === "us-state-code" || k4 === "us-state-name") return "us-states";
-  if (k4 === "us-zip5") return "us-zip3";
+  const k3 = geoKind.toLowerCase();
+  if (/^country/.test(k3)) return "world";
+  if (k3 === "north-america") return "world";
+  if (k3 === "world") return "world";
+  if (k3 === "us-state-code" || k3 === "us-state-name") return "us-states";
+  if (k3 === "us-zip5") return "us-zip3";
   return null;
 }
 var _worldBase;
@@ -1584,7 +1584,7 @@ var wt = new RegExp([String.raw`\bisMeasure\b`, String.raw`\bdataType\b`, String
 /*! @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 K3 = 2;
 var J4 = 400;
-function B3(e) {
+function z3(e) {
   return !!E(e);
 }
 function T3(e) {
@@ -1598,8 +1598,8 @@ function T3(e) {
 }
 function v3(e) {
   let n = T3(e);
-  if (n.length === 0 || W2(e) < 95) return false;
-  let t = n.filter((u2) => B3(u2) && !Y(u2)).length, o = n.filter((u2) => !B3(u2) && !!Y(u2)).length;
+  if (n.length === 0 || B3(e) < 95) return false;
+  let t = n.filter((u2) => z3(u2) && !Y(u2)).length, o = n.filter((u2) => !z3(u2) && !!Y(u2)).length;
   return t >= 1 && t >= o;
 }
 function Y3(e, n) {
@@ -1607,21 +1607,21 @@ function Y3(e, n) {
   let t = E(e);
   return t ? n === "world" ? true : s3.has(t) : false;
 }
-function W2(e) {
+function B3(e) {
   let n = T3(e);
   if (n.length === 0) return 0;
   let t = 0;
-  for (let o of n) B3(o) && t++;
+  for (let o of n) z3(o) && t++;
   return Math.round(t / n.length * 1e3) / 10;
 }
-function k3(e) {
+function L2(e) {
   let n = T3(e);
   if (n.length === 0) return 0;
   let t = 0;
   for (let o of n) Y(o) && t++;
   return Math.round(t / n.length * 1e3) / 10;
 }
-function $2(e) {
+function U3(e) {
   let n = /* @__PURE__ */ new Set();
   for (let t of e) {
     if (t == null) continue;
@@ -1630,15 +1630,15 @@ function $2(e) {
   }
   return Array.from(n);
 }
-function U3(e) {
-  let n = $2(e);
+function $2(e) {
+  let n = U3(e);
   if (n.length === 0) return 0;
   let t = 0;
   for (let o of n) Z(o).length > 0 && t++;
   return Math.round(t / n.length * 1e3) / 10;
 }
 function Z3(e, n) {
-  return y4(n, rt) ? true : $2(e).some((t) => /^\d{5}(-\d{4})?$/.test(t.replace(/\.0+$/, "")));
+  return y4(n, rt) ? true : U3(e).some((t) => /^\d{5}(-\d{4})?$/.test(t.replace(/\.0+$/, "")));
 }
 function ot(e, n) {
   let t = T3(e);
@@ -1647,21 +1647,21 @@ function ot(e, n) {
   for (let u2 of t) p3(u2, n) && o++;
   return Math.round(o / t.length * 1e3) / 10;
 }
-function z3(e, n) {
+function W2(e, n) {
   let t = 0;
   for (let o of T3(e)) n(o) && t++;
   return t;
 }
 function it2(e, n) {
   let t = 0;
-  for (let o of $2(e)) n(o) && t++;
+  for (let o of U3(e)) n(o) && t++;
   return t;
 }
 function st(e, n, t, o, u2) {
-  let a4 = [], s = [], i = {}, h3 = {}, R2 = new Set(e), f4 = (r) => n.map((l) => l[r]);
+  let a4 = [], s = [], i = {}, h3 = {}, x2 = new Set(e), f4 = (r) => n.map((l) => l[r]);
   for (let r of ["city", "country"]) {
     let l = t?.[r];
-    l && R2.has(l) && (i[r] = l);
+    l && x2.has(l) && (i[r] = l);
   }
   let ue = new Set(u2 ?? e);
   for (let r of ["lat", "lon"]) {
@@ -1669,31 +1669,31 @@ function st(e, n, t, o, u2) {
     l && ue.has(l) && (i[r] = l);
   }
   let C2 = t?.zip;
-  if (C2 && R2.has(C2)) {
-    let r = f4(C2), l = U3(r);
+  if (C2 && x2.has(C2)) {
+    let r = f4(C2), l = $2(r);
     l < 95 ? s.push(`zip=${C2} (only ${l}% of values read as ZIPs)`) : Z3(r, C2) ? i.zip = C2 : s.push(`zip=${C2} (all values are 3-4 digits with nothing to say they are postal)`);
   }
   let g3 = t?.state;
-  if (g3 && R2.has(g3)) {
+  if (g3 && x2.has(g3)) {
     let r = f4(g3), l = T3(r);
-    l.length > 0 && l.every((d2) => Y3(d2, o)) ? s.push(`state=${g3} (every value is "CA", which is both Canada and California)`) : v3(r) ? (s.push(`state=${g3} (every value is a country, not a state)`), i.country || (i.country = g3)) : k3(r) < 95 ? s.push(`state=${g3} (only ${k3(r)}% of values are states/provinces)`) : i.state = g3;
+    l.length > 0 && l.every((d2) => Y3(d2, o)) ? s.push(`state=${g3} (every value is "CA", which is both Canada and California)`) : v3(r) ? (s.push(`state=${g3} (every value is a country, not a state)`), i.country || (i.country = g3)) : L2(r) < 95 ? s.push(`state=${g3} (only ${L2(r)}% of values are states/provinces)`) : i.state = g3;
   }
-  let b4 = new Set(Object.values(i).filter(Boolean)), M = e.filter((r) => !b4.has(r) && !r.startsWith("__"));
+  let b4 = new Set(Object.values(i).filter(Boolean)), F3 = e.filter((r) => !b4.has(r) && !r.startsWith("__"));
   if (!i.state) {
     let r = null;
-    for (let l of M) {
+    for (let l of F3) {
       let d2 = f4(l);
       if (v3(d2)) continue;
-      let p2 = k3(d2);
+      let p2 = L2(d2);
       if (p2 < 95) continue;
-      let _2 = z3(d2, (w3) => !!Y(w3)), de2 = z3(d2, (w3) => !!Y(w3) && !Y3(w3, o));
-      _2 < K3 && de2 < 1 || (!r || p2 > r.pct) && (r = { name: l, pct: p2 });
+      let k3 = W2(d2, (I4) => !!Y(I4)), de2 = W2(d2, (I4) => !!Y(I4) && !Y3(I4, o));
+      k3 < K3 && de2 < 1 || (!r || p2 > r.pct) && (r = { name: l, pct: p2 });
     }
     r && (i.state = r.name, b4.add(r.name), a4.push(`state=${r.name} (${r.pct}% states/provinces)`));
   }
-  if (!i.zip) for (let r of M) {
+  if (!i.zip) for (let r of F3) {
     if (b4.has(r)) continue;
-    let l = f4(r), d2 = U3(l);
+    let l = f4(r), d2 = $2(l);
     if (!(d2 < 95) && Z3(l, r) && !(it2(l, (p2) => Z(p2).length > 0) < K3)) {
       i.zip = r, b4.add(r), a4.push(`zip=${r} (${d2}% ZIP codes)`);
       break;
@@ -1702,29 +1702,30 @@ function st(e, n, t, o, u2) {
   let P4 = i.country;
   if (!P4 || !v3(f4(P4))) {
     let r = null;
-    for (let l of M) {
+    for (let l of F3) {
       if (b4.has(l) || !v3(f4(l))) continue;
-      let d2 = W2(f4(l));
+      let d2 = B3(f4(l));
       (!r || d2 > r.pct) && (r = { name: l, pct: d2 });
     }
-    r && (P4 && (s.push(`country=${P4} (only ${W2(f4(P4))}% of values are country identifiers; using ${r.name} instead)`), h3.country = P4), i.country = r.name, b4.add(r.name), a4.push(`country=${r.name}`));
+    r && (P4 && (s.push(`country=${P4} (only ${B3(f4(P4))}% of values are country identifiers; using ${r.name} instead)`), h3.country = P4), i.country = r.name, b4.add(r.name), a4.push(`country=${r.name}`));
   }
   if (!i.city) {
     let r = null;
-    for (let l of M) {
+    for (let l of F3) {
       if (b4.has(l)) continue;
       let d2 = f4(l), p2 = ot(d2, o);
-      p2 < m3 || z3(d2, (_2) => p3(_2, o)) < K3 || (!r || p2 > r.pct) && (r = { name: l, pct: p2 });
+      p2 < m3 || W2(d2, (k3) => p3(k3, o)) < K3 || (!r || p2 > r.pct) && (r = { name: l, pct: p2 });
     }
     r && (i.city = r.name, a4.push(`city=${r.name} (${r.pct}% known cities)`));
   }
-  let H3 = i.country ? f4(i.country) : [], E4 = !!i.country && v3(H3), ce = E4 ? new Set(H3.map((r) => E(r == null ? null : String(r))).filter(Boolean)).size : 0, j3 = E4 && ce >= 2, O3 = !!(i.lat && i.lon) && n.some((r) => {
+  let H3 = i.country ? f4(i.country) : [], _2 = !!i.country && v3(H3), ce = _2 ? new Set(H3.map((r) => E(r == null ? null : String(r))).filter(Boolean)).size : 0, j3 = _2 && ce >= 2, O3 = !!(i.lat && i.lon) && n.some((r) => {
     let l = +String(r[i.lat] ?? "").trim(), d2 = +String(r[i.lon] ?? "").trim();
     return isFinite(l) && isFinite(d2) && l >= -90 && l <= 90 && d2 >= -180 && d2 <= 180 && String(r[i.lat] ?? "").trim() !== "" && String(r[i.lon] ?? "").trim() !== "";
   });
-  return i.lat && i.lon && !O3 && s.push(`lat/lon=${i.lat}/${i.lon} (no row holds a usable coordinate pair)`), i.country && !j3 && !(i.city || i.state || i.zip || O3) && s.push(E4 ? `country=${i.country} (every row resolves to the same country - nothing to place apart)` : `country=${i.country} (values are not country identifiers)`), { bind: !!(i.city || i.state || i.zip || j3 || O3) ? i : null, backfilled: a4, refused: s, ...Object.keys(h3).length ? { labelFallback: h3 } : {} };
+  return i.lat && i.lon && !O3 && s.push(`lat/lon=${i.lat}/${i.lon} (no row holds a usable coordinate pair)`), i.country && !j3 && !(i.city || i.state || i.zip || O3) && s.push(_2 ? `country=${i.country} (every row resolves to the same country - nothing to place apart)` : `country=${i.country} (values are not country identifiers)`), { bind: !!(i.city || i.state || i.zip || j3 || O3) ? i : null, backfilled: a4, refused: s, ...Object.keys(h3).length ? { labelFallback: h3 } : {} };
 }
 var St3 = Object.freeze({ integer: "number", decimal: "number", double: "number", datetime: "date", date: "date", boolean: "boolean", string: "text" });
+var Nt2 = Object.freeze({ RENDER_START: "render-start", RENDER_OK: "render-ok", RENDER_ERROR: "render-error", VIEW: "view", VIEW_VERDICT: "view-verdict" });
 
 // src/payload.ts
 function resolvePointChannel(cols, rowObjs, point) {
@@ -1833,20 +1834,20 @@ function buildRenderPayload(cols, rowObjs, geo, point, destination, opts) {
         a4[c2] = v4 ?? null;
       }
     }
-    let k4 = cols.length;
-    a4[k4++] = r;
-    if (geoIso) a4[k4++] = geoIso[r];
+    let k3 = cols.length;
+    a4[k3++] = r;
+    if (geoIso) a4[k3++] = geoIso[r];
     if (pLat && pLon) {
-      a4[k4++] = pLat[r];
-      a4[k4++] = pLon[r];
-      a4[k4++] = pPrec ? pPrec[r] : null;
+      a4[k3++] = pLat[r];
+      a4[k3++] = pLon[r];
+      a4[k3++] = pPrec ? pPrec[r] : null;
     }
     if (dLat && dLon) {
-      a4[k4++] = dLat[r];
-      a4[k4++] = dLon[r];
-      a4[k4++] = dPrec ? dPrec[r] : null;
+      a4[k3++] = dLat[r];
+      a4[k3++] = dLon[r];
+      a4[k3++] = dPrec ? dPrec[r] : null;
     }
-    for (const ac of aliasCols) a4[k4++] = a4[ac.from];
+    for (const ac of aliasCols) a4[k3++] = a4[ac.from];
     out[r] = a4;
   }
   const colsOut = [...cols, { name: "__rowIdx__", dataType: "Integer", isMeasure: false, modelDesc: "" }];
@@ -2050,14 +2051,14 @@ function createMarkResolver(env) {
     return s === "transparent" || s === "none" || so <= 0.01;
   };
   const distToPathCenterline = (el, x2, y5) => {
-    const L2 = el.getTotalLength();
-    if (!(L2 > 0)) return Number.MAX_VALUE;
+    const L4 = el.getTotalLength();
+    if (!(L4 > 0)) return Number.MAX_VALUE;
     const m = el.getScreenCTM();
     if (!m) return Number.MAX_VALUE;
     let best = Number.MAX_VALUE;
     const N3 = 64;
     for (let i = 0; i <= N3; i++) {
-      const pt2 = el.getPointAtLength(L2 * i / N3);
+      const pt2 = el.getPointAtLength(L4 * i / N3);
       const dx = m.a * pt2.x + m.c * pt2.y + m.e - x2;
       const dy = m.b * pt2.x + m.d * pt2.y + m.f - y5;
       const d2 = dx * dx + dy * dy;
@@ -2442,10 +2443,10 @@ function censusValuePlacement(container, data) {
         for (const axis of ["x", "y"]) {
           const keep = [];
           const v4 = [], pos = [];
-          dots.forEach((d2, k4) => {
-            if (!Number.isFinite(vals[k4])) return;
-            keep.push(k4);
-            v4.push(log ? Math.log10(vals[k4]) : vals[k4]);
+          dots.forEach((d2, k3) => {
+            if (!Number.isFinite(vals[k3])) return;
+            keep.push(k3);
+            v4.push(log ? Math.log10(vals[k3]) : vals[k3]);
             pos.push(axis === "x" ? d2.x : d2.y);
           });
           const line = robustLine(v4, pos);
@@ -2454,8 +2455,8 @@ function censusValuePlacement(container, data) {
           if (hi - lo < MIN_AXIS_SPAN_PX) continue;
           const mean = pos.reduce((s, p2) => s + p2, 0) / pos.length;
           let ssRes = 0, ssTot = 0;
-          const res = pos.map((p2, k4) => {
-            const e = p2 - (line.a + line.b * v4[k4]);
+          const res = pos.map((p2, k3) => {
+            const e = p2 - (line.a + line.b * v4[k3]);
             ssRes += e * e;
             ssTot += (p2 - mean) ** 2;
             return e;
@@ -2464,8 +2465,8 @@ function censusValuePlacement(container, data) {
           const fit = 1 - ssRes / ssTot;
           if (fit >= VALUE_AXIS_MIN_FIT && (!best || fit > best.fit)) {
             const full = new Array(dots.length).fill(NaN);
-            keep.forEach((k4, j3) => {
-              full[k4] = res[j3];
+            keep.forEach((k3, j3) => {
+              full[k3] = res[j3];
             });
             best = { col: c2, axis, fit, res: full, log };
           }
@@ -2475,8 +2476,8 @@ function censusValuePlacement(container, data) {
     if (!best) return EMPTY4;
     let off = 0, measured = 0;
     const radii = [];
-    dots.forEach((d2, k4) => {
-      const e = best.res[k4];
+    dots.forEach((d2, k3) => {
+      const e = best.res[k3];
       if (!Number.isFinite(e)) return;
       measured++;
       const inRadii = Math.abs(e) / Math.max(d2.r, 1);
@@ -3051,8 +3052,8 @@ var NAMED = {
 };
 function toRGBA(c2) {
   if (typeof c2 !== "string") return null;
-  const k4 = c2.trim().toLowerCase();
-  if (k4 in NAMED) return NAMED[k4];
+  const k3 = c2.trim().toLowerCase();
+  if (k3 in NAMED) return NAMED[k3];
   return parseRGBA(c2);
 }
 function compositeOver(fg, bg) {
@@ -3102,12 +3103,12 @@ var GLYPH_SAMPLE_N = 3;
 function glyphSampleGrid(box, n = GLYPH_SAMPLE_N) {
   const out = [];
   if (!box || !(box.width > 0) || !(box.height > 0) || !(n >= 1)) return out;
-  const k4 = Math.floor(n);
-  for (let i = 0; i < k4; i++) {
-    for (let j3 = 0; j3 < k4; j3++) {
+  const k3 = Math.floor(n);
+  for (let i = 0; i < k3; i++) {
+    for (let j3 = 0; j3 < k3; j3++) {
       out.push({
-        x: box.left + box.width * (i + 0.5) / k4,
-        y: box.top + box.height * (j3 + 0.5) / k4
+        x: box.left + box.width * (i + 0.5) / k3,
+        y: box.top + box.height * (j3 + 0.5) / k3
       });
     }
   }
@@ -3322,7 +3323,7 @@ function sessionViewStateProvider(container) {
     load: () => store,
     save: (next) => {
       if (!next || typeof next !== "object") return;
-      for (const k4 of Object.keys(store)) delete store[k4];
+      for (const k3 of Object.keys(store)) delete store[k3];
       Object.assign(store, next);
     }
   };
@@ -3851,10 +3852,10 @@ function toSourceRows(rowMap, payloadRowIdxs) {
 }
 function toPayloadRows(rowMap, sourceRowIdxs) {
   const at3 = /* @__PURE__ */ new Map();
-  rowMap.forEach((src, k4) => {
-    if (!at3.has(src)) at3.set(src, k4);
+  rowMap.forEach((src, k3) => {
+    if (!at3.has(src)) at3.set(src, k3);
   });
-  return sourceRowIdxs.map((s) => at3.get(s)).filter((k4) => k4 !== void 0);
+  return sourceRowIdxs.map((s) => at3.get(s)).filter((k3) => k3 !== void 0);
 }
 var sameRows = (a4, b4) => {
   if (a4.length !== b4.length) return false;

package/dist/index.mjs

@@ -140,10 +140,64 @@ import {
   unpinScrolledAxis,
   valuePlacementFlag,
   withoutViewOnlyKeys
-} from "./chunk-KONJ3DXV.mjs";
+} from "./chunk-P22NUGCZ.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
+// src/optionsVocabulary.ts
+var MAX_MAP_POINTS_MIN = 10;
+var MAX_MAP_POINTS_MAX = 1e5;
+var LIMIT_COUNT_MAX = 1e4;
+var entry = (e2) => Object.freeze({ ...e2, ...e2.values ? { values: Object.freeze([...e2.values]) } : {} });
+var OPTIONS_VOCABULARY = Object.freeze({
+  // ---- drawn from on every render, and stated on the request so the model reasons about them ----
+  aggregation: entry({ timing: "live-and-next-generate", default: "", values: ["", "sum", "average", "median", "min", "max", "count", "distinct"], wire: "request" }),
+  colorScaleLow: entry({ timing: "live-and-next-generate", default: "", wire: "request" }),
+  colorScaleHigh: entry({ timing: "live-and-next-generate", default: "", wire: "request" }),
+  /** Blank: the host's own colours when it offers them, else the engine's. */
+  palette: entry({ timing: "live-and-next-generate", default: "", wire: "request" }),
+  /** A HARD offer gate on the server as well as a live cap on what a point map plots. */
+  maxMapPoints: entry({ timing: "live-and-next-generate", default: MAX_MAP_POINTS_DEFAULT, min: MAX_MAP_POINTS_MIN, max: MAX_MAP_POINTS_MAX, wire: "clientHints" }),
+  // ---- live only ----
+  /** 0 means no paging. */
+  pageSize: entry({ timing: "live", default: 0, min: 0 }),
+  valueAxisBaseline: entry({ timing: "live", default: VALUE_AXIS_BASELINE_DEFAULT, values: ["fit", "zero", "auto"] }),
+  seasonalMarkers: entry({ timing: "live", default: SEASONAL_MARKERS_DEFAULT, values: ["auto", "always", "never"] }),
+  animAutoPlay: entry({ timing: "live", default: false }),
+  animPlaySpeedMs: entry({ timing: "live", default: ANIM_PLAY_SPEED_DEFAULT, min: ANIM_PLAY_SPEED_MIN, max: ANIM_PLAY_SPEED_MAX }),
+  /** 0 restarts at once; no upper bound, so a very large value plays once per viewing. */
+  animLoopDelaySec: entry({ timing: "live", default: ANIM_LOOP_DELAY_DEFAULT, min: ANIM_LOOP_DELAY_MIN }),
+  animStopAtEnd: entry({ timing: "live", default: false }),
+  animMaxIdealFrames: entry({ timing: "live", default: ANIM_MAX_IDEAL_FRAMES_DEFAULT, min: ANIM_MAX_IDEAL_FRAMES_MIN, max: ANIM_MAX_IDEAL_FRAMES_MAX }),
+  /** "" chooses by the number of periods. */
+  animTimelineStyle: entry({ timing: "live", default: "", values: ["", "line", "boxes"] }),
+  filtersDuringPlay: entry({ timing: "live", default: false }),
+  // ---- the next generated chart ----
+  levelOfDetail: entry({ timing: "next-generate", default: "", values: ["", "High", "Medium", "Low"], wire: "clientHints" }),
+  favorLimitTo: entry({ timing: "next-generate", default: "", values: ["", "latest", "top / greatest", "bottom / smallest", "most common", "outliers"], wire: "clientHints" }),
+  /** 0 asks for no limit, and travels as absent (`wireLimitCount`): any value the server receives is a limit. */
+  favorLimitCount: entry({ timing: "next-generate", default: 0, min: 0, max: LIMIT_COUNT_MAX, wire: "clientHints" }),
+  /** "1" asks for a title, "0" for none, "" leaves it to the engine. */
+  favorTitle: entry({ timing: "next-generate", default: "", values: ["", "1", "0"], wire: "clientHints" }),
+  /** Data labels on the marks: "1", "0", or "" for the engine's choice. */
+  favorDPValues: entry({ timing: "next-generate", default: "", values: ["", "1", "0"], wire: "clientHints" }),
+  legendPlacement: entry({ timing: "next-generate", default: "", values: ["", "outside", "inside", "none"], wire: "clientHints" }),
+  /** Free text: the industry the data belongs to. */
+  industryContext: entry({ timing: "next-generate", default: "", wire: "clientHints" }),
+  /** Free text: a font family for the chart's own text. */
+  suggestFontFamily: entry({ timing: "next-generate", default: "", wire: "clientHints" }),
+  // ---- after a chart is drawn ----
+  visionReview: entry({ timing: "after-render", default: false }),
+  saveThumbnails: entry({ timing: "after-render", default: false })
+});
+var LIVE_OPTION_KEYS = Object.freeze(
+  Object.keys(OPTIONS_VOCABULARY).filter((k2) => OPTIONS_VOCABULARY[k2].timing === "live" || OPTIONS_VOCABULARY[k2].timing === "live-and-next-generate")
+);
+function wireLimitCount(count) {
+  const n2 = typeof count === "number" ? count : count == null || count === "" ? NaN : Number(count);
+  return Number.isFinite(n2) && n2 > 0 ? n2 : null;
+}
+
 // src/dateCells.ts
 var LOCAL_DATE_METHOD = /\.(?:getFullYear|getMonth|getDate|getDay|getHours|getMinutes|setFullYear|setMonth|setDate|setHours|setMinutes|setSeconds|setMilliseconds)\s*\(/;
 var D3_LOCAL_TIME = /\bd3\s*\.\s*(?:scaleTime|time[A-Z]\w*)\b/;
@@ -2542,14 +2596,19 @@ export {
   LEGIBLE_LIGHTNESS,
   LIFT_SELECTED_CLASS,
   LIGHT_TEXT,
+  LIMIT_COUNT_MAX,
+  LIVE_OPTION_KEYS,
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   MAX_FRAME_GROW_FACTOR,
   MAX_MAP_POINTS_DEFAULT,
+  MAX_MAP_POINTS_MAX,
+  MAX_MAP_POINTS_MIN,
   MIN_CONTRAST,
   MIN_DELTA_E,
   MIN_HIT_BAND_PX,
   MIN_RAMP_FILLS,
+  OPTIONS_VOCABULARY,
   PAGE_MATCH_TOLERANCE,
   PENDING_RECOVERY_FAST_PHASE_MS,
   PENDING_RECOVERY_FIRST_POLL_MS,
@@ -2732,5 +2791,6 @@ export {
   updateRowHighWater,
   valuePlacementFlag,
   vegaSpecReadsDatesInLocalTime,
+  wireLimitCount,
   withoutViewOnlyKeys
 };

package/dist/react.mjs

@@ -7,7 +7,7 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-KONJ3DXV.mjs";
+} from "./chunk-P22NUGCZ.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, CONTROL_CLASS, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, chartOwnsTimeline, periodTickSuppressesFeedback, ANIM_PLAY_SPEED_DEFAULT, ANIM_PLAY_SPEED_MIN, ANIM_PLAY_SPEED_MAX, ANIM_LOOP_DELAY_DEFAULT, ANIM_LOOP_DELAY_MIN, ANIM_MAX_IDEAL_FRAMES_DEFAULT, ANIM_MAX_IDEAL_FRAMES_MIN, ANIM_MAX_IDEAL_FRAMES_MAX, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, } from "./contract";
 export { resolveOptions, type ResolveOptionsInput } from "./defaults";
+export { OPTIONS_VOCABULARY, LIVE_OPTION_KEYS, MAX_MAP_POINTS_MIN, MAX_MAP_POINTS_MAX, LIMIT_COUNT_MAX, wireLimitCount, type OptionVocabularyEntry, type OptionTiming, type OptionWire, type OptionKey, } from "./optionsVocabulary";
 export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";
 /** REPLACE the bundled city gazetteer with another packed table. Rarely needed — see the
  *  note above registerCityTable in shape-core's geoPoint.ts before using it. */

package/dist/types/optionsVocabulary.d.ts

@@ -0,0 +1,77 @@
+/**
+ * When a change to an option takes effect.
+ * - `live`: the chart on screen repaints with it; no request, no new chart.
+ * - `next-generate`: it steers what the engine makes, so it applies to the next generated chart.
+ * - `live-and-next-generate`: both - the chart on screen repaints, and the request carries it too.
+ * - `after-render`: it governs what happens after a chart is drawn (a review, a thumbnail).
+ */
+export type OptionTiming = "live" | "next-generate" | "live-and-next-generate" | "after-render";
+/** Where an option travels on a generate request: the request itself, or its client hints. */
+export type OptionWire = "request" | "clientHints";
+/** The shared facts about one option. */
+export interface OptionVocabularyEntry {
+    readonly timing: OptionTiming;
+    /** What "not set" means. A host that stores blank or 0 for "the default" resolves to this. */
+    readonly default: string | number | boolean;
+    /** The least value a reader may set, for a number. */
+    readonly min?: number;
+    /** The greatest value a reader may set, for a number. Absent: no upper bound. */
+    readonly max?: number;
+    /** The values a choice accepts, "" being "leave it to the engine" where offered. */
+    readonly values?: readonly string[];
+    /** Where it travels on a generate request; absent when it never travels. */
+    readonly wire?: OptionWire;
+}
+/** Max Map Points: the fewest and the most points a reader may allow a point map. */
+export declare const MAX_MAP_POINTS_MIN = 10;
+export declare const MAX_MAP_POINTS_MAX = 100000;
+/** Favor Limit Count: the most groups a reader may ask a chart to keep. 0 asks for no limit. */
+export declare const LIMIT_COUNT_MAX = 10000;
+/** The options the hosts share, keyed by wire / render-option name. */
+export declare const OPTIONS_VOCABULARY: Readonly<{
+    aggregation: OptionVocabularyEntry;
+    colorScaleLow: OptionVocabularyEntry;
+    colorScaleHigh: OptionVocabularyEntry;
+    /** Blank: the host's own colours when it offers them, else the engine's. */
+    palette: OptionVocabularyEntry;
+    /** A HARD offer gate on the server as well as a live cap on what a point map plots. */
+    maxMapPoints: OptionVocabularyEntry;
+    /** 0 means no paging. */
+    pageSize: OptionVocabularyEntry;
+    valueAxisBaseline: OptionVocabularyEntry;
+    seasonalMarkers: OptionVocabularyEntry;
+    animAutoPlay: OptionVocabularyEntry;
+    animPlaySpeedMs: OptionVocabularyEntry;
+    /** 0 restarts at once; no upper bound, so a very large value plays once per viewing. */
+    animLoopDelaySec: OptionVocabularyEntry;
+    animStopAtEnd: OptionVocabularyEntry;
+    animMaxIdealFrames: OptionVocabularyEntry;
+    /** "" chooses by the number of periods. */
+    animTimelineStyle: OptionVocabularyEntry;
+    filtersDuringPlay: OptionVocabularyEntry;
+    levelOfDetail: OptionVocabularyEntry;
+    favorLimitTo: OptionVocabularyEntry;
+    /** 0 asks for no limit, and travels as absent (`wireLimitCount`): any value the server receives is a limit. */
+    favorLimitCount: OptionVocabularyEntry;
+    /** "1" asks for a title, "0" for none, "" leaves it to the engine. */
+    favorTitle: OptionVocabularyEntry;
+    /** Data labels on the marks: "1", "0", or "" for the engine's choice. */
+    favorDPValues: OptionVocabularyEntry;
+    legendPlacement: OptionVocabularyEntry;
+    /** Free text: the industry the data belongs to. */
+    industryContext: OptionVocabularyEntry;
+    /** Free text: a font family for the chart's own text. */
+    suggestFontFamily: OptionVocabularyEntry;
+    visionReview: OptionVocabularyEntry;
+    saveThumbnails: OptionVocabularyEntry;
+}>;
+/** A shared option's key. */
+export type OptionKey = keyof typeof OPTIONS_VOCABULARY;
+/** The keys whose change repaints the chart on screen, in table order. */
+export declare const LIVE_OPTION_KEYS: readonly OptionKey[];
+/**
+ * THE LIMIT COUNT A REQUEST CARRIES: a positive count, or null - never 0. The server reads any value it
+ * receives as the reader's own limit (and 0 as a limit of zero), so "no limit" must arrive as no value.
+ * A host places null where it always has; one that omits blank fields maps it to absent.
+ */
+export declare function wireLimitCount(count: unknown): number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.6.30",
+  "version": "0.6.32",
   "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",