@bicharts/chart-host 0.6.0 → 0.6.2

package/README.md

@@ -2,16 +2,15 @@
 
 > **Make Generative AI for Charts *Better*.**
 
-That is what **RegiaBI** is for; this package is the part that runs the result in your page,
-so a generated chart behaves the same wherever it lands.
+Describe the chart you want, or just hand over the data, and RegiaBI gives you back a working, interactive chart that fits your data on the first try — as source code you own. It goes into your repo and runs in the framework you already use: React, a plain web page, or whatever your coding agent is scaffolding. At run time there's no key, no call to us and nothing to pay per render: `@bicharts/chart-host`, the open-source runtime, makes the chart behave in your page — clicks, cross-filtering, selection — so that's code you don't have to write. You start from something that already works and spend your time on the last ten percent, in plain language or in the code itself; reading the code is an advantage, never the price of entry. And because the engine knows what each chart type can honestly say, it'll sometimes show you a view of your data you hadn't thought to ask for.
 
-Run a D3 chart generated by
-[Business Intelligence Champions](https://bizintelligencechampions.com) (BIC) in any web page.
+**[Live demo](https://codexguy.github.io/bicharts-react-demo/)** ·
+[RegiaBI for developers](https://bizintelligencechampions.com/regiabi/developers?loc=npmhost)
 
-A BIC chart is *generated source you own* — a plain `render(container, data, options)` function
-you commit to your repo. There is no API key at run time, no per-render cost, and no network
-call. This package is the host side: the ~80 lines every integrator would otherwise write, and
-the handful they would get subtly wrong.
+This package is the runtime: it makes the chart you were handed behave in your page. A
+generated chart is a plain `render(container, data, options)` function you commit to your repo,
+and this is the host side — the ~80 lines every integrator would otherwise write, and the
+handful they would get subtly wrong.
 
 It is the same contract the BIC Power BI visual implements, minus Power BI — so a chart looks
 and behaves the same wherever it runs.

package/dist/{chunk-DTAYO46G.mjs → chunk-HC2IREJL.mjs}

@@ -23,7 +23,7 @@ var require_papaparse_min = __commonJS({
     })(exports, function r() {
       var n = "undefined" != typeof self ? self : "undefined" != typeof window ? window : void 0 !== n ? n : {};
       var d2, s = !n.document && !!n.postMessage, a4 = n.IS_PAPA_WORKER || false, o = {}, h3 = 0, v2 = {};
-      function P2(e) {
+      function P4(e) {
         return 65279 === e.charCodeAt(0) ? e.slice(1) : e;
       }
       function u2(e) {
@@ -146,7 +146,7 @@ var require_papaparse_min = __commonJS({
             return !y6(e4);
           })), _3()) {
             let t4 = function(e4, t5) {
-              e4 = P2(e4), q4(m4.transformHeader) && (e4 = m4.transformHeader(e4, t5)), c4.push(e4);
+              e4 = P4(e4), q4(m4.transformHeader) && (e4 = m4.transformHeader(e4, t5)), c4.push(e4);
             };
             var t2 = t4;
             if (p4) if (Array.isArray(p4.data[0])) {
@@ -211,55 +211,55 @@ var require_papaparse_min = __commonJS({
         return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       }
       function E4(C) {
-        var S2 = (C = C || {}).delimiter, O3 = C.newline, x4 = C.comments, I2 = C.step, A = C.preview, T3 = C.fastMode, D4 = null, L2 = false, F4 = null == C.quoteChar ? '"' : C.quoteChar, j3 = F4;
-        if (void 0 !== C.escapeChar && (j3 = C.escapeChar), ("string" != typeof S2 || -1 < v2.BAD_DELIMITERS.indexOf(S2)) && (S2 = ","), x4 === S2) throw new Error("Comment character same as delimiter");
+        var S = (C = C || {}).delimiter, O3 = C.newline, x4 = C.comments, I2 = C.step, A = C.preview, T3 = C.fastMode, D3 = null, L2 = false, F4 = null == C.quoteChar ? '"' : C.quoteChar, j3 = F4;
+        if (void 0 !== C.escapeChar && (j3 = C.escapeChar), ("string" != typeof S || -1 < v2.BAD_DELIMITERS.indexOf(S)) && (S = ","), x4 === S) throw new Error("Comment character same as delimiter");
         true === x4 ? x4 = "#" : ("string" != typeof x4 || -1 < v2.BAD_DELIMITERS.indexOf(x4)) && (x4 = false), "\n" !== O3 && "\r" !== O3 && "\r\n" !== O3 && (O3 = "\n");
         var z3 = 0, M2 = false;
         this.parse = function(i2, t, r2) {
           if ("string" != typeof i2) throw new Error("Input must be a string");
-          var n2 = i2.length, e = S2.length, s2 = O3.length, a5 = x4.length, o2 = q4(I2), h4 = [], u4 = [], d3 = [], f5 = z3 = 0;
-          if (!i2) return w2();
+          var n2 = i2.length, e = S.length, s2 = O3.length, a5 = x4.length, o2 = q4(I2), h4 = [], u4 = [], d3 = [], f5 = z3 = 0;
+          if (!i2) return w3();
           if (T3 || false !== T3 && -1 === i2.indexOf(F4)) {
             for (var l2 = i2.split(O3), c4 = 0; c4 < l2.length; c4++) {
               if (d3 = l2[c4], z3 += d3.length, c4 !== l2.length - 1) z3 += O3.length;
-              else if (r2) return w2();
+              else if (r2) return w3();
               if (!x4 || d3.substring(0, a5) !== x4) {
                 if (o2) {
-                  if (h4 = [], k2(d3.split(S2)), R2(), M2) return w2();
-                } else k2(d3.split(S2));
-                if (A && A <= c4) return h4 = h4.slice(0, A), w2(true);
+                  if (h4 = [], k2(d3.split(S)), R2(), M2) return w3();
+                } else k2(d3.split(S));
+                if (A && A <= c4) return h4 = h4.slice(0, A), w3(true);
               }
             }
-            return w2();
+            return w3();
           }
-          for (var p4 = i2.indexOf(S2, z3), g4 = i2.indexOf(O3, z3), _3 = new RegExp(U2(j3) + U2(F4), "g"), m4 = i2.indexOf(F4, z3); ; ) if (i2[z3] === F4) for (m4 = z3, z3++; ; ) {
+          for (var p4 = i2.indexOf(S, z3), g4 = i2.indexOf(O3, z3), _3 = new RegExp(U2(j3) + U2(F4), "g"), m4 = i2.indexOf(F4, z3); ; ) if (i2[z3] === F4) for (m4 = z3, z3++; ; ) {
             if (-1 === (m4 = i2.indexOf(F4, m4 + 1))) return r2 || u4.push({ type: "Quotes", code: "MissingQuotes", message: "Quoted field unterminated", row: h4.length, index: z3 }), E5();
             if (m4 === n2 - 1) return E5(i2.substring(z3, m4).replace(_3, F4));
             if (F4 === j3 && i2[m4 + 1] === j3) m4++;
             else if (F4 === j3 || 0 === m4 || i2[m4 - 1] !== j3) {
-              -1 !== p4 && p4 < m4 + 1 && (p4 = i2.indexOf(S2, m4 + 1));
+              -1 !== p4 && p4 < m4 + 1 && (p4 = i2.indexOf(S, m4 + 1));
               var y6 = v3(-1 === (g4 = -1 !== g4 && g4 < m4 + 1 ? i2.indexOf(O3, m4 + 1) : g4) ? p4 : Math.min(p4, g4));
-              if (i2.substr(m4 + 1 + y6, e) === S2) {
-                d3.push(i2.substring(z3, m4).replace(_3, F4)), i2[z3 = m4 + 1 + y6 + e] !== F4 && (m4 = i2.indexOf(F4, z3)), p4 = i2.indexOf(S2, z3), g4 = i2.indexOf(O3, z3);
+              if (i2.substr(m4 + 1 + y6, e) === S) {
+                d3.push(i2.substring(z3, m4).replace(_3, F4)), i2[z3 = m4 + 1 + y6 + e] !== F4 && (m4 = i2.indexOf(F4, z3)), p4 = i2.indexOf(S, z3), g4 = i2.indexOf(O3, z3);
                 break;
               }
               y6 = v3(g4);
               if (i2.substring(m4 + 1 + y6, m4 + 1 + y6 + s2) === O3) {
-                if (d3.push(i2.substring(z3, m4).replace(_3, F4)), b5(m4 + 1 + y6 + s2), p4 = i2.indexOf(S2, z3), m4 = i2.indexOf(F4, z3), o2 && (R2(), M2)) return w2();
-                if (A && h4.length >= A) return w2(true);
+                if (d3.push(i2.substring(z3, m4).replace(_3, F4)), b5(m4 + 1 + y6 + s2), p4 = i2.indexOf(S, z3), m4 = i2.indexOf(F4, z3), o2 && (R2(), M2)) return w3();
+                if (A && h4.length >= A) return w3(true);
                 break;
               }
               u4.push({ type: "Quotes", code: "InvalidQuotes", message: "Trailing quote on quoted field is malformed", row: h4.length, index: z3 }), m4++;
             }
           }
           else if (x4 && 0 === d3.length && i2.substring(z3, z3 + a5) === x4) {
-            if (-1 === g4) return w2();
-            z3 = g4 + s2, g4 = i2.indexOf(O3, z3), p4 = i2.indexOf(S2, z3);
-          } else if (-1 !== p4 && (p4 < g4 || -1 === g4)) d3.push(i2.substring(z3, p4)), z3 = p4 + e, p4 = i2.indexOf(S2, z3);
+            if (-1 === g4) return w3();
+            z3 = g4 + s2, g4 = i2.indexOf(O3, z3), p4 = i2.indexOf(S, z3);
+          } else if (-1 !== p4 && (p4 < g4 || -1 === g4)) d3.push(i2.substring(z3, p4)), z3 = p4 + e, p4 = i2.indexOf(S, z3);
           else {
             if (-1 === g4) break;
-            if (d3.push(i2.substring(z3, g4)), b5(g4 + s2), o2 && (R2(), M2)) return w2();
-            if (A && h4.length >= A) return w2(true);
+            if (d3.push(i2.substring(z3, g4)), b5(g4 + s2), o2 && (R2(), M2)) return w3();
+            if (A && h4.length >= A) return w3(true);
           }
           return E5();
           function k2(e2) {
@@ -270,30 +270,30 @@ var require_papaparse_min = __commonJS({
             return t2 = -1 !== e2 && (e2 = i2.substring(m4 + 1, e2)) && "" === e2.trim() ? e2.length : t2;
           }
           function E5(e2) {
-            return r2 || (void 0 === e2 && (e2 = i2.substring(z3)), d3.push(e2), z3 = n2, k2(d3), o2 && R2()), w2();
+            return r2 || (void 0 === e2 && (e2 = i2.substring(z3)), d3.push(e2), z3 = n2, k2(d3), o2 && R2()), w3();
           }
           function b5(e2) {
             z3 = e2, k2(d3), d3 = [], g4 = i2.indexOf(O3, z3);
           }
-          function w2(e2) {
+          function w3(e2) {
             if (C.header && !t && h4.length && !L2) {
               var s4 = h4[0], a6 = /* @__PURE__ */ Object.create(null), o4 = new Set(s4);
               let n4 = false;
               for (let r4 = 0; r4 < s4.length; r4++) {
-                let i4 = P2(s4[r4]);
+                let i4 = P4(s4[r4]);
                 if (a6[i4 = q4(C.transformHeader) ? C.transformHeader(i4, r4) : i4]) {
                   let e4, t2 = a6[i4];
                   for (; e4 = i4 + "_" + t2, t2++, o4.has(e4); ) ;
-                  o4.add(e4), s4[r4] = e4, a6[i4]++, n4 = true, (D4 = null === D4 ? {} : D4)[e4] = i4;
+                  o4.add(e4), s4[r4] = e4, a6[i4]++, n4 = true, (D3 = null === D3 ? {} : D3)[e4] = i4;
                 } else a6[i4] = 1, s4[r4] = i4;
                 o4.add(i4);
               }
               n4 && console.warn("Duplicate headers found and renamed."), L2 = true;
             }
-            return { data: h4, errors: u4, meta: { delimiter: S2, linebreak: O3, aborted: M2, truncated: !!e2, cursor: f5 + (t || 0), renamedHeaders: D4 } };
+            return { data: h4, errors: u4, meta: { delimiter: S, linebreak: O3, aborted: M2, truncated: !!e2, cursor: f5 + (t || 0), renamedHeaders: D3 } };
           }
           function R2() {
-            I2(w2()), h4 = [], u4 = [];
+            I2(w3()), h4 = [], u4 = [];
           }
         }, this.abort = function() {
           M2 = true;
@@ -339,7 +339,7 @@ var require_papaparse_min = __commonJS({
       return v2.parse = function(e, t) {
         var i2 = (t = t || {}).dynamicTyping || false;
         q4(i2) && (t.dynamicTypingFunction = i2, i2 = {});
-        if (t.dynamicTyping = i2, t.transform = !!q4(t.transform) && t.transform, !t.worker || !v2.WORKERS_SUPPORTED) return i2 = null, v2.NODE_STREAM_INPUT, "string" == typeof e ? (e = P2(e), i2 = new (t.download ? f4 : c2)(t)) : true === e.readable && q4(e.read) && q4(e.on) ? i2 = new p2(t) : (n.File && e instanceof File || e instanceof Object) && (i2 = new l(t)), i2.stream(e);
+        if (t.dynamicTyping = i2, t.transform = !!q4(t.transform) && t.transform, !t.worker || !v2.WORKERS_SUPPORTED) return i2 = null, v2.NODE_STREAM_INPUT, "string" == typeof e ? (e = P4(e), i2 = new (t.download ? f4 : c2)(t)) : true === e.readable && q4(e.read) && q4(e.on) ? i2 = new p2(t) : (n.File && e instanceof File || e instanceof Object) && (i2 = new l(t)), i2.stream(e);
         (i2 = (() => {
           var e2;
           return !!v2.WORKERS_SUPPORTED && (e2 = (() => {
@@ -435,12 +435,13 @@ var require_papaparse_min = __commonJS({
 });
 
 // src/contract.ts
-var HOST_CONTRACT_VERSION = "1.11.0";
+var HOST_CONTRACT_VERSION = "1.12.0";
 var GEO_POINT_PRECISIONS = ["latlon", "city", "zip3", "state", "country"];
 var MARK_CLASS = "d3-mark";
 var LEGEND_MARK_CLASS = "d3-legend-mark";
 var AXIS_FILTER_CLASS = "d3-axis-filter";
 var LIFT_SELECTED_CLASS = "d3-lift-selected";
+var CONTROL_CLASS = "lch-control";
 var ROW_IDX_ATTR = "data-row-idx";
 var XFILTER_REFRESH_EVENT = "llm-xfilter-refresh";
 var CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
@@ -507,11 +508,11 @@ function f(t) {
   return t > EPS ? Math.cbrt(t) : (KAPPA * t + 16) / 116;
 }
 function rgbToLab(r, g3, b4) {
-  const R2 = linearise(r), G3 = linearise(g3), B2 = linearise(b4);
-  const X2 = 0.4124564 * R2 + 0.3575761 * G3 + 0.1804375 * B2;
-  const Y2 = 0.2126729 * R2 + 0.7151522 * G3 + 0.072175 * B2;
-  const Z2 = 0.0193339 * R2 + 0.119192 * G3 + 0.9503041 * B2;
-  const fx = f(X2 / Xn), fy = f(Y2 / Yn), fz = f(Z2 / Zn);
+  const R2 = linearise(r), G2 = linearise(g3), B2 = linearise(b4);
+  const X2 = 0.4124564 * R2 + 0.3575761 * G2 + 0.1804375 * B2;
+  const Y2 = 0.2126729 * R2 + 0.7151522 * G2 + 0.072175 * B2;
+  const Z3 = 0.0193339 * R2 + 0.119192 * G2 + 0.9503041 * B2;
+  const fx = f(X2 / Xn), fy = f(Y2 / Yn), fz = f(Z3 / Zn);
   return { L: 116 * fy - 16, a: 500 * (fx - fy), b: 200 * (fy - fz) };
 }
 function hexToLab(hex2) {
@@ -527,8 +528,8 @@ function deltaE2000(c1, c2) {
   const C1 = Math.hypot(c1.a, c1.b), C2 = Math.hypot(c2.a, c2.b);
   const Cbar = (C1 + C2) / 2;
   const C7 = Math.pow(Cbar, 7);
-  const G3 = 0.5 * (1 - Math.sqrt(C7 / (C7 + Math.pow(25, 7))));
-  const a1p = (1 + G3) * c1.a, a2p = (1 + G3) * c2.a;
+  const G2 = 0.5 * (1 - Math.sqrt(C7 / (C7 + Math.pow(25, 7))));
+  const a1p = (1 + G2) * c1.a, a2p = (1 + G2) * c2.a;
   const C1p = Math.hypot(a1p, c1.b), C2p = Math.hypot(a2p, c2.b);
   const neutral = C1p < NEUTRAL_CHROMA || C2p < NEUTRAL_CHROMA;
   const h1p = C1p < NEUTRAL_CHROMA ? 0 : (Math.atan2(c1.b, a1p) * DEG + 360) % 360;
@@ -568,11 +569,11 @@ function labToHex(lab) {
   const fy = (lab.L + 16) / 116, fx = fy + lab.a / 500, fz = fy - lab.b / 200;
   const X2 = Xn * finv(fx);
   const Y2 = Yn * (lab.L > KAPPA * EPS ? fy * fy * fy : lab.L / KAPPA);
-  const Z2 = Zn * finv(fz);
+  const Z3 = Zn * finv(fz);
   const lin = [
-    3.2404542 * X2 - 1.5371385 * Y2 - 0.4985314 * Z2,
-    -0.969266 * X2 + 1.8760108 * Y2 + 0.041556 * Z2,
-    0.0556434 * X2 - 0.2040259 * Y2 + 1.0572252 * Z2
+    3.2404542 * X2 - 1.5371385 * Y2 - 0.4985314 * Z3,
+    -0.969266 * X2 + 1.8760108 * Y2 + 0.041556 * Z3,
+    0.0556434 * X2 - 0.2040259 * Y2 + 1.0572252 * Z3
   ];
   return "#" + lin.map((v2) => {
     const c2 = Math.max(0, Math.min(1, v2));
@@ -1237,20 +1238,20 @@ function A3(n) {
   if (r && i && c3(r) !== i && (r = null), n.city !== void 0 && n.city !== null) {
     let a4 = u(String(n.city)), s = O(a4), f4 = s ? F(s, n.mapKind) : null;
     if (f4 && f4.length) {
-      let d2 = n.state === void 0 || n.state === null ? "" : String(n.state).trim(), R2 = d2 ? u(d2) : "", g3 = d2 ? Y(d2) : null, S2 = [], m2 = -1;
+      let d2 = n.state === void 0 || n.state === null ? "" : String(n.state).trim(), R2 = d2 ? u(d2) : "", g3 = d2 ? Y(d2) : null, S = [], m2 = -1;
       for (let c2 of f4) {
         let l = c2.row, A = 0;
         if (d2 && l.a1 !== "") if (g3 && l.a1 === g3 || u(l.a1) === R2) A++;
         else continue;
         if (i) if (T(l.cc) === i) A++;
         else continue;
-        A > m2 ? (m2 = A, S2 = [c2]) : A === m2 && S2.push(c2);
+        A > m2 ? (m2 = A, S = [c2]) : A === m2 && S.push(c2);
       }
-      S2.some((c2) => c2.primary) && (S2 = S2.filter((c2) => c2.primary));
+      S.some((c2) => c2.primary) && (S = S.filter((c2) => c2.primary));
       let p2 = /* @__PURE__ */ new Map();
-      for (let c2 of S2) p2.set(c2.row.lon.toFixed(2) + "," + c2.row.lat.toFixed(2), c2.row);
+      for (let c2 of S) p2.set(c2.row.lon.toFixed(2) + "," + c2.row.lat.toFixed(2), c2.row);
       if (p2.size === 1) {
-        let c2 = S2[0].row;
+        let c2 = S[0].row;
         return { lat: c2.lat, lon: c2.lon, precision: "city" };
       }
       if (p2.size > 1) return { ambiguous: true, matches: p2.size };
@@ -1273,7 +1274,7 @@ 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(), a4 = [], s = /* @__PURE__ */ new Set(), f4 = [], d2 = /* @__PURE__ */ new Set(), R2 = [], g3 = { 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(), a4 = [], s = /* @__PURE__ */ new Set(), f4 = [], d2 = /* @__PURE__ */ new Set(), R2 = [], g3 = { 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], C = A3({ ...A, mapKind: e });
     if (S3(C)) {
@@ -1281,7 +1282,7 @@ function y3(n, e) {
       let M2 = K(A);
       M2 && !d2.has(M2.toLowerCase()) && (d2.add(M2.toLowerCase()), R2.length < x && R2.push(M2));
     } else if (C) {
-      if (t[l] = C.lat, o[l] = C.lon, i[l] = C.precision, S2++, g3[C.precision]++, (p2 === null || G[C.precision] > G[p2]) && (p2 = C.precision), G[C.precision] > G.city) {
+      if (t[l] = C.lat, o[l] = C.lon, i[l] = C.precision, S++, g3[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()), f4.length < x && f4.push(M2));
       }
@@ -1292,7 +1293,7 @@ function y3(n, e) {
     }
   }
   let c2 = !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: g3, coarseExamples: f4, unmatched: a4, ambiguousRows: m2, ambiguousExamples: R2, matchedRows: S2, totalRows: n.length, ...c2 ? { cityTableMissing: true } : {} };
+  return { lat: t, lon: o, precisions: i, precision: p2, precisionCounts: g3, coarseExamples: f4, unmatched: a4, ambiguousRows: m2, ambiguousExamples: R2, matchedRows: S, totalRows: n.length, ...c2 ? { 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(", ");
@@ -1558,147 +1559,147 @@ var ct2 = new RegExp([String.raw`\bisMeasure\b`, String.raw`\bdataType\b`, Strin
 
 // ../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 F3 = 2;
-var q3 = 400;
-function E2(i) {
-  return !!E(i);
-}
-function S(i) {
-  let n = /* @__PURE__ */ new Set();
-  for (let t of i) {
+var E2 = 2;
+var Z2 = 400;
+function O2(o) {
+  return !!E(o);
+}
+function P2(o) {
+  let e = /* @__PURE__ */ new Set();
+  for (let t of o) {
     if (t == null) continue;
-    let r = u(String(t));
-    if (!V(r) && !n.has(r) && (n.add(r), n.size >= q3)) break;
+    let i = u(String(t));
+    if (!V(i) && !e.has(i) && (e.add(i), e.size >= Z2)) break;
   }
-  return Array.from(n);
+  return Array.from(e);
 }
-function x3(i) {
-  let n = S(i);
-  if (n.length === 0 || O2(i) < 95) return false;
-  let t = n.filter((c2) => E2(c2) && !Y(c2)).length, r = n.filter((c2) => !E2(c2) && !!Y(c2)).length;
-  return t >= 1 && t >= r;
+function x3(o) {
+  let e = P2(o);
+  if (e.length === 0 || z2(o) < 95) return false;
+  let t = e.filter((c2) => O2(c2) && !Y(c2)).length, i = e.filter((c2) => !O2(c2) && !!Y(c2)).length;
+  return t >= 1 && t >= i;
 }
-function W2(i, n) {
-  if (!Y(i)) return false;
-  let t = E(i);
-  return t ? n === "world" ? true : s3.has(t) : false;
+function j2(o, e) {
+  if (!Y(o)) return false;
+  let t = E(o);
+  return t ? e === "world" ? true : s3.has(t) : false;
 }
-function O2(i) {
-  let n = S(i);
-  if (n.length === 0) return 0;
+function z2(o) {
+  let e = P2(o);
+  if (e.length === 0) return 0;
   let t = 0;
-  for (let r of n) E2(r) && t++;
-  return Math.round(t / n.length * 1e3) / 10;
+  for (let i of e) O2(i) && t++;
+  return Math.round(t / e.length * 1e3) / 10;
 }
-function D3(i) {
-  let n = S(i);
-  if (n.length === 0) return 0;
+function w2(o) {
+  let e = P2(o);
+  if (e.length === 0) return 0;
   let t = 0;
-  for (let r of n) Y(r) && t++;
-  return Math.round(t / n.length * 1e3) / 10;
+  for (let i of e) Y(i) && t++;
+  return Math.round(t / e.length * 1e3) / 10;
 }
-function $2(i) {
-  let n = /* @__PURE__ */ new Set();
-  for (let t of i) {
+function H2(o) {
+  let e = /* @__PURE__ */ new Set();
+  for (let t of o) {
     if (t == null) continue;
-    let r = String(t).trim();
-    if (!V(u(r)) && !n.has(r) && (n.add(r), n.size >= q3)) break;
+    let i = String(t).trim();
+    if (!V(u(i)) && !e.has(i) && (e.add(i), e.size >= Z2)) break;
   }
-  return Array.from(n);
+  return Array.from(e);
 }
-function z2(i) {
-  let n = $2(i);
-  if (n.length === 0) return 0;
+function $2(o) {
+  let e = H2(o);
+  if (e.length === 0) return 0;
   let t = 0;
-  for (let r of n) Z(r).length > 0 && t++;
-  return Math.round(t / n.length * 1e3) / 10;
+  for (let i of e) Z(i).length > 0 && t++;
+  return Math.round(t / e.length * 1e3) / 10;
 }
-function j2(i, n) {
-  return y2(n, rt) ? true : $2(i).some((t) => /^\d{5}(-\d{4})?$/.test(t.replace(/\.0+$/, "")));
+function q3(o, e) {
+  return y2(e, rt) ? true : H2(o).some((t) => /^\d{5}(-\d{4})?$/.test(t.replace(/\.0+$/, "")));
 }
-function yt2(i, n) {
-  let t = S(i);
+function yt2(o, e) {
+  let t = P2(o);
   if (t.length === 0) return 0;
-  let r = 0;
-  for (let c2 of t) p3(c2, n) && r++;
-  return Math.round(r / t.length * 1e3) / 10;
+  let i = 0;
+  for (let c2 of t) p3(c2, e) && i++;
+  return Math.round(i / t.length * 1e3) / 10;
 }
-function G2(i, n) {
+function F3(o, e) {
   let t = 0;
-  for (let r of S(i)) n(r) && t++;
+  for (let i of P2(o)) e(i) && t++;
   return t;
 }
-function Ct(i, n) {
+function Ct(o, e) {
   let t = 0;
-  for (let r of $2(i)) n(r) && t++;
+  for (let i of H2(o)) e(i) && t++;
   return t;
 }
-function ht(i, n, t, r, c2) {
-  let l = [], a4 = [], o = {}, R2 = {}, h3 = new Set(i), f4 = (e) => n.map((s) => s[e]);
-  for (let e of ["city", "country"]) {
-    let s = t?.[e];
-    s && h3.has(s) && (o[e] = s);
+function ht(o, e, t, i, c2) {
+  let u2 = [], a4 = [], r = {}, T3 = {}, h3 = new Set(o), f4 = (n) => e.map((s) => s[n]);
+  for (let n of ["city", "country"]) {
+    let s = t?.[n];
+    s && h3.has(s) && (r[n] = s);
   }
-  let Y2 = new Set(c2 ?? i);
-  for (let e of ["lat", "lon"]) {
-    let s = t?.[e];
-    s && Y2.has(s) && (o[e] = s);
+  let Y2 = new Set(c2 ?? o);
+  for (let n of ["lat", "lon"]) {
+    let s = t?.[n];
+    s && Y2.has(s) && (r[n] = s);
   }
   let g3 = t?.zip;
   if (g3 && h3.has(g3)) {
-    let e = f4(g3), s = z2(e);
-    s < 95 ? a4.push(`zip=${g3} (only ${s}% of values read as ZIPs)`) : j2(e, g3) ? o.zip = g3 : a4.push(`zip=${g3} (all values are 3-4 digits with nothing to say they are postal)`);
+    let n = f4(g3), s = $2(n);
+    s < 95 ? a4.push(`zip=${g3} (only ${s}% of values read as ZIPs)`) : q3(n, g3) ? r.zip = g3 : a4.push(`zip=${g3} (all values are 3-4 digits with nothing to say they are postal)`);
   }
   let p2 = t?.state;
   if (p2 && h3.has(p2)) {
-    let e = f4(p2), s = S(e);
-    s.length > 0 && s.every((u2) => W2(u2, r)) ? a4.push(`state=${p2} (every value is "CA", which is both Canada and California)`) : x3(e) ? (a4.push(`state=${p2} (every value is a country, not a state)`), o.country || (o.country = p2)) : D3(e) < 95 ? a4.push(`state=${p2} (only ${D3(e)}% of values are states/provinces)`) : o.state = p2;
+    let n = f4(p2), s = P2(n);
+    s.length > 0 && s.every((l) => j2(l, i)) ? a4.push(`state=${p2} (every value is "CA", which is both Canada and California)`) : x3(n) ? (a4.push(`state=${p2} (every value is a country, not a state)`), r.country || (r.country = p2)) : w2(n) < 95 ? a4.push(`state=${p2} (only ${w2(n)}% of values are states/provinces)`) : r.state = p2;
   }
-  let y5 = new Set(Object.values(o).filter(Boolean)), A = i.filter((e) => !y5.has(e) && !e.startsWith("__"));
-  if (!o.state) {
-    let e = null;
+  let y5 = new Set(Object.values(r).filter(Boolean)), A = o.filter((n) => !y5.has(n) && !n.startsWith("__"));
+  if (!r.state) {
+    let n = null;
     for (let s of A) {
-      let u2 = f4(s);
-      if (x3(u2)) continue;
-      let m2 = D3(u2);
+      let l = f4(s);
+      if (x3(l)) continue;
+      let m2 = w2(l);
       if (m2 < 95) continue;
-      let w2 = G2(u2, (T3) => !!Y(T3)), Q3 = G2(u2, (T3) => !!Y(T3) && !W2(T3, r));
-      w2 < F3 && Q3 < 1 || (!e || m2 > e.pct) && (e = { name: s, pct: m2 });
+      let D3 = F3(l, (R2) => !!Y(R2)), ee = F3(l, (R2) => !!Y(R2) && !j2(R2, i));
+      D3 < E2 && ee < 1 || (!n || m2 > n.pct) && (n = { name: s, pct: m2 });
     }
-    e && (o.state = e.name, y5.add(e.name), l.push(`state=${e.name} (${e.pct}% states/provinces)`));
+    n && (r.state = n.name, y5.add(n.name), u2.push(`state=${n.name} (${n.pct}% states/provinces)`));
   }
-  if (!o.zip) for (let e of A) {
-    if (y5.has(e)) continue;
-    let s = f4(e), u2 = z2(s);
-    if (!(u2 < 95) && j2(s, e) && !(Ct(s, (m2) => Z(m2).length > 0) < F3)) {
-      o.zip = e, y5.add(e), l.push(`zip=${e} (${u2}% ZIP codes)`);
+  if (!r.zip) for (let n of A) {
+    if (y5.has(n)) continue;
+    let s = f4(n), l = $2(s);
+    if (!(l < 95) && q3(s, n) && !(Ct(s, (m2) => Z(m2).length > 0) < E2)) {
+      r.zip = n, y5.add(n), u2.push(`zip=${n} (${l}% ZIP codes)`);
       break;
     }
   }
-  let P2 = o.country;
-  if (!P2 || !x3(f4(P2))) {
-    let e = null;
+  let S = r.country;
+  if (!S || !x3(f4(S))) {
+    let n = null;
     for (let s of A) {
       if (y5.has(s) || !x3(f4(s))) continue;
-      let u2 = O2(f4(s));
-      (!e || u2 > e.pct) && (e = { name: s, pct: u2 });
+      let l = z2(f4(s));
+      (!n || l > n.pct) && (n = { name: s, pct: l });
     }
-    e && (P2 && (a4.push(`country=${P2} (only ${O2(f4(P2))}% of values are country identifiers; using ${e.name} instead)`), R2.country = P2), o.country = e.name, y5.add(e.name), l.push(`country=${e.name}`));
+    n && (S && (a4.push(`country=${S} (only ${z2(f4(S))}% of values are country identifiers; using ${n.name} instead)`), T3.country = S), r.country = n.name, y5.add(n.name), u2.push(`country=${n.name}`));
   }
-  if (!o.city) {
-    let e = null;
+  if (!r.city) {
+    let n = null;
     for (let s of A) {
       if (y5.has(s)) continue;
-      let u2 = f4(s), m2 = yt2(u2, r);
-      m2 < m3 || G2(u2, (w2) => p3(w2, r)) < F3 || (!e || m2 > e.pct) && (e = { name: s, pct: m2 });
+      let l = f4(s), m2 = yt2(l, i);
+      m2 < m3 || F3(l, (D3) => p3(D3, i)) < E2 || (!n || m2 > n.pct) && (n = { name: s, pct: m2 });
     }
-    e && (o.city = e.name, l.push(`city=${e.name} (${e.pct}% known cities)`));
+    n && (r.city = n.name, u2.push(`city=${n.name} (${n.pct}% known cities)`));
   }
-  let B2 = o.country ? f4(o.country) : [], _2 = !!o.country && x3(B2), J2 = _2 ? new Set(B2.map((e) => E(e == null ? null : String(e))).filter(Boolean)).size : 0, H2 = _2 && J2 >= 2, L2 = !!(o.lat && o.lon) && n.some((e) => {
-    let s = +String(e[o.lat] ?? "").trim(), u2 = +String(e[o.lon] ?? "").trim();
-    return isFinite(s) && isFinite(u2) && s >= -90 && s <= 90 && u2 >= -180 && u2 <= 180 && String(e[o.lat] ?? "").trim() !== "" && String(e[o.lon] ?? "").trim() !== "";
+  let B2 = r.country ? f4(r.country) : [], k2 = !!r.country && x3(B2), Q3 = k2 ? new Set(B2.map((n) => E(n == null ? null : String(n))).filter(Boolean)).size : 0, K3 = k2 && Q3 >= 2, _2 = !!(r.lat && r.lon) && e.some((n) => {
+    let s = +String(n[r.lat] ?? "").trim(), l = +String(n[r.lon] ?? "").trim();
+    return isFinite(s) && isFinite(l) && s >= -90 && s <= 90 && l >= -180 && l <= 180 && String(n[r.lat] ?? "").trim() !== "" && String(n[r.lon] ?? "").trim() !== "";
   });
-  return o.lat && o.lon && !L2 && a4.push(`lat/lon=${o.lat}/${o.lon} (no row holds a usable coordinate pair)`), o.country && !H2 && !(o.city || o.state || o.zip || L2) && a4.push(_2 ? `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 || H2 || L2) ? o : null, backfilled: l, refused: a4, ...Object.keys(R2).length ? { labelFallback: R2 } : {} };
+  return r.lat && r.lon && !_2 && a4.push(`lat/lon=${r.lat}/${r.lon} (no row holds a usable coordinate pair)`), r.country && !K3 && !(r.city || r.state || r.zip || _2) && a4.push(k2 ? `country=${r.country} (every row resolves to the same country - nothing to place apart)` : `country=${r.country} (values are not country identifiers)`), { bind: !!(r.city || r.state || r.zip || K3 || _2) ? r : null, backfilled: u2, refused: a4, ...Object.keys(T3).length ? { labelFallback: T3 } : {} };
 }
 
 // src/payload.ts
@@ -1992,6 +1993,15 @@ function stripJsComments(code) {
 }
 
 // src/selection.ts
+function isInsideControl(target, container) {
+  let el = target;
+  if (el && el.nodeType !== 1) el = el.parentElement ?? el.parentNode ?? null;
+  while (el && el !== container) {
+    if (el.nodeType === 1 && el.classList?.contains?.(CONTROL_CLASS)) return true;
+    el = el.parentElement ?? el.parentNode ?? null;
+  }
+  return false;
+}
 function createMarkResolver(env) {
   const { root, doc, log } = env;
   const isElement = (t) => {
@@ -2305,13 +2315,13 @@ function censusHitBands(container, doc) {
       if (!OPEN_TAGS.has(tag)) continue;
       const cs = styleOf2(el, ownerDoc);
       const open = isUnfilled(attrOrComputed(el, "fill", cs));
-      const w2 = widthPx(attrOrComputed(el, "stroke-width", cs) || "1");
+      const w3 = widthPx(attrOrComputed(el, "stroke-width", cs) || "1");
       const geom = String(el.getAttribute?.("d") ?? "") || `${tag}#${String(el.getAttribute?.(ROW_IDX_ATTR) ?? "")}`;
       const inert = String(cs?.pointerEvents ?? el.style?.pointerEvents ?? "") === "none";
-      rows.push({ el, geom, w: w2, open, inert });
-      if (isFinite(w2)) {
+      rows.push({ el, geom, w: w3, open, inert });
+      if (isFinite(w3)) {
         const prev = widestByGeom.get(geom);
-        if (prev === void 0 || w2 > prev) widestByGeom.set(geom, w2);
+        if (prev === void 0 || w3 > prev) widestByGeom.set(geom, w3);
       }
     }
     const out = { ...EMPTY3 };
@@ -2482,12 +2492,12 @@ function contentExtentOf(boxes) {
   if (usable.length === 0) return { w: 0, h: 0, source: "none" };
   const inFlow = usable.filter((b4) => !b4.floating);
   const counted = inFlow.length > 0 ? inFlow : usable;
-  let w2 = 0, h3 = 0;
+  let w3 = 0, h3 = 0;
   for (const b4 of counted) {
-    if (b4.right > w2) w2 = b4.right;
+    if (b4.right > w3) w3 = b4.right;
     if (b4.bottom > h3) h3 = b4.bottom;
   }
-  return { w: w2, h: h3, source: inFlow.length > 0 ? "in-flow" : "all-floating" };
+  return { w: w3, h: h3, source: inFlow.length > 0 ? "in-flow" : "all-floating" };
 }
 function scrollFitFor(contentW, contentH, viewportW, viewportH, slackPx = SCROLL_SLACK_PX) {
   return {
@@ -2497,8 +2507,8 @@ function scrollFitFor(contentW, contentH, viewportW, viewportH, slackPx = SCROLL
 }
 var FIT_CONTENT_SELECTOR = "text, .d3-mark, .d3-legend-mark";
 var PHANTOM_FRACTION = 0.95;
-function isPhantomBox(w2, h3, refW, refH) {
-  return w2 > refW * PHANTOM_FRACTION || h3 > refH * PHANTOM_FRACTION;
+function isPhantomBox(w3, h3, refW, refH) {
+  return w3 > refW * PHANTOM_FRACTION || h3 > refH * PHANTOM_FRACTION;
 }
 var MAX_FRAME_GROW_FACTOR = 20;
 function planFrameGrow(inkBottomPx, elHeightPx, viewBoxH, ctmScale, slackPx = SCROLL_SLACK_PX, maxFactor = MAX_FRAME_GROW_FACTOR) {
@@ -3555,6 +3565,7 @@ function createChartHost(container, config) {
   const clickSel = `.${MARK_CLASS}[${ROW_IDX_ATTR}], .${LEGEND_MARK_CLASS}[${ROW_IDX_ATTR}], .${AXIS_FILTER_CLASS}[${ROW_IDX_ATTR}]`;
   const onClick = (e) => {
     if (Date.now() - xfAt < XF_ECHO_MS) return;
+    if (isInsideControl(e?.target, container)) return;
     let el = resolver.findMark(e?.target, clickSel, e);
     if (!el) el = resolver.penetrateOverlayAt(e?.clientX, e?.clientY, clickSel);
     if (!el) el = resolver.resolveByGeometry(e?.clientX, e?.clientY, clickSel);
@@ -3812,6 +3823,7 @@ export {
   LEGEND_MARK_CLASS,
   AXIS_FILTER_CLASS,
   LIFT_SELECTED_CLASS,
+  CONTROL_CLASS,
   ROW_IDX_ATTR,
   XFILTER_REFRESH_EVENT,
   CONTAINER_SLOT_ANIM_STOP,
@@ -3872,6 +3884,7 @@ export {
   Jt,
   buildRenderPayload,
   stripJsComments,
+  isInsideControl,
   createMarkResolver,
   ensureCrossfilterHitTargets,
   censusMarks,

package/dist/index.mjs

@@ -27,6 +27,7 @@ import {
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
+  CONTROL_CLASS,
   DARK_TEXT,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
@@ -105,6 +106,7 @@ import {
   invalidSentinelReason,
   isBlankRender,
   isHorizontalLabelRow,
+  isInsideControl,
   isInvalidSentinelError,
   isPhantomBox,
   isPillBackdropAlpha,
@@ -133,7 +135,7 @@ import {
   unpinScrolledAxis,
   valuePlacementFlag,
   withoutViewOnlyKeys
-} from "./chunk-DTAYO46G.mjs";
+} from "./chunk-HC2IREJL.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -2438,6 +2440,7 @@ export {
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
+  CONTROL_CLASS,
   DARK_TEXT,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
@@ -2556,6 +2559,7 @@ export {
   isBlindMarker,
   isExcelDateFormat,
   isHorizontalLabelRow,
+  isInsideControl,
   isInvalidSentinelError,
   isPhantomBox,
   isPillBackdropAlpha,

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-DTAYO46G.mjs";
+} from "./chunk-HC2IREJL.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/types/contract.d.ts

@@ -1,4 +1,4 @@
-export declare const HOST_CONTRACT_VERSION = "1.11.0";
+export declare const HOST_CONTRACT_VERSION = "1.12.0";
 export type GeoPointPrecision = "latlon" | "city" | "zip3" | "state" | "country";
 /** Every valid tier, ordered most precise → coarsest. Runtime form of GeoPointPrecision. */
 export declare const GEO_POINT_PRECISIONS: readonly GeoPointPrecision[];
@@ -11,6 +11,7 @@ export declare const MARK_CLASS = "d3-mark";
 export declare const LEGEND_MARK_CLASS = "d3-legend-mark";
 export declare const AXIS_FILTER_CLASS = "d3-axis-filter";
 export declare const LIFT_SELECTED_CLASS = "d3-lift-selected";
+export declare const CONTROL_CLASS = "lch-control";
 export declare const ROW_IDX_ATTR = "data-row-idx";
 export declare const XFILTER_REFRESH_EVENT = "llm-xfilter-refresh";
 export declare const CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_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 { 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 { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";
 /** REPLACE the bundled city gazetteer with another packed table. Rarely needed — see the
@@ -7,7 +7,7 @@ export declare function registerCityTable(packed: string): void;
 export { buildRenderPayload, type RenderPayload, type GeoPointBinding } from "./payload";
 export { codeReadsDatesInLocalTime, vegaSpecReadsDatesInLocalTime } from "./dateCells";
 export { createChartHost, compileRenderFn, stripEsmExports, requiredD3Plugins, explainRenderFailure, sessionViewStateProvider, noopViewStateProvider, type ChartHost, type ChartHostConfig, type RenderFn } from "./host";
-export { createMarkResolver, type MarkResolver, type MarkResolverEnv } from "./selection";
+export { createMarkResolver, isInsideControl, type MarkResolver, type MarkResolverEnv } from "./selection";
 export { planTrivialChart, compileTrivialSource, type TrivialPlan, type TrivialShapeKind } from "./trivial";
 export { captureSvgSnapshot, svgToDataUrl, svgNaturalSize, rasterizeSvgToPngDataUrl, type SnapshotOptions } from "./snapshot";
 export { shouldReview, buildReviewWire, bareBase64, actionFor, type ReviewGate, type ReviewWire, type ReviewVerdict, type ReviewAction } from "./review";

package/dist/types/selection.d.ts

@@ -1,3 +1,10 @@
+/**
+ * True when a click's target sits inside a reader-operated control the chart drew (CONTROL_CLASS
+ * on the target or an ancestor), looking no further out than `container` - a page that wraps the
+ * whole chart in the class does not make every click a control click. A text node is read through
+ * its parent. A click inside a control is neither a selection nor a click on empty canvas.
+ */
+export declare function isInsideControl(target: EventTarget | Node | null | undefined, container: Element): boolean;
 export interface MarkResolverEnv {
     root: HTMLElement;
     doc: Document;

package/package.json

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