@bicharts/chart-host 0.6.74 → 0.6.76

package/README.md

@@ -267,6 +267,17 @@ would show its selected lines at 38%, which the eye reads as dimmed. Such a char
 painted at full opacity. Undeclared charts are unchanged, so alpha used as an encoding (a depth
 cue, a hierarchy level) is never flattened by a fix meant for another chart.
 
+**Which marks count as selected.** By default a mark is selected when *any* of the rows in its
+`data-row-idx` list is selected, which is what lights a legend swatch together with its series. A
+chart whose marks share rows declares the other rule by stamping
+`data-lch-sel-rule="clicked-marks"` on an element it draws (its own `<svg>`): then exactly the
+marks the reader clicked are selected and every other mark is dimmed, Ctrl/Cmd/Shift-click adds or
+removes a mark, and a selection set from outside lights the marks whose rows equal it. A mark is
+named by `data-mark-key` when it carries one, else by its row list. A word cloud is the case it was
+made for: every word shares a comment with many others, so the default lit most of the cloud on one
+click. The cross-filter sent out is the same under both rules. `onSelectionPaint` reports how each
+paint of a declaring chart decided, including when no mark matched and the default was used.
+
 ## Architecture — three layers, and why it matters if you contribute
 
 Read this before adding code. The package has **three** concerns, and they are independent.

package/dist/{chunk-WNGJUPEI.mjs → chunk-7JWL6LYE.mjs}

@@ -1,7 +1,7 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
 
 // src/contract.ts
-var HOST_CONTRACT_VERSION = "1.13.0";
+var HOST_CONTRACT_VERSION = "1.14.0";
 var GEO_POINT_PRECISIONS = ["latlon", "city", "zip3", "state", "country"];
 var MARK_CLASS = "d3-mark";
 var LEGEND_MARK_CLASS = "d3-legend-mark";
@@ -9,6 +9,9 @@ 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 SELECTION_RULE_ATTR = "data-lch-sel-rule";
+var SELECTION_RULE_CLICKED_MARKS = "clicked-marks";
+var MARK_KEY_ATTR = "data-mark-key";
 var NO_ROW_MARKS_ATTR = "data-lch-no-row-marks";
 var SNAPSHOT_SVG_ATTR = "data-lch-snapshot";
 var XFILTER_REFRESH_EVENT = "llm-xfilter-refresh";
@@ -16,6 +19,7 @@ var CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
 var CONTAINER_SLOT_XF_CLEAR = "__llmXfClear";
 var CONTAINER_SLOT_INITIAL_XF_MARK = "__llmInitialXfMark";
 var CONTAINER_SLOT_UI_STATE = "__lchUiState";
+var CONTAINER_SLOT_CLICKED_MARKS = "__lchClickedMarks";
 var VIEW_ONLY_UI_STATE_KEYS = Object.freeze(["camera", "llmZoom"]);
 function withoutViewOnlyKeys(bag) {
   if (!bag || typeof bag !== "object") return bag;
@@ -74,6 +78,9 @@ export {
   LIFT_SELECTED_CLASS,
   CONTROL_CLASS,
   ROW_IDX_ATTR,
+  SELECTION_RULE_ATTR,
+  SELECTION_RULE_CLICKED_MARKS,
+  MARK_KEY_ATTR,
   NO_ROW_MARKS_ATTR,
   SNAPSHOT_SVG_ATTR,
   XFILTER_REFRESH_EVENT,
@@ -81,6 +88,7 @@ export {
   CONTAINER_SLOT_XF_CLEAR,
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
+  CONTAINER_SLOT_CLICKED_MARKS,
   VIEW_ONLY_UI_STATE_KEYS,
   withoutViewOnlyKeys,
   HOST_CONTAINER_CLASS,

package/dist/{chunk-4FTLE3ZK.mjs → chunk-ZEXMBZHP.mjs}

@@ -20,6 +20,7 @@ import {
   COLOR_SCALE_SELF_CLAMP_PCT_MAX,
   COLOR_SCALE_SELF_CLAMP_PCT_MIN,
   CONTAINER_SLOT_ANIM_STOP,
+  CONTAINER_SLOT_CLICKED_MARKS,
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
@@ -33,18 +34,21 @@ import {
   LEGEND_MARK_CLASS,
   LIFT_SELECTED_CLASS,
   MARK_CLASS,
+  MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
   MAX_MAP_POINTS_DEFAULT,
   NO_ROW_MARKS_ATTR,
   ROW_IDX_ATTR,
   SEASONAL_MARKERS_DEFAULT,
   SELECTION_ACTIVE_CLASS,
+  SELECTION_RULE_ATTR,
+  SELECTION_RULE_CLICKED_MARKS,
   SNAPSHOT_SVG_ATTR,
   VALUE_AXIS_BASELINE_DEFAULT,
   XFILTER_REFRESH_EVENT,
   chartOwnsTimeline,
   periodTickSuppressesFeedback
-} from "./chunk-WNGJUPEI.mjs";
+} from "./chunk-7JWL6LYE.mjs";
 import {
   __commonJS,
   __toESM
@@ -252,69 +256,69 @@ var require_papaparse_min = __commonJS({
         return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
       }
       function E4(C2) {
-        var S2 = (C2 = C2 || {}).delimiter, O4 = C2.newline, x3 = C2.comments, I2 = C2.step, A4 = C2.preview, T = C2.fastMode, D2 = null, L4 = false, F4 = null == C2.quoteChar ? '"' : C2.quoteChar, j4 = F4;
+        var S2 = (C2 = C2 || {}).delimiter, O4 = C2.newline, x3 = C2.comments, I2 = C2.step, A2 = C2.preview, T = C2.fastMode, D2 = null, L4 = false, F4 = null == C2.quoteChar ? '"' : C2.quoteChar, j4 = F4;
         if (void 0 !== C2.escapeChar && (j4 = C2.escapeChar), ("string" != typeof S2 || -1 < v.BAD_DELIMITERS.indexOf(S2)) && (S2 = ","), x3 === S2) throw new Error("Comment character same as delimiter");
         true === x3 ? x3 = "#" : ("string" != typeof x3 || -1 < v.BAD_DELIMITERS.indexOf(x3)) && (x3 = false), "\n" !== O4 && "\r" !== O4 && "\r\n" !== O4 && (O4 = "\n");
-        var z4 = 0, M2 = false;
+        var z2 = 0, M2 = false;
         this.parse = function(i2, t, r4) {
           if ("string" != typeof i2) throw new Error("Input must be a string");
-          var n2 = i2.length, e = S2.length, s4 = O4.length, a4 = x3.length, o5 = q2(I2), h5 = [], u5 = [], d4 = [], f5 = z4 = 0;
+          var n2 = i2.length, e = S2.length, s4 = O4.length, a4 = x3.length, o5 = q2(I2), h5 = [], u5 = [], d4 = [], f5 = z2 = 0;
           if (!i2) return w3();
           if (T || false !== T && -1 === i2.indexOf(F4)) {
             for (var l4 = i2.split(O4), c4 = 0; c4 < l4.length; c4++) {
-              if (d4 = l4[c4], z4 += d4.length, c4 !== l4.length - 1) z4 += O4.length;
+              if (d4 = l4[c4], z2 += d4.length, c4 !== l4.length - 1) z2 += O4.length;
               else if (r4) return w3();
               if (!x3 || d4.substring(0, a4) !== x3) {
                 if (o5) {
                   if (h5 = [], k3(d4.split(S2)), R4(), M2) return w3();
                 } else k3(d4.split(S2));
-                if (A4 && A4 <= c4) return h5 = h5.slice(0, A4), w3(true);
+                if (A2 && A2 <= c4) return h5 = h5.slice(0, A2), w3(true);
               }
             }
             return w3();
           }
-          for (var p5 = i2.indexOf(S2, z4), g6 = i2.indexOf(O4, z4), _5 = new RegExp(U2(j4) + U2(F4), "g"), m5 = i2.indexOf(F4, z4); ; ) if (i2[z4] === F4) for (m5 = z4, z4++; ; ) {
-            if (-1 === (m5 = i2.indexOf(F4, m5 + 1))) return r4 || u5.push({ type: "Quotes", code: "MissingQuotes", message: "Quoted field unterminated", row: h5.length, index: z4 }), E5();
-            if (m5 === n2 - 1) return E5(i2.substring(z4, m5).replace(_5, F4));
+          for (var p5 = i2.indexOf(S2, z2), g6 = i2.indexOf(O4, z2), _5 = new RegExp(U2(j4) + U2(F4), "g"), m5 = i2.indexOf(F4, z2); ; ) if (i2[z2] === F4) for (m5 = z2, z2++; ; ) {
+            if (-1 === (m5 = i2.indexOf(F4, m5 + 1))) return r4 || u5.push({ type: "Quotes", code: "MissingQuotes", message: "Quoted field unterminated", row: h5.length, index: z2 }), E5();
+            if (m5 === n2 - 1) return E5(i2.substring(z2, m5).replace(_5, F4));
             if (F4 === j4 && i2[m5 + 1] === j4) m5++;
             else if (F4 === j4 || 0 === m5 || i2[m5 - 1] !== j4) {
               -1 !== p5 && p5 < m5 + 1 && (p5 = i2.indexOf(S2, m5 + 1));
               var y4 = v2(-1 === (g6 = -1 !== g6 && g6 < m5 + 1 ? i2.indexOf(O4, m5 + 1) : g6) ? p5 : Math.min(p5, g6));
               if (i2.substr(m5 + 1 + y4, e) === S2) {
-                d4.push(i2.substring(z4, m5).replace(_5, F4)), i2[z4 = m5 + 1 + y4 + e] !== F4 && (m5 = i2.indexOf(F4, z4)), p5 = i2.indexOf(S2, z4), g6 = i2.indexOf(O4, z4);
+                d4.push(i2.substring(z2, m5).replace(_5, F4)), i2[z2 = m5 + 1 + y4 + e] !== F4 && (m5 = i2.indexOf(F4, z2)), p5 = i2.indexOf(S2, z2), g6 = i2.indexOf(O4, z2);
                 break;
               }
               y4 = v2(g6);
               if (i2.substring(m5 + 1 + y4, m5 + 1 + y4 + s4) === O4) {
-                if (d4.push(i2.substring(z4, m5).replace(_5, F4)), b5(m5 + 1 + y4 + s4), p5 = i2.indexOf(S2, z4), m5 = i2.indexOf(F4, z4), o5 && (R4(), M2)) return w3();
-                if (A4 && h5.length >= A4) return w3(true);
+                if (d4.push(i2.substring(z2, m5).replace(_5, F4)), b5(m5 + 1 + y4 + s4), p5 = i2.indexOf(S2, z2), m5 = i2.indexOf(F4, z2), o5 && (R4(), M2)) return w3();
+                if (A2 && h5.length >= A2) return w3(true);
                 break;
               }
-              u5.push({ type: "Quotes", code: "InvalidQuotes", message: "Trailing quote on quoted field is malformed", row: h5.length, index: z4 }), m5++;
+              u5.push({ type: "Quotes", code: "InvalidQuotes", message: "Trailing quote on quoted field is malformed", row: h5.length, index: z2 }), m5++;
             }
           }
-          else if (x3 && 0 === d4.length && i2.substring(z4, z4 + a4) === x3) {
+          else if (x3 && 0 === d4.length && i2.substring(z2, z2 + a4) === x3) {
             if (-1 === g6) return w3();
-            z4 = g6 + s4, g6 = i2.indexOf(O4, z4), p5 = i2.indexOf(S2, z4);
-          } else if (-1 !== p5 && (p5 < g6 || -1 === g6)) d4.push(i2.substring(z4, p5)), z4 = p5 + e, p5 = i2.indexOf(S2, z4);
+            z2 = g6 + s4, g6 = i2.indexOf(O4, z2), p5 = i2.indexOf(S2, z2);
+          } else if (-1 !== p5 && (p5 < g6 || -1 === g6)) d4.push(i2.substring(z2, p5)), z2 = p5 + e, p5 = i2.indexOf(S2, z2);
           else {
             if (-1 === g6) break;
-            if (d4.push(i2.substring(z4, g6)), b5(g6 + s4), o5 && (R4(), M2)) return w3();
-            if (A4 && h5.length >= A4) return w3(true);
+            if (d4.push(i2.substring(z2, g6)), b5(g6 + s4), o5 && (R4(), M2)) return w3();
+            if (A2 && h5.length >= A2) return w3(true);
           }
           return E5();
           function k3(e2) {
-            h5.push(e2), f5 = z4;
+            h5.push(e2), f5 = z2;
           }
           function v2(e2) {
             var t2 = 0;
             return t2 = -1 !== e2 && (e2 = i2.substring(m5 + 1, e2)) && "" === e2.trim() ? e2.length : t2;
           }
           function E5(e2) {
-            return r4 || (void 0 === e2 && (e2 = i2.substring(z4)), d4.push(e2), z4 = n2, k3(d4), o5 && R4()), w3();
+            return r4 || (void 0 === e2 && (e2 = i2.substring(z2)), d4.push(e2), z2 = n2, k3(d4), o5 && R4()), w3();
           }
           function b5(e2) {
-            z4 = e2, k3(d4), d4 = [], g6 = i2.indexOf(O4, z4);
+            z2 = e2, k3(d4), d4 = [], g6 = i2.indexOf(O4, z2);
           }
           function w3(e2) {
             if (C2.header && !t && h5.length && !L4) {
@@ -339,7 +343,7 @@ var require_papaparse_min = __commonJS({
         }, this.abort = function() {
           M2 = true;
         }, this.getCharIndex = function() {
-          return z4;
+          return z2;
         };
       }
       function g5(e) {
@@ -918,15 +922,15 @@ function resolveAutoColorScale(p4) {
   };
   const candidates = p4.isHighContrast ? [normHex(p4.themeAccent), normHex(p4.themeFg)] : [...palette.map(normHex), normHex(p4.themeAccent), normHex(p4.themeFg)];
   const accent = candidates.find(usable) ?? FALLBACK_ACCENT;
-  const A4 = hexToLab(accent);
+  const A2 = hexToLab(accent);
   let t = 0.1;
-  let low = mixLab(bg, A4, t);
+  let low = mixLab(bg, A2, t);
   while (t < 0.6 && deltaE2000(paintedOver(labToHex(low), canvas, AUTO_RAMP_DRAWN_OPACITY), bg) < SAME_SHADE_DELTA_E) {
     t += 0.02;
-    low = mixLab(bg, A4, t);
+    low = mixLab(bg, A2, t);
   }
   const lowHex = labToHex(low);
-  let high = { ...A4 };
+  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 L4 = Math.max(4, Math.min(98, high.L + (darkCanvas ? 1 : -1)));
@@ -1520,23 +1524,23 @@ function E3(n) {
   if (a3 && i && P3(a3) !== i && (a3 = null), n.city !== void 0 && n.city !== null) {
     let r2 = u2(String(n.city)), s2 = D(r2, R(String(n.city))), c2 = s2 ? _(s2, n.mapKind) : null;
     if (c2 && c2.length) {
-      let d2 = n.state === void 0 || n.state === null ? "" : String(n.state).trim(), T = d2 ? u2(d2) : "", y2 = d2 ? t3(d2) : null, f4 = [], N = -1;
+      let d2 = n.state === void 0 || n.state === null ? "" : String(n.state).trim(), T = d2 ? u2(d2) : "", y2 = d2 ? t3(d2) : null, f4 = [], N2 = -1;
       for (let M2 of c2) {
         let l2 = M2.row, p4 = 0;
         if (d2 && l2.a1 !== "") if (y2 && l2.a1 === y2 || u2(l2.a1) === T) p4++;
         else continue;
         if (i) if (G(l2.cc) === i) p4++;
         else continue;
-        p4 > N ? (N = p4, f4 = [M2]) : p4 === N && f4.push(M2);
+        p4 > N2 ? (N2 = p4, f4 = [M2]) : p4 === N2 && f4.push(M2);
       }
       f4.some((M2) => M2.primary) && (f4 = f4.filter((M2) => M2.primary));
-      let A4 = /* @__PURE__ */ new Map();
-      for (let M2 of f4) A4.set(M2.row.lon.toFixed(2) + "," + M2.row.lat.toFixed(2), M2.row);
-      if (A4.size === 1) {
+      let A2 = /* @__PURE__ */ new Map();
+      for (let M2 of f4) A2.set(M2.row.lon.toFixed(2) + "," + M2.row.lat.toFixed(2), M2.row);
+      if (A2.size === 1) {
         let M2 = f4[0].row;
         return { lat: M2.lat, lon: M2.lon, precision: "city" };
       }
-      if (A4.size > 1) return { ambiguous: true, matches: A4.size };
+      if (A2.size > 1) return { ambiguous: true, matches: A2.size };
     }
   }
   if (!i || L3.has(i)) for (let r2 of r3(n.zip)) {
@@ -1556,15 +1560,15 @@ function E3(n) {
 var b = { latlon: 0, city: 1, zip3: 2, state: 3, country: 4 };
 var e3 = 8;
 function J3(n, e) {
-  let t = new Array(n.length), o4 = new Array(n.length), i = new Array(n.length), a3 = /* @__PURE__ */ new Set(), r2 = [], s2 = /* @__PURE__ */ new Set(), c2 = [], d2 = /* @__PURE__ */ new Set(), T = [], y2 = { latlon: 0, city: 0, zip3: 0, state: 0, country: 0 }, f4 = 0, N = 0, A4 = null;
+  let t = new Array(n.length), o4 = new Array(n.length), i = new Array(n.length), a3 = /* @__PURE__ */ new Set(), r2 = [], s2 = /* @__PURE__ */ new Set(), c2 = [], d2 = /* @__PURE__ */ new Set(), T = [], y2 = { latlon: 0, city: 0, zip3: 0, state: 0, country: 0 }, f4 = 0, N2 = 0, A2 = null;
   for (let l2 = 0; l2 < n.length; ++l2) {
     let p4 = n[l2], C2 = E3({ ...p4, mapKind: e });
     if (B3(C2)) {
-      t[l2] = null, o4[l2] = null, i[l2] = null, N++;
+      t[l2] = null, o4[l2] = null, i[l2] = null, N2++;
       let S2 = W(p4);
       S2 && !d2.has(S2.toLowerCase()) && (d2.add(S2.toLowerCase()), T.length < e3 && T.push(S2));
     } else if (C2) {
-      if (t[l2] = C2.lat, o4[l2] = C2.lon, i[l2] = C2.precision, f4++, y2[C2.precision]++, (A4 === null || b[C2.precision] > b[A4]) && (A4 = C2.precision), b[C2.precision] > b.city) {
+      if (t[l2] = C2.lat, o4[l2] = C2.lon, i[l2] = C2.precision, f4++, y2[C2.precision]++, (A2 === null || b[C2.precision] > b[A2]) && (A2 = C2.precision), b[C2.precision] > b.city) {
         let S2 = W(p4);
         S2 && !s2.has(S2.toLowerCase()) && (s2.add(S2.toLowerCase()), c2.length < e3 && c2.push(S2));
       }
@@ -1575,7 +1579,7 @@ function J3(n, e) {
     }
   }
   let M2 = !C3() && n.some((l2) => l2.city !== null && l2.city !== void 0 && String(l2.city).trim() !== "");
-  return { lat: t, lon: o4, precisions: i, precision: A4, precisionCounts: y2, coarseExamples: c2, unmatched: r2, ambiguousRows: N, ambiguousExamples: T, matchedRows: f4, totalRows: n.length, ...M2 ? { cityTableMissing: true } : {} };
+  return { lat: t, lon: o4, precisions: i, precision: A2, precisionCounts: y2, coarseExamples: c2, unmatched: r2, ambiguousRows: N2, ambiguousExamples: T, matchedRows: f4, totalRows: n.length, ...M2 ? { cityTableMissing: true } : {} };
 }
 function W(n) {
   let e = [n.city, n.state, n.zip, n.country].filter((t) => t != null && String(t).trim() !== "").map((t) => String(t).trim()).join(", ");
@@ -1754,10 +1758,10 @@ function Rn(n, s2) {
   return s2 === "us-zip5" ? w2.has(n.slice(0, 3)) : true;
 }
 function Fn(n, s2) {
-  let o4 = new Array(n.length), r2 = /* @__PURE__ */ new Set(), I2 = [], N = 0;
+  let o4 = new Array(n.length), r2 = /* @__PURE__ */ new Set(), I2 = [], N2 = 0;
   for (let h4 = 0; h4 < n.length; ++h4) {
     let M2 = En(n[h4], s2), O4 = M2 !== null && Rn(M2, s2) ? M2 : null;
-    if (o4[h4] = O4, O4 !== null) N++;
+    if (o4[h4] = O4, O4 !== null) N2++;
     else {
       let d2 = n[h4];
       if (d2 != null) {
@@ -1769,7 +1773,7 @@ function Fn(n, s2) {
       }
     }
   }
-  return { iso: o4, unmatched: I2, matchedRows: N, totalRows: n.length };
+  return { iso: o4, unmatched: I2, matchedRows: N2, totalRows: n.length };
 }
 
 // ../shape-core/dist/chunk-OPDY2YEA.mjs
@@ -1890,10 +1894,10 @@ function F3(e) {
   }
   return Array.from(t);
 }
-function A2(e) {
+function N(e) {
   let t = F3(e);
   if (t.length === 0 || ne2(e) < 95) return false;
-  let n = t.filter((a3) => te(a3) && !t3(a3)).length, o4 = t.filter((a3) => !te(a3) && !!t3(a3)).length;
+  let n = t.filter((l2) => te(l2) && !t3(l2)).length, o4 = t.filter((l2) => !te(l2) && !!t3(l2)).length;
   return n >= 1 && n >= o4;
 }
 function ce3(e, t) {
@@ -1908,7 +1912,7 @@ function ne2(e) {
   for (let o4 of t) te(o4) && n++;
   return Math.round(n / t.length * 1e3) / 10;
 }
-function z2(e) {
+function $4(e) {
   let t = F3(e);
   if (t.length === 0) return 0;
   let n = 0;
@@ -1934,11 +1938,11 @@ function re2(e) {
 function de(e, t) {
   return y(t, fn) ? true : oe2(e).some((n) => /^\d{5}(-\d{4})?$/.test(n.replace(/\.0+$/, "")));
 }
-function Bn2(e, t) {
+function Yn3(e, t) {
   let n = F3(e);
   if (n.length === 0) return 0;
   let o4 = 0;
-  for (let a3 of n) j3(a3, t) && o4++;
+  for (let l2 of n) j3(l2, t) && o4++;
   return Math.round(o4 / n.length * 1e3) / 10;
 }
 function ee3(e, t) {
@@ -1946,18 +1950,18 @@ function ee3(e, t) {
   for (let o4 of F3(e)) t(o4) && n++;
   return n;
 }
-function jn(e, t) {
+function Qn2(e, t) {
   let n = 0;
   for (let o4 of oe2(e)) t(o4) && n++;
   return n;
 }
-function Yn3(e, t, n, o4, a3) {
-  let u4 = [], l2 = [], i = {}, h4 = {}, C2 = new Set(e), y2 = (s2) => t.map((d2) => d2[s2]);
+function Xn2(e, t, n, o4, l2) {
+  let u4 = [], a3 = [], i = {}, h4 = {}, C2 = new Set(e), y2 = (s2) => t.map((d2) => d2[s2]);
   for (let s2 of ["city", "country"]) {
     let d2 = n?.[s2];
     d2 && C2.has(d2) && (i[s2] = d2);
   }
-  let g5 = new Set(a3 ?? e);
+  let g5 = new Set(l2 ?? e);
   for (let s2 of ["lat", "lon"]) {
     let d2 = n?.[s2];
     d2 && g5.has(d2) && (i[s2] = d2);
@@ -1965,67 +1969,67 @@ function Yn3(e, t, n, o4, a3) {
   let f4 = n?.zip;
   if (f4 && C2.has(f4)) {
     let s2 = y2(f4), d2 = re2(s2);
-    d2 < 95 ? l2.push(`zip=${f4} (only ${d2}% of values read as ZIPs)`) : de(s2, f4) ? i.zip = f4 : l2.push(`zip=${f4} (all values are 3-4 digits with nothing to say they are postal)`);
+    d2 < 95 ? a3.push(`zip=${f4} (only ${d2}% of values read as ZIPs)`) : de(s2, f4) ? i.zip = f4 : a3.push(`zip=${f4} (all values are 3-4 digits with nothing to say they are postal)`);
   }
   let c2 = n?.state;
   if (c2 && C2.has(c2)) {
     let s2 = y2(c2), d2 = F3(s2);
-    d2.length > 0 && d2.every((S2) => ce3(S2, o4)) ? l2.push(`state=${c2} (every value is "CA", which is both Canada and California)`) : A2(s2) ? (l2.push(`state=${c2} (every value is a country, not a state)`), i.country || (i.country = c2)) : z2(s2) < 95 ? l2.push(`state=${c2} (only ${z2(s2)}% of values are states/provinces)`) : i.state = c2;
+    d2.length > 0 && d2.every((S2) => ce3(S2, o4)) ? a3.push(`state=${c2} (every value is "CA", which is both Canada and California)`) : N(s2) ? (a3.push(`state=${c2} (every value is a country, not a state)`), i.country || (i.country = c2)) : $4(s2) < 95 ? a3.push(`state=${c2} (only ${$4(s2)}% of values are states/provinces)`) : i.state = c2;
   }
   let p4 = new Set(Object.values(i).filter(Boolean)), b4 = e.filter((s2) => !p4.has(s2) && !s2.startsWith("__"));
   if (!i.state) {
     let s2 = null;
     for (let d2 of b4) {
       let S2 = y2(d2);
-      if (A2(S2)) continue;
-      let P4 = z2(S2);
-      if (P4 < 95) continue;
+      if (N(S2)) continue;
+      let O4 = $4(S2);
+      if (O4 < 95) continue;
       let K3 = ee3(S2, (G4) => !!t3(G4)), Ne = ee3(S2, (G4) => !!t3(G4) && !ce3(G4, o4));
-      K3 < Z3 && Ne < 1 || (!s2 || P4 > s2.pct) && (s2 = { name: d2, pct: P4 });
+      K3 < Z3 && Ne < 1 || (!s2 || O4 > s2.pct) && (s2 = { name: d2, pct: O4 });
     }
     s2 && (i.state = s2.name, p4.add(s2.name), u4.push(`state=${s2.name} (${s2.pct}% states/provinces)`));
   }
   if (!i.zip) for (let s2 of b4) {
     if (p4.has(s2)) continue;
     let d2 = y2(s2), S2 = re2(d2);
-    if (!(S2 < 95) && de(d2, s2) && !(jn(d2, (P4) => r3(P4).length > 0) < Z3)) {
+    if (!(S2 < 95) && de(d2, s2) && !(Qn2(d2, (O4) => r3(O4).length > 0) < Z3)) {
       i.zip = s2, p4.add(s2), u4.push(`zip=${s2} (${S2}% ZIP codes)`);
       break;
     }
   }
   let T = i.country;
-  if (!T || !A2(y2(T))) {
+  if (!T || !N(y2(T))) {
     let s2 = null;
     for (let d2 of b4) {
-      if (p4.has(d2) || !A2(y2(d2))) continue;
+      if (p4.has(d2) || !N(y2(d2))) continue;
       let S2 = ne2(y2(d2));
       (!s2 || S2 > s2.pct) && (s2 = { name: d2, pct: S2 });
     }
-    s2 && (T && (l2.push(`country=${T} (only ${ne2(y2(T))}% of values are country identifiers; using ${s2.name} instead)`), h4.country = T), i.country = s2.name, p4.add(s2.name), u4.push(`country=${s2.name}`));
+    s2 && (T && (a3.push(`country=${T} (only ${ne2(y2(T))}% of values are country identifiers; using ${s2.name} instead)`), h4.country = T), i.country = s2.name, p4.add(s2.name), u4.push(`country=${s2.name}`));
   }
   if (!i.city) {
     let s2 = null;
     for (let d2 of b4) {
       if (p4.has(d2)) continue;
-      let S2 = y2(d2), P4 = Bn2(S2, o4);
-      P4 < D3 || ee3(S2, (K3) => j3(K3, o4)) < Z3 || (!s2 || P4 > s2.pct) && (s2 = { name: d2, pct: P4 });
+      let S2 = y2(d2), O4 = Yn3(S2, o4);
+      O4 < D3 || ee3(S2, (K3) => j3(K3, o4)) < Z3 || (!s2 || O4 > s2.pct) && (s2 = { name: d2, pct: O4 });
     }
     s2 && (i.city = s2.name, u4.push(`city=${s2.name} (${s2.pct}% known cities)`));
   }
-  let O4 = i.country ? y2(i.country) : [], R4 = !!i.country && A2(O4), L4 = R4 ? new Set(O4.map((s2) => k(s2 == null ? null : String(s2))).filter(Boolean)).size : 0, x3 = R4 && L4 >= 2, w3 = !!(i.lat && i.lon) && t.some((s2) => {
+  let L4 = i.country ? y2(i.country) : [], R4 = !!i.country && N(L4), A2 = R4 ? new Set(L4.map((s2) => k(s2 == null ? null : String(s2))).filter(Boolean)).size : 0, x3 = R4 && A2 >= 2, w3 = !!(i.lat && i.lon) && t.some((s2) => {
     let d2 = +String(s2[i.lat] ?? "").trim(), S2 = +String(s2[i.lon] ?? "").trim();
     return isFinite(d2) && isFinite(S2) && d2 >= -90 && d2 <= 90 && S2 >= -180 && S2 <= 180 && String(s2[i.lat] ?? "").trim() !== "" && String(s2[i.lon] ?? "").trim() !== "";
   });
-  return i.lat && i.lon && !w3 && l2.push(`lat/lon=${i.lat}/${i.lon} (no row holds a usable coordinate pair)`), i.country && !x3 && !(i.city || i.state || i.zip || w3) && l2.push(R4 ? `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 || x3 || w3) ? i : null, backfilled: u4, refused: l2, ...Object.keys(h4).length ? { labelFallback: h4 } : {} };
+  return i.lat && i.lon && !w3 && a3.push(`lat/lon=${i.lat}/${i.lon} (no row holds a usable coordinate pair)`), i.country && !x3 && !(i.city || i.state || i.zip || w3) && a3.push(R4 ? `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 || x3 || w3) ? i : null, backfilled: u4, refused: a3, ...Object.keys(h4).length ? { labelFallback: h4 } : {} };
 }
 var r = (e, ...t) => ({ part: e, langs: Object.freeze(t) });
 var ie2 = Object.freeze({ jaar: r("year", "nl"), kwartaal: r("quarter", "nl"), maand: r("month", "nl"), dag: r("day", "nl", "sv", "da", "nb"), jahr: r("year", "de"), quartal: r("quarter", "de"), monat: r("month", "de"), tag: r("day", "de"), ann\u00E9e: r("year", "fr"), mois: r("month", "fr"), jour: r("day", "fr"), trimestre: r("quarter", "fr", "es", "pt", "it"), a\u00F1o: r("year", "es"), mes: r("month", "es"), d\u00EDa: r("day", "es"), ano: r("year", "pt"), m\u00EAs: r("month", "pt"), dia: r("day", "pt"), anno: r("year", "it"), mese: r("month", "it"), giorno: r("day", "it"), \u0433\u043E\u0434: r("year", "ru"), \u043C\u0435\u0441\u044F\u0446: r("month", "ru"), \u0440\u0456\u043A: r("year", "uk"), \u043C\u0456\u0441\u044F\u0446\u044C: r("month", "uk"), \u043A\u0432\u0430\u0440\u0442\u0430\u043B: r("quarter", "ru", "uk"), \u0434\u0435\u043D\u044C: r("day", "ru", "uk"), rok: r("year", "pl", "cs", "sk"), kwarta\u0142: r("quarter", "pl"), miesi\u0105c: r("month", "pl"), dzie\u0144: r("day", "pl"), \u010Dtvrtlet\u00ED: r("quarter", "cs"), m\u011Bs\u00EDc: r("month", "cs"), den: r("day", "cs"), \u0161tvr\u0165rok: r("quarter", "sk"), mesiac: r("month", "sk"), de\u0148: r("day", "sk"), \u00E5r: r("year", "sv", "da", "nb"), kvartal: r("quarter", "sv", "da", "nb"), m\u00E5nad: r("month", "sv"), m\u00E5ned: r("month", "da", "nb"), vuosi: r("year", "fi"), vuosinelj\u00E4nnes: r("quarter", "fi"), kuukausi: r("month", "fi"), p\u00E4iv\u00E4: r("day", "fi"), \u00E9v: r("year", "hu"), negyed\u00E9v: r("quarter", "hu"), h\u00F3nap: r("month", "hu"), nap: r("day", "hu"), y\u0131l: r("year", "tr"), \u00E7eyrek: r("quarter", "tr"), ay: r("month", "tr"), g\u00FCn: r("day", "tr"), \u03AD\u03C4\u03BF\u03C2: r("year", "el"), \u03C4\u03C1\u03AF\u03BC\u03B7\u03BD\u03BF: r("quarter", "el"), \u03BC\u03AE\u03BD\u03B1\u03C2: r("month", "el"), \u03B7\u03BC\u03AD\u03C1\u03B1: r("day", "el"), an: r("year", "ro"), trimestru: r("quarter", "ro"), lun\u0103: r("month", "ro"), zi: r("day", "ro"), godina: r("year", "hr"), tromjese\u010Dje: r("quarter", "hr"), mjesec: r("month", "hr"), dan: r("day", "hr"), \u5E74: r("year", "ja", "zh"), \u56DB\u534A\u671F: r("quarter", "ja"), \u5B63\u5EA6: r("quarter", "zh"), \u6708: r("month", "ja", "zh"), \u65E5: r("day", "ja", "zh"), \uC5F0\uB3C4: r("year", "ko"), \uBD84\uAE30: r("quarter", "ko"), \uC6D4: r("month", "ko"), \uC77C: r("day", "ko"), tahun: r("year", "id"), kuartal: r("quarter", "id"), triwulan: r("quarter", "id"), bulan: r("month", "id"), hari: r("day", "id"), n\u0103m: r("year", "vi"), qu\u00FD: r("quarter", "vi"), th\u00E1ng: r("month", "vi"), ng\u00E0y: r("day", "vi"), \u0E1B\u0E35: r("year", "th"), \u0E44\u0E15\u0E23\u0E21\u0E32\u0E2A: r("quarter", "th"), \u0E40\u0E14\u0E37\u0E2D\u0E19: r("month", "th"), \u0E27\u0E31\u0E19: r("day", "th"), \u0627\u0644\u0633\u0646\u0629: r("year", "ar"), \u0633\u0646\u0629: r("year", "ar"), \u0627\u0644\u0639\u0627\u0645: r("year", "ar"), \u0639\u0627\u0645: r("year", "ar"), \u0627\u0644\u0631\u0628\u0639: r("quarter", "ar"), \u0631\u0628\u0639: r("quarter", "ar"), "\u0631\u0628\u0639 \u0627\u0644\u0633\u0646\u0629": r("quarter", "ar"), \u0627\u0644\u0634\u0647\u0631: r("month", "ar"), \u0634\u0647\u0631: r("month", "ar"), \u0627\u0644\u064A\u0648\u0645: r("day", "ar"), \u064A\u0648\u0645: r("day", "ar"), \u05E9\u05E0\u05D4: r("year", "he"), \u05E8\u05D1\u05E2\u05D5\u05DF: r("quarter", "he"), \u05D7\u05D5\u05D3\u05E9: r("month", "he"), \u05D9\u05D5\u05DD: r("day", "he"), \u0935\u0930\u094D\u0937: r("year", "hi"), \u0938\u093E\u0932: r("year", "hi"), \u0924\u093F\u092E\u093E\u0939\u0940: r("quarter", "hi"), \u092E\u0939\u0940\u0928\u093E: r("month", "hi"), \u092E\u093E\u0939: r("month", "hi"), \u0926\u093F\u0928: r("day", "hi"), \u0633\u0627\u0644: r("year", "fa"), \u0645\u0627\u0647: r("month", "fa"), \u0631\u0648\u0632: r("day", "fa") });
-var Qn2 = Object.freeze(Array.from(new Set(Object.values(ie2).flatMap((e) => e.langs))));
+var Jn = Object.freeze(Array.from(new Set(Object.values(ie2).flatMap((e) => e.langs))));
 var fe = Object.freeze(["fa", "ar", "he", "th"]);
-var wr = Object.freeze({ integer: "number", decimal: "number", double: "number", datetime: "date", date: "date", boolean: "boolean", string: "text" });
-var Nr = Object.freeze({ RENDER_START: "render-start", RENDER_OK: "render-ok", RENDER_ERROR: "render-error", VIEW: "view", VIEW_VERDICT: "view-verdict", REDRAW: "redraw", INTERACT: "interact" });
-var Ar = Object.freeze(["open", "generate", "version", "rebind", "data", "sample", "fix", "resize", "other"]);
-var Le = 2 ** 31 - 1;
+var Pr = Object.freeze({ integer: "number", decimal: "number", double: "number", datetime: "date", date: "date", boolean: "boolean", string: "text" });
+var kr = Object.freeze({ RENDER_START: "render-start", RENDER_OK: "render-ok", RENDER_ERROR: "render-error", VIEW: "view", VIEW_VERDICT: "view-verdict", REDRAW: "redraw", INTERACT: "interact" });
+var Gr = Object.freeze(["open", "generate", "version", "rebind", "data", "sample", "fix", "resize", "other"]);
+var Ae = 2 ** 31 - 1;
 
 // src/payload.ts
 var ROW_IDX_COLUMN = "__rowIdx__";
@@ -2040,7 +2044,7 @@ function resolvePointChannel(cols, rowObjs, point) {
   let labelCol;
   if (bind) {
     const dims = cols.filter((c2) => !c2.isMeasure).map((c2) => c2.name);
-    const res = Yn3(dims, rowObjs, bind, point?.mapKind, cols.map((c2) => c2.name));
+    const res = Xn2(dims, rowObjs, bind, point?.mapKind, cols.map((c2) => c2.name));
     bind = res.bind;
     rolesBackfilled = res.backfilled;
     rolesRefused = res.refused;
@@ -2346,6 +2350,48 @@ function nextSelection(current, rowIdxs, mods = {}) {
   const same = cur.length === rowIdxs.length && rowIdxs.every((r2) => cur.includes(r2));
   return same ? [] : rowIdxs.slice();
 }
+function selectionRuleOf(container) {
+  try {
+    const el = container?.querySelector?.(`[${SELECTION_RULE_ATTR}]`);
+    return el?.getAttribute(SELECTION_RULE_ATTR) === SELECTION_RULE_CLICKED_MARKS ? "clicked-marks" : "any-row";
+  } catch {
+    return "any-row";
+  }
+}
+function markKeyOf(el) {
+  if (!el) return "";
+  const k3 = el.getAttribute(MARK_KEY_ATTR);
+  if (k3 != null && k3 !== "") return k3;
+  return "rows:" + (el.getAttribute(ROW_IDX_ATTR) || "").replace(/\s+/g, "");
+}
+var toSet = (s2) => new Set(Array.from(s2 ?? []));
+function sameRowSet(a3, b4) {
+  const A2 = toSet(a3), B4 = toSet(b4);
+  if (A2.size !== B4.size) return false;
+  for (const r2 of A2) if (!B4.has(r2)) return false;
+  return true;
+}
+function planSelectionPaint(marks, selection, rule, clicked) {
+  const sel = toSet(selection);
+  if (sel.size === 0) return { on: marks.map(() => false), mode: "none", keys: [] };
+  const anyRow = () => marks.map((m4) => m4.rows.some((r2) => sel.has(r2)));
+  if (rule !== "clicked-marks") return { on: anyRow(), mode: "any-row", keys: [] };
+  if (clicked && clicked.keys.length && sameRowSet(clicked.selection, sel)) {
+    const want = new Set(clicked.keys);
+    const on = marks.map((m4) => m4.rows.length > 0 && want.has(m4.key));
+    if (on.some(Boolean)) return { on, mode: "clicked", keys: marks.filter((_4, i) => on[i]).map((m4) => m4.key) };
+  }
+  const exact = marks.map((m4) => m4.rows.length > 0 && sameRowSet(m4.rows, sel));
+  if (exact.some(Boolean)) return { on: exact, mode: "exact", keys: marks.filter((_4, i) => exact[i]).map((m4) => m4.key) };
+  return { on: anyRow(), mode: "fallback-any-row", keys: [] };
+}
+function nextClickedMarks(prev, current, key, next, mods = {}) {
+  if (!next.length) return null;
+  if (!(mods.ctrl || mods.shift)) return { keys: [key], selection: next.slice() };
+  const held = prev && sameRowSet(prev.selection, current) ? prev.keys : [];
+  const keys = held.includes(key) ? held.filter((k3) => k3 !== key) : [...held, key];
+  return { keys, selection: next.slice() };
+}
 function isInsideControl(target, container) {
   let el = target;
   if (el && el.nodeType !== 1) el = el.parentElement ?? el.parentNode ?? null;
@@ -2384,9 +2430,9 @@ function createMarkResolver(env) {
     const m4 = el.getScreenCTM();
     if (!m4) return Number.MAX_VALUE;
     let best = Number.MAX_VALUE;
-    const N = 64;
-    for (let i = 0; i <= N; i++) {
-      const pt2 = el.getPointAtLength(L4 * i / N);
+    const N2 = 64;
+    for (let i = 0; i <= N2; i++) {
+      const pt2 = el.getPointAtLength(L4 * i / N2);
       const dx = m4.a * pt2.x + m4.c * pt2.y + m4.e - x3;
       const dy = m4.b * pt2.x + m4.d * pt2.y + m4.f - y2;
       const d2 = dx * dx + dy * dy;
@@ -2542,14 +2588,14 @@ function collectD3GlyphCenters(container, baseRect, out) {
           const isArcSector = /[Aa]/.test(dAttr) && !/[CcSsQqTt]/.test(dAttr);
           let local;
           if (isArcSector) {
-            const N = 24;
+            const N2 = 24;
             let ax = 0, ay = 0;
-            for (let k3 = 0; k3 < N; k3++) {
-              const sp = el.getPointAtLength(len * k3 / N);
+            for (let k3 = 0; k3 < N2; k3++) {
+              const sp = el.getPointAtLength(len * k3 / N2);
               ax += sp.x;
               ay += sp.y;
             }
-            const cand = new Point(ax / N, ay / N);
+            const cand = new Point(ax / N2, ay / N2);
             let inside = true;
             try {
               if (typeof el.isPointInFill === "function") {
@@ -2828,6 +2874,49 @@ function hitBandFlag(c2) {
   return c2.uncovered > 0 ? "hitband:d3:thin" : "hitband:d3:ok";
 }
 
+// src/clippedText.ts
+var CLIP_TOLERANCE_PX = 1;
+var MAX_REPORTED = 8;
+function censusClippedText(container) {
+  const none = { measured: 0, clipped: [], clippedCount: 0, laidOut: false };
+  try {
+    const svg = container?.querySelector?.("svg");
+    if (!svg) return none;
+    const f4 = svg.getBoundingClientRect();
+    if (!f4 || !(f4.width > 0) || !(f4.height > 0)) return none;
+    const view = svg.ownerDocument?.defaultView;
+    const clipped = [];
+    let measured = 0;
+    for (const t of Array.from(svg.querySelectorAll("text"))) {
+      const r2 = t.getBoundingClientRect();
+      if (!r2 || !(r2.width > 0) || !(r2.height > 0)) continue;
+      const s2 = view?.getComputedStyle?.(t);
+      if (s2 && (s2.display === "none" || s2.visibility === "hidden" || s2.opacity === "0")) continue;
+      measured++;
+      const top = f4.top - r2.top, left = f4.left - r2.left, bottom = r2.bottom - f4.bottom, right = r2.right - f4.right;
+      if (top > CLIP_TOLERANCE_PX || left > CLIP_TOLERANCE_PX || bottom > CLIP_TOLERANCE_PX || right > CLIP_TOLERANCE_PX) {
+        clipped.push({
+          text: String(t.textContent ?? "").slice(0, 40),
+          top: Math.max(0, Math.round(top)),
+          left: Math.max(0, Math.round(left)),
+          bottom: Math.max(0, Math.round(bottom)),
+          right: Math.max(0, Math.round(right))
+        });
+      }
+    }
+    clipped.sort((a3, b4) => Math.max(b4.top, b4.left, b4.bottom, b4.right) - Math.max(a3.top, a3.left, a3.bottom, a3.right));
+    return { measured, clipped: clipped.slice(0, MAX_REPORTED), clippedCount: clipped.length, laidOut: true };
+  } catch {
+    return none;
+  }
+}
+function clippedTextFlag(c2) {
+  if (!c2.laidOut || c2.clippedCount === 0) return "";
+  const worst = c2.clipped[0];
+  const side = ["top", "left", "bottom", "right"].reduce((a3, k3) => worst[k3] > worst[a3] ? k3 : a3, "top");
+  return `${c2.clippedCount} of ${c2.measured} text label(s) are cut off by the frame; the worst, "${worst.text}", by ${worst[side]}px at the ${side}.`;
+}
+
 // src/valuePlacement.ts
 var MIN_MARKS2 = 24;
 var ELEMENT_CAP4 = 5e3;
@@ -4269,6 +4358,13 @@ function createChartHost(container, config) {
   let activeTickEl = null;
   let selectionIsPeriod = false;
   let selectionFromChart = false;
+  const clickedMarks = () => container[CONTAINER_SLOT_CLICKED_MARKS] ?? null;
+  const setClickedMarks = (c2) => {
+    try {
+      container[CONTAINER_SLOT_CLICKED_MARKS] = c2;
+    } catch {
+    }
+  };
   const subs = /* @__PURE__ */ new Set();
   const ensureAffordanceStyles = () => {
     try {
@@ -4340,6 +4436,31 @@ function createChartHost(container, config) {
       if (active && tickStillDrawn) activeTickEl.classList?.add(ACTIVE_TICK_CLASS);
       const wanted = new Set(sel ?? []);
       const marks = container.querySelectorAll(`.${MARK_CLASS}[${ROW_IDX_ATTR}], .${LEGEND_MARK_CLASS}[${ROW_IDX_ATTR}]`);
+      const rule = selectionRuleOf(container);
+      if (rule !== "any-row") {
+        const list = Array.from(marks);
+        const plan = planSelectionPaint(
+          list.map((m4) => ({ key: markKeyOf(m4), rows: parseRowIdxs(m4.getAttribute(ROW_IDX_ATTR)) })),
+          active ? wanted : [],
+          rule,
+          clickedMarks()
+        );
+        list.forEach((m4, i) => m4.classList?.[plan.on[i] ? "add" : "remove"](MARK_SELECTED_CLASS));
+        setClickedMarks(plan.keys.length ? { keys: plan.keys, selection: Array.from(wanted) } : null);
+        if (active) {
+          try {
+            config.onSelectionPaint?.({
+              rule,
+              mode: plan.mode,
+              lit: plan.on.filter(Boolean).length,
+              marks: list.length,
+              selection: wanted.size
+            });
+          } catch {
+          }
+        }
+        return;
+      }
       for (const m4 of Array.from(marks)) {
         const rows = parseRowIdxs(m4.getAttribute(ROW_IDX_ATTR));
         const on = active && rows.some((r2) => wanted.has(r2));
@@ -4401,6 +4522,13 @@ function createChartHost(container, config) {
     const multi = !!(e?.ctrlKey || e?.metaKey || e?.shiftKey);
     const next = nextSelection(current, rows, { ctrl: !!(e?.ctrlKey || e?.metaKey), shift: !!e?.shiftKey });
     const toggledOff = !multi && next.length === 0;
+    setClickedMarks(nextClickedMarks(
+      clickedMarks(),
+      current,
+      markKeyOf(el),
+      next,
+      { ctrl: !!(e?.ctrlKey || e?.metaKey), shift: !!e?.shiftKey }
+    ));
     notify(next, "user", toggledOff ? null : tick);
   };
   container.addEventListener(XFILTER_REFRESH_EVENT, onXf);
@@ -4481,6 +4609,12 @@ function createChartHost(container, config) {
       } catch {
       }
     }
+    if (config.onClippedTextCensus) {
+      try {
+        config.onClippedTextCensus(censusClippedText(container));
+      } catch {
+      }
+    }
     if (config.onValuePlacementCensus) {
       try {
         config.onValuePlacementCensus(censusValuePlacement(container, data));
@@ -4624,6 +4758,7 @@ function createChartHost(container, config) {
           } catch {
           }
         }
+        setClickedMarks(null);
         notify([], "host");
       },
       highlight(rowIdxs) {
@@ -4855,6 +4990,11 @@ export {
   stripJsComments,
   rowIdxsFromMark,
   nextSelection,
+  selectionRuleOf,
+  markKeyOf,
+  sameRowSet,
+  planSelectionPaint,
+  nextClickedMarks,
   isInsideControl,
   createMarkResolver,
   collectD3GlyphCenters,
@@ -4868,6 +5008,9 @@ export {
   MIN_HIT_BAND_PX,
   censusHitBands,
   hitBandFlag,
+  CLIP_TOLERANCE_PX,
+  censusClippedText,
+  clippedTextFlag,
   VALUE_AXIS_MIN_FIT,
   censusValuePlacement,
   valuePlacementFlag,

package/dist/index.mjs

@@ -10,6 +10,7 @@ import {
   AXIS_PIN_MIN_LABELS,
   AXIS_PIN_TRACK_REACH_PX,
   BACKING_MAJORITY,
+  CLIP_TOLERANCE_PX,
   D3_PLUGIN_PACKAGES,
   DARK_TEXT,
   FIT_CONTENT_SELECTOR,
@@ -51,12 +52,14 @@ import {
   blankRenderFlag,
   buildRenderPayload,
   cellSuppressesNormalize,
+  censusClippedText,
   censusColourSpread,
   censusHitBands,
   censusMarks,
   censusValuePlacement,
   clearGeoCache,
   clearSelectionGlyphs,
+  clippedTextFlag,
   collectD3GlyphCenters,
   colourSpreadFlag,
   compileRenderFn,
@@ -88,10 +91,12 @@ import {
   labelBand,
   le,
   loadGeo,
+  markKeyOf,
   measureContainerBoxes,
   minContrastOver,
   needsScroll,
   newIdScope,
+  nextClickedMarks,
   nextSelection,
   noopViewStateProvider,
   o,
@@ -101,6 +106,7 @@ import {
   pinScrolledAxis,
   planAxisPin,
   planFrameGrow,
+  planSelectionPaint,
   qe,
   registerGeo,
   registerGeoAsset,
@@ -109,8 +115,10 @@ import {
   resolveAutoColorScale,
   resolveOptions,
   rowIdxsFromMark,
+  sameRowSet,
   scopeChartIds,
   scrollFitFor,
+  selectionRuleOf,
   sessionViewStateProvider,
   straddleSampleGrid,
   straddles,
@@ -122,7 +130,7 @@ import {
   toSourceRows,
   unpinScrolledAxis,
   valuePlacementFlag
-} from "./chunk-4FTLE3ZK.mjs";
+} from "./chunk-ZEXMBZHP.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -141,6 +149,7 @@ import {
   COLOR_SCALE_SELF_CLAMP_PCT_MAX,
   COLOR_SCALE_SELF_CLAMP_PCT_MIN,
   CONTAINER_SLOT_ANIM_STOP,
+  CONTAINER_SLOT_CLICKED_MARKS,
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
@@ -157,12 +166,15 @@ import {
   LEGEND_MARK_CLASS,
   LIFT_SELECTED_CLASS,
   MARK_CLASS,
+  MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
   MAX_MAP_POINTS_DEFAULT,
   NO_ROW_MARKS_ATTR,
   ROW_IDX_ATTR,
   SEASONAL_MARKERS_DEFAULT,
   SELECTION_ACTIVE_CLASS,
+  SELECTION_RULE_ATTR,
+  SELECTION_RULE_CLICKED_MARKS,
   SNAPSHOT_SVG_ATTR,
   VALUE_AXIS_BASELINE_DEFAULT,
   VIEW_ONLY_UI_STATE_KEYS,
@@ -170,7 +182,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-WNGJUPEI.mjs";
+} from "./chunk-7JWL6LYE.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/optionsVocabulary.ts
@@ -1328,6 +1340,20 @@ function inlineFilterGate(rowCount) {
 }
 var INLINE_FILTER_MIN_ROWS = 8;
 
+// src/qualifyTable.ts
+function qualifyTableRows(rows) {
+  return rows.map((r2) => ({
+    rank: typeof r2.rank === "number" && Number.isFinite(r2.rank) ? r2.rank : null,
+    name: r2.name,
+    preview: r2.isPreview === true,
+    fit: r2.recommended === false ? "can-also-render" : "fits",
+    description: r2.description ?? "",
+    language: r2.language ? r2.language : null,
+    renderer: r2.renderer ? r2.renderer : null,
+    alsoWorthALook: r2.alsoWorthALook === true
+  }));
+}
+
 // src/sourceDateFormat.ts
 function formatSourceDate(raw, opts = {}) {
   const d2 = toDate(raw);
@@ -2873,10 +2899,12 @@ export {
   BACKING_MAJORITY,
   CHOOSER_MIN_HEIGHT_PX,
   CHOOSER_MIN_WIDTH_PX,
+  CLIP_TOLERANCE_PX,
   COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT,
   COLOR_SCALE_SELF_CLAMP_PCT_MAX,
   COLOR_SCALE_SELF_CLAMP_PCT_MIN,
   CONTAINER_SLOT_ANIM_STOP,
+  CONTAINER_SLOT_CLICKED_MARKS,
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
@@ -2915,6 +2943,7 @@ export {
   LIMIT_COUNT_MAX,
   LIVE_OPTION_KEYS,
   MARK_CLASS,
+  MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
   MAX_FRAME_GROW_FACTOR,
   MAX_MAP_POINTS_DEFAULT,
@@ -2949,6 +2978,8 @@ export {
   SEASONAL_MARKERS_DEFAULT,
   SELECTION_ACTIVE_CLASS,
   SELECTION_GLYPH_CLASS,
+  SELECTION_RULE_ATTR,
+  SELECTION_RULE_CLICKED_MARKS,
   SNAPSHOT_SVG_ATTR,
   STRADDLE_COLS,
   STRADDLE_MIN_SHARE,
@@ -2981,6 +3012,7 @@ export {
   canShowLastChart,
   captureSvgSnapshot,
   cellSuppressesNormalize,
+  censusClippedText,
   censusColourSpread,
   censusHitBands,
   censusMarks,
@@ -2990,6 +3022,7 @@ export {
   chooserFitsViewport,
   clearGeoCache,
   clearSelectionGlyphs,
+  clippedTextFlag,
   codeReadsDatesInLocalTime,
   collectD3GlyphCenters,
   colourSpreadFlag,
@@ -3051,6 +3084,7 @@ export {
   listNeedsFilter,
   loadGeo,
   markDefaultModel,
+  markKeyOf,
   markerArmedBlind,
   measureContainerBoxes,
   minContrastOver,
@@ -3059,6 +3093,7 @@ export {
   newIdScope,
   newQualifyGroupState,
   newQualifyRefusalGroupState,
+  nextClickedMarks,
   nextSelection,
   noopViewStateProvider,
   normaliseAggregation,
@@ -3077,6 +3112,7 @@ export {
   pinScrolledAxis,
   planAxisPin,
   planFrameGrow,
+  planSelectionPaint,
   planTrivialChart,
   pollGiveUpKeepsMarker,
   productFeedbackSendable,
@@ -3089,6 +3125,7 @@ export {
   qualifyPick,
   qualifyRefusalHeadingFor,
   qualifyRefusalReason,
+  qualifyTableRows,
   rasterizeSvgToPngDataUrl,
   readQualifyChartRow,
   readQualifyRefusalRow,
@@ -3112,8 +3149,10 @@ export {
   resolveOptions,
   rowIdxsFromMark,
   sameMarker,
+  sameRowSet,
   scopeChartIds,
   scrollFitFor,
+  selectionRuleOf,
   servedCorrelationProves,
   sessionViewStateProvider,
   shouldCaptureThumbnail,

package/dist/react.mjs

@@ -22,9 +22,9 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-4FTLE3ZK.mjs";
+} from "./chunk-ZEXMBZHP.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-WNGJUPEI.mjs";
+import "./chunk-7JWL6LYE.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx

package/dist/testing.mjs

@@ -4,7 +4,7 @@ import {
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-WNGJUPEI.mjs";
+} from "./chunk-7JWL6LYE.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/testing/interact.ts

package/dist/types/clippedText.d.ts

@@ -0,0 +1,24 @@
+export interface ClippedText {
+    text: string;
+    /** Pixels past the frame on each side (0 = inside). */
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+export interface ClippedTextCensus {
+    /** Visible text elements measured. */
+    measured: number;
+    /** Those with any side more than the tolerance outside the frame, worst first, at most MAX_REPORTED. */
+    clipped: ClippedText[];
+    /** How many were clipped in all (can exceed clipped.length). */
+    clippedCount: number;
+    /** False when there was no SVG or no layout (0x0 frame): nothing was measured, and that is not a pass. */
+    laidOut: boolean;
+}
+export declare const CLIP_TOLERANCE_PX = 1;
+export declare const MAX_REPORTED = 8;
+/** Counts only visible text whose box leaves the SVG's box. A host without layout (jsdom) reports laidOut false. */
+export declare function censusClippedText(container: any): ClippedTextCensus;
+/** A one-line verdict for a log or a report; "" when nothing is clipped or nothing could be measured. */
+export declare function clippedTextFlag(c: ClippedTextCensus): string;

package/dist/types/contract.d.ts

@@ -1,4 +1,4 @@
-export declare const HOST_CONTRACT_VERSION = "1.13.0";
+export declare const HOST_CONTRACT_VERSION = "1.14.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[];
@@ -13,6 +13,9 @@ 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 SELECTION_RULE_ATTR = "data-lch-sel-rule";
+export declare const SELECTION_RULE_CLICKED_MARKS = "clicked-marks";
+export declare const MARK_KEY_ATTR = "data-mark-key";
 export declare const NO_ROW_MARKS_ATTR = "data-lch-no-row-marks";
 export declare const SNAPSHOT_SVG_ATTR = "data-lch-snapshot";
 export declare const XFILTER_REFRESH_EVENT = "llm-xfilter-refresh";
@@ -20,6 +23,7 @@ export declare const CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
 export declare const CONTAINER_SLOT_XF_CLEAR = "__llmXfClear";
 export declare const CONTAINER_SLOT_INITIAL_XF_MARK = "__llmInitialXfMark";
 export declare const CONTAINER_SLOT_UI_STATE = "__lchUiState";
+export declare const CONTAINER_SLOT_CLICKED_MARKS = "__lchClickedMarks";
 export declare const VIEW_ONLY_UI_STATE_KEYS: readonly string[];
 /** The bag with every view-only key removed: what a host persists when the reader has not asked
  *  for their view to be remembered. Returns the SAME object when there was nothing to remove. */

package/dist/types/host.d.ts

@@ -1,8 +1,18 @@
 import { type RenderOptions, type ViewStateProvider } from "./contract";
 import { type ResolveOptionsInput } from "./defaults";
+import { type SelectionRule, type SelectionPaintMode } from "./selection";
+/** What onSelectionPaint reports: the declared rule, how this paint decided, and how many marks it lit. */
+export interface SelectionPaintReport {
+    rule: SelectionRule;
+    mode: SelectionPaintMode;
+    lit: number;
+    marks: number;
+    selection: number;
+}
 import { type MarkCensus } from "./blankRender";
 import { type HitBandCensus } from "./hitBands";
 import { type ColourSpreadCensus } from "./colourSpread";
+import { type ClippedTextCensus } from "./clippedText";
 import { type ValuePlacementCensus } from "./valuePlacement";
 import { type FitRenderedChartOptions, type FitRenderedChartResult } from "./fitDom";
 import { type LabelContrastOptions, type LabelContrastReport } from "./labelContrastDom";
@@ -113,6 +123,12 @@ export interface ChartHostConfig {
      * own skew is measured on the raw column while the ramp encodes an aggregate.
      */
     onColourSpreadCensus?: (census: ColourSpreadCensus) => void;
+    /**
+     * IS ANY TEXT CUT OFF BY THE FRAME? Runs after every render, counts only, and never moves anything: a title
+     * drawn above its own origin is clipped without anything throwing, so only a measurement against the SVG box
+     * sees it. A host without layout reports `laidOut: false`, which is not a pass.
+     */
+    onClippedTextCensus?: (census: ClippedTextCensus) => void;
     /**
      * IS EACH DOT DRAWN AT ITS VALUE? Runs after every render, counts only.
      *
@@ -124,6 +140,13 @@ export interface ChartHostConfig {
      * a radius off it. It declines on anything that is not that shape.
      */
     onValuePlacementCensus?: (census: ValuePlacementCensus) => void;
+    /**
+     * HOW A DECLARED SELECTION RULE LIT THE MARKS. Called on every selection paint of a chart that
+     * declares a rule other than the default (SELECTION_RULE_ATTR), never for one that declares none.
+     * `mode` "fallback-any-row" means no clicked or exactly-matching mark was found for the selection,
+     * so the default rule lit the chart for that paint: worth a log line.
+     */
+    onSelectionPaint?: (report: SelectionPaintReport) => void;
     /** This chart declares time keyframes: frame one is allowed to be empty, so no blank verdict
      *  is issued for it. */
     animated?: boolean;

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, CONTROL_CLASS, NO_ROW_MARKS_ATTR, SNAPSHOT_SVG_ATTR, 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, FLIP_INTERVAL_MIN_MS, FLIP_INTERVAL_MAX_MS, FLIP_DIRECTION_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type FlipDirection, 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, NO_ROW_MARKS_ATTR, SELECTION_RULE_ATTR, SELECTION_RULE_CLICKED_MARKS, MARK_KEY_ATTR, CONTAINER_SLOT_CLICKED_MARKS, SNAPSHOT_SVG_ATTR, 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, FLIP_INTERVAL_MIN_MS, FLIP_INTERVAL_MAX_MS, FLIP_DIRECTION_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type FlipDirection, 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";
@@ -7,13 +7,13 @@ export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clea
 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, assembleD3, D3_PLUGIN_PACKAGES, type ChartHost, type ChartHostConfig, type RenderFn } from "./host";
+export { createChartHost, compileRenderFn, stripEsmExports, requiredD3Plugins, explainRenderFailure, sessionViewStateProvider, noopViewStateProvider, assembleD3, D3_PLUGIN_PACKAGES, type ChartHost, type ChartHostConfig, type RenderFn, type SelectionPaintReport } from "./host";
 export { ANNOTATION_CLASS, ANNOTATION_LAYER_CLASS, type MarkAnnotation, type AnnotationReport } from "./annotations";
 export type { MarkNoteLike, NoteBadgeOptions } from "./markNotes";
 export type { Controls, ControlInfo, ControlsAttachment } from "./controls";
 export { createChartGroup, toSourceRows, syncMemberSelection, type ChartGroup, type ChartGroupMember, type ChartGroupSelection, type ChartGroupChange, type ChartGroupMemberOptions, type ChartGroupSourceOptions, type ChartGroupPayload } from "./group";
 export type { Filter, FilterScope, FilterOptions, FilterKey, FilterChangeReason, FilterBinding, BindFilterOptions, VegaInteractionEvent, PageView } from "./filterScope";
-export { createMarkResolver, isInsideControl, rowIdxsFromMark, nextSelection, collectD3GlyphCenters, clearSelectionGlyphs, paintSelectionGlyphs, SELECTION_GLYPH_CLASS, type MarkResolver, type MarkResolverEnv, type GlyphCenter, type SelectionGlyphStyle, type SelectionModifiers, } from "./selection";
+export { createMarkResolver, isInsideControl, rowIdxsFromMark, nextSelection, selectionRuleOf, markKeyOf, planSelectionPaint, nextClickedMarks, sameRowSet, type SelectionRule, type ClickedMarks, type SelectionPaintMark, type SelectionPaintMode, type SelectionPaintPlan, collectD3GlyphCenters, clearSelectionGlyphs, paintSelectionGlyphs, SELECTION_GLYPH_CLASS, type MarkResolver, type MarkResolverEnv, type GlyphCenter, type SelectionGlyphStyle, type SelectionModifiers, } from "./selection";
 export { planTrivialChart, compileTrivialSource, type TrivialPlan, type TrivialShapeKind } from "./trivial";
 export { captureSvgSnapshot, svgToDataUrl, svgNaturalSize, rasterizeSvgToPngDataUrl, tableHostOf, chartSvgOf, htmlToSvgDataUrl, htmlNaturalSize, type SnapshotOptions } from "./snapshot";
 export { shouldReview, buildReviewWire, bareBase64, actionFor, type ReviewGate, type ReviewWire, type ReviewVerdict, type ReviewAction } from "./review";
@@ -22,6 +22,7 @@ export { mountProductFeedbackBox, normaliseProductFeedbackText, productFeedbackS
 export { qualifyGroupHeadingFor, newQualifyGroupState, type QualifyGroupRow, type QualifyGroupState, type QualifyGroupHeading, orderRefusalsForDisplay, refusalIsSelectable, hasRefusalsToShow, qualifyRefusalHeadingFor, newQualifyRefusalGroupState, qualifyRefusalReason, QUALIFY_REFUSAL_UNSPECIFIED, type QualifyRefusalRow, type QualifyRefusalGroupState, type QualifyRefusalHeading, } from "./qualifyGroups";
 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 { normalizeFilterTerm, filterQualifyRows, readQualifyChartRow, readQualifyRefusalRow, DEFAULT_FILTER_MATCH_STYLE, filterMatchStyleOf, type FilterMatchStyle, filterFitsChooser, listNeedsFilter, qualifyFilterGate, inlineFilterGate, FILTER_MIN_TERM_CHARS, FILTER_ROW_PX, FILTER_MIN_WIDTH_PX, FILTER_MIN_HEIGHT_PX, INLINE_FILTER_MIN_ROWS, computeQualifyFilterView, qualifyFilterCountText, type QualifyFilterTier, type QualifyFilterResult, type QualifyFilterRead, type QualifyFilterGateReason, type QualifyFilterGateInput, type QualifyFilterRow, type QualifyFilterGroup, type QualifyFilterView, type QualifyFilterNoteKind, } from "./qualifyFilter";
+export { qualifyTableRows, type QualifyTableRow, type QualifyTableSource } from "./qualifyTable";
 export { computeSelectionCard, normaliseAggregation, type SelectionCardModel, type SelectionCardLine, type SelectionCardOptions, } from "./selectionCard";
 export { formatSourceDate, formatSourceDateFor, isExcelDateFormat, type SourceFormats, type SourceFormatDialect, type SourceDateOptions, } from "./sourceDateFormat";
 export { composeSummaryText } from "./summaryText";
@@ -32,6 +33,7 @@ export { decideLabelColor, toRGBA, compositeOver, relativeLuminance, contrastRat
 export { censusMarks, isBlankRender, blankRenderFlag, type MarkCensus, type BlankVerdictInput } from "./blankRender";
 export { isInvalidSentinelError, invalidSentinelReason } from "./invalidSentinel";
 export { censusHitBands, hitBandFlag, MIN_HIT_BAND_PX, type HitBandCensus } from "./hitBands";
+export { censusClippedText, clippedTextFlag, CLIP_TOLERANCE_PX, type ClippedTextCensus, type ClippedText } from "./clippedText";
 export { censusColourSpread, colourSpreadFlag, SAME_SHADE_DELTA_E, MIN_RAMP_FILLS, type ColourSpreadCensus } from "./colourSpread";
 export { censusValuePlacement, valuePlacementFlag, VALUE_AXIS_MIN_FIT, type ValuePlacementCensus } from "./valuePlacement";
 export { SCROLL_SLACK_PX, MAX_FRAME_GROW_FACTOR, PHANTOM_FRACTION, FIT_CONTENT_SELECTOR, needsScroll, contentExtentOf, scrollFitFor, planFrameGrow, isPhantomBox, type MeasuredBox, type ContentExtent, type ScrollFit, type FrameGrowPlan, } from "./fit";

package/dist/types/qualifyTable.d.ts

@@ -0,0 +1,27 @@
+/** What a what-fits row must carry to become a table row (the shape-core parse result satisfies it). */
+export interface QualifyTableSource {
+    name: string;
+    description?: string | null;
+    rank?: number | null;
+    language?: string | null;
+    renderer?: string | null;
+    recommended?: boolean | null;
+    isPreview?: boolean | null;
+    alsoWorthALook?: boolean | null;
+}
+export interface QualifyTableRow {
+    /** The position in the order asked for, or null for a row the server did not rank. */
+    rank: number | null;
+    name: string;
+    /** True for a newer, less proven type (still selectable by name). */
+    preview: boolean;
+    /** "fits" = the ontology judges it a fit for this data; "can-also-render" = it can draw this, but it is a weaker fit. */
+    fit: "fits" | "can-also-render";
+    description: string;
+    language: string | null;
+    renderer: string | null;
+    /** One of the "something different" picks drawn from below the top fits. */
+    alsoWorthALook: boolean;
+}
+/** The rows as table rows, in the order given (the server's order IS the ranking). */
+export declare function qualifyTableRows(rows: readonly QualifyTableSource[]): QualifyTableRow[];

package/dist/types/selection.d.ts

@@ -25,6 +25,63 @@ export interface SelectionModifiers {
  * clear from elsewhere, a re-derived selection), and the next click on the mark then did nothing.
  */
 export declare function nextSelection(current: Iterable<number> | null | undefined, rowIdxs: readonly number[], mods?: SelectionModifiers): number[];
+/**
+ * HOW A SELECTION LIGHTS A CHART'S OWN MARKS (see SELECTION_RULE_ATTR in contract.ts).
+ * "any-row": a mark is lit when any of its rows is selected - the default, and what every chart
+ * that declares nothing gets. "clicked-marks": the marks the reader clicked are lit and every other
+ * mark is dimmed - for a chart whose marks share rows, where any-row lights most of the chart.
+ */
+export type SelectionRule = "any-row" | "clicked-marks";
+/** The rule the chart in `container` declared, read off any element it drew; "any-row" when none. */
+export declare function selectionRuleOf(container: Element | null | undefined): SelectionRule;
+/**
+ * A mark's identity under "clicked-marks": its MARK_KEY_ATTR when it carries one, else its
+ * data-row-idx list (prefixed, so a key can never be mistaken for a row list).
+ */
+export declare function markKeyOf(el: Element | null | undefined): string;
+/** The marks the reader clicked under "clicked-marks", and the selection those clicks left. */
+export interface ClickedMarks {
+    keys: string[];
+    selection: number[];
+}
+/** One mark as the paint plan sees it. */
+export interface SelectionPaintMark {
+    key: string;
+    rows: readonly number[];
+}
+/**
+ * Which marks a paint lit, and how it decided.
+ *   none             - nothing is selected;
+ *   any-row          - the default rule;
+ *   clicked          - the clicked marks (their keys were recorded for this very selection);
+ *   exact            - no click recorded for this selection: the marks whose rows equal it;
+ *   fallback-any-row - neither found a mark, so any-row decided this paint. A host logs it.
+ */
+export type SelectionPaintMode = "none" | "any-row" | "clicked" | "exact" | "fallback-any-row";
+export interface SelectionPaintPlan {
+    /** One flag per mark, in the order given: true when the mark is drawn selected. */
+    on: boolean[];
+    mode: SelectionPaintMode;
+    /** The keys of the marks lit by "clicked" or "exact": the clicked set to keep. Empty otherwise. */
+    keys: string[];
+}
+/** True when the two hold the same rows, ignoring order and repeats. */
+export declare function sameRowSet(a: Iterable<number> | null | undefined, b: Iterable<number> | null | undefined): boolean;
+/**
+ * THE ONE PAINT RULE every host applies to its marks: which of `marks` are drawn selected under
+ * `selection`. Under "any-row" a mark is lit when any of its rows is selected. Under
+ * "clicked-marks" it is lit when its key is in `clicked` - but only when `clicked` was recorded for
+ * this same selection, because a selection changed from elsewhere makes those keys stale; failing
+ * that, the marks whose rows equal the selection; failing that, any-row, reported as a fallback.
+ */
+export declare function planSelectionPaint(marks: readonly SelectionPaintMark[], selection: Iterable<number> | null | undefined, rule: SelectionRule, clicked: ClickedMarks | null | undefined): SelectionPaintPlan;
+/**
+ * The clicked set a click leaves under "clicked-marks". `prev` is the set held before the click and
+ * `current` the selection then; `next` is the selection the click leaves (nextSelection's answer).
+ * A plain click makes the clicked mark the whole set; Ctrl/Cmd/Shift adds it or takes it off. A held
+ * set recorded for a different selection is stale and starts over. An empty selection holds no set.
+ */
+export declare function nextClickedMarks(prev: ClickedMarks | null | undefined, current: Iterable<number> | null | undefined, key: string, next: readonly number[], mods?: SelectionModifiers): ClickedMarks | null;
 /**
  * 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

package/package.json

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