@bicharts/chart-host 0.6.107 → 0.6.109

package/dist/{chunk-TLIBO5PT.mjs → chunk-QAPZIFOB.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. */
 import {
   LASSO_KNOB_KEY
-} from "./chunk-IE426WU6.mjs";
+} from "./chunk-4DOKJ3R3.mjs";
 
 // src/filterScope.ts
 function viewToken(view) {
@@ -140,10 +140,17 @@ function createFilter(columns, opts = {}) {
     get version() {
       return version;
     },
-    selectRows(selected, why = "page") {
+    selectRows(selected, why = "page", keep) {
       const list = (selected ?? []).filter((r) => r && typeof r === "object");
       remember(list);
-      commit(dedupe(list.map((r) => keyOfRow(r, cols))), list, why);
+      const held = dedupe(toKeys(keep ?? [], cols.length));
+      if (!held.length) {
+        commit(dedupe(list.map((r) => keyOfRow(r, cols))), list, why);
+        return;
+      }
+      const keepSet = new Set(held.map(keyString));
+      const known = rows.filter((r) => keepSet.has(keyString(keyOfRow(r, cols))));
+      commit(dedupe(list.map((r) => keyOfRow(r, cols)).concat(held)), list.concat(known), why);
     },
     set(input, why = "page") {
       const ks = dedupe(toKeys(input, cols.length));
@@ -309,16 +316,6 @@ var sortedEq = (a, b) => {
   return x.every((v, i) => v === y[i]);
 };
 function bindFilter(host, filter, opts) {
-  const token = {};
-  const ownerKeys = () => keysString(filter.keys);
-  const isMine = () => {
-    const o = owners.get(filter);
-    return !!o && o.token === token && o.keys === ownerKeys();
-  };
-  {
-    const o = owners.get(filter);
-    if (o && o.orphan && o.keys === ownerKeys()) owners.set(filter, { token, keys: o.keys, orphan: false });
-  }
   const wanted = () => {
     if (!filter.active) return [];
     const out = [];
@@ -329,29 +326,37 @@ function bindFilter(host, filter, opts) {
     }
     return out;
   };
+  const hiddenKeys = () => {
+    if (!filter.active) return [];
+    const carried = /* @__PURE__ */ new Set();
+    const n = opts.rowCount();
+    for (let i = 0; i < n; i++) {
+      const r = opts.rowAt(i);
+      if (r) carried.add(keyString(keyOfRow(r, filter.columns)));
+    }
+    return filter.keys.filter((k) => !carried.has(keyString(k)));
+  };
   const paint = () => {
     const want = wanted();
     const cur = host.selection.current ?? [];
-    if (sortedEq(want, cur)) return;
-    if (want.length) host.selection.highlight(want);
-    else if (cur.length) host.selection.clear();
+    if (!sortedEq(want, cur)) {
+      if (want.length) host.selection.highlight(want);
+      else if (cur.length) host.selection.clear();
+    }
+    host.selection.setHidden?.(hiddenKeys().length);
   };
-  const offHost = host.selection.onChange((idxs, source) => {
+  const offHost = host.selection.onChange((idxs, source, meta) => {
     if (source === "host") return;
-    if (!idxs.length) {
+    const keep = meta?.keepHidden ? hiddenKeys() : [];
+    if (!idxs.length && !keep.length) {
       if (filter.active) filter.clear("clear");
       return;
     }
     const rows = idxs.map((i) => opts.rowAt(i)).filter((r) => !!r);
-    if (!rows.length) return;
-    filter.selectRows(rows, "click");
-    owners.set(filter, { token, keys: ownerKeys(), orphan: false });
-  });
-  const offFilter = filter.onChange(() => {
-    const o = owners.get(filter);
-    if (o && o.keys !== ownerKeys()) owners.delete(filter);
-    paint();
+    if (!rows.length && !keep.length) return;
+    filter.selectRows(rows, "click", keep);
   });
+  const offFilter = filter.onChange(() => paint());
   const el = opts.container ?? null;
   let offHoverDom = () => {
   };
@@ -388,20 +393,11 @@ function bindFilter(host, filter, opts) {
     offHover = filter.onHover(paintHover);
   }
   return {
+    // NEW DATA NEVER DROPS A SELECTION (contract 1.21.0). A key the new rows do not carry stays selected, whoever selected
+    // it, as Power BI keeps a selected row a slicer hid: the page goes on filtering by it, the chip goes on naming it, and the
+    // chart is told how many of its keys it cannot show (hostSelection.hidden) so it can say so and offer a clear. It used
+    // to be cleared here (reason "data") when this chart had made it, which lost a reader's pick to someone else's filter.
     reconcile() {
-      if (filter.active && opts.rowCount() > 0 && isMine()) {
-        const drawn = /* @__PURE__ */ new Set();
-        const n = opts.rowCount();
-        for (let i = 0; i < n; i++) {
-          const r = opts.rowAt(i);
-          if (r) drawn.add(keyString(keyOfRow(r, filter.columns)));
-        }
-        const keep = filter.keys.filter((k) => drawn.has(keyString(k)));
-        if (keep.length !== filter.keys.length) {
-          filter.set(keep, "data");
-          return;
-        }
-      }
       paint();
     },
     paint,
@@ -410,13 +406,9 @@ function bindFilter(host, filter, opts) {
       offFilter();
       offHoverDom();
       offHover();
-      const o = owners.get(filter);
-      if (o && o.token === token) owners.set(filter, { ...o, orphan: true });
     }
   };
 }
-var owners = /* @__PURE__ */ new WeakMap();
-var keysString = (keys) => keys.map((k) => keyString(k)).sort().join("|");
 function fromVegaInteraction(filter, events) {
   const before = filter.version;
   for (const ev of events ?? []) {

package/dist/{chunk-SYUJ4TPX.mjs → chunk-TH577JHI.mjs}

@@ -1421,10 +1421,10 @@ function Sr2(e, t) {
   return n;
 }
 function Rr(e, t, n, o2, a3) {
-  let u3 = [], l2 = [], i = {}, C3 = {}, b2 = new Set(e), h3 = (s2) => t.map((d2) => d2[s2]);
+  let u3 = [], l2 = [], i = {}, y3 = {}, h3 = new Set(e), b2 = (s2) => t.map((d2) => d2[s2]);
   for (let s2 of ["city", "country"]) {
     let d2 = n?.[s2];
-    d2 && b2.has(d2) && (i[s2] = d2);
+    d2 && h3.has(d2) && (i[s2] = d2);
   }
   let g5 = new Set(a3 ?? e);
   for (let s2 of ["lat", "lon"]) {
@@ -1432,20 +1432,20 @@ function Rr(e, t, n, o2, a3) {
     d2 && g5.has(d2) && (i[s2] = d2);
   }
   let f2 = n?.zip;
-  if (f2 && b2.has(f2)) {
-    let s2 = h3(f2), d2 = ie(s2);
+  if (f2 && h3.has(f2)) {
+    let s2 = b2(f2), d2 = ie(s2);
     d2 < 95 ? l2.push(`zip=${f2} (only ${d2}% of values read as ZIPs)`) : pe(s2, f2) ? i.zip = f2 : l2.push(`zip=${f2} (all values are 3-4 digits with nothing to say they are postal)`);
   }
   let c = n?.state;
-  if (c && b2.has(c)) {
-    let s2 = h3(c), d2 = F3(s2);
+  if (c && h3.has(c)) {
+    let s2 = b2(c), d2 = F3(s2);
     d2.length > 0 && d2.every((S) => fe(S, o2)) ? l2.push(`state=${c} (every value is "CA", which is both Canada and California)`) : N(s2) ? (l2.push(`state=${c} (every value is a country, not a state)`), i.country || (i.country = c)) : q4(s2) < 95 ? l2.push(`state=${c} (only ${q4(s2)}% of values are states/provinces)`) : i.state = c;
   }
-  let p3 = new Set(Object.values(i).filter(Boolean)), y3 = e.filter((s2) => !p3.has(s2) && !s2.startsWith("__"));
+  let p3 = new Set(Object.values(i).filter(Boolean)), C3 = e.filter((s2) => !p3.has(s2) && !s2.startsWith("__"));
   if (!i.state) {
     let s2 = null;
-    for (let d2 of y3) {
-      let S = h3(d2);
+    for (let d2 of C3) {
+      let S = b2(d2);
       if (N(S)) continue;
       let O2 = q4(S);
       if (O2 < 95) continue;
@@ -1454,46 +1454,46 @@ function Rr(e, t, n, o2, a3) {
     }
     s2 && (i.state = s2.name, p3.add(s2.name), u3.push(`state=${s2.name} (${s2.pct}% states/provinces)`));
   }
-  if (!i.zip) for (let s2 of y3) {
+  if (!i.zip) for (let s2 of C3) {
     if (p3.has(s2)) continue;
-    let d2 = h3(s2), S = ie(d2);
+    let d2 = b2(s2), S = ie(d2);
     if (!(S < 95) && pe(d2, s2) && !(Sr2(d2, (O2) => Gn(O2).length > 0) < ee)) {
       i.zip = s2, p3.add(s2), u3.push(`zip=${s2} (${S}% ZIP codes)`);
       break;
     }
   }
   let T3 = i.country;
-  if (!T3 || !N(h3(T3))) {
+  if (!T3 || !N(b2(T3))) {
     let s2 = null;
-    for (let d2 of y3) {
-      if (p3.has(d2) || !N(h3(d2))) continue;
-      let S = re(h3(d2));
+    for (let d2 of C3) {
+      if (p3.has(d2) || !N(b2(d2))) continue;
+      let S = re(b2(d2));
       (!s2 || S > s2.pct) && (s2 = { name: d2, pct: S });
     }
-    s2 && (T3 && (l2.push(`country=${T3} (only ${re(h3(T3))}% of values are country identifiers; using ${s2.name} instead)`), C3.country = T3), i.country = s2.name, p3.add(s2.name), u3.push(`country=${s2.name}`));
+    s2 && (T3 && (l2.push(`country=${T3} (only ${re(b2(T3))}% of values are country identifiers; using ${s2.name} instead)`), y3.country = T3), i.country = s2.name, p3.add(s2.name), u3.push(`country=${s2.name}`));
   }
   if (!i.city) {
     let s2 = null;
-    for (let d2 of y3) {
+    for (let d2 of C3) {
       if (p3.has(d2)) continue;
-      let S = h3(d2), O2 = Tr2(S, o2);
+      let S = b2(d2), O2 = Tr2(S, o2);
       O2 < ct || te(S, (H3) => Ht(H3, o2)) < ee || (!s2 || O2 > s2.pct) && (s2 = { name: d2, pct: O2 });
     }
     s2 && (i.city = s2.name, u3.push(`city=${s2.name} (${s2.pct}% known cities)`));
   }
-  let v2 = i.country ? h3(i.country) : [], R3 = !!i.country && N(v2), L3 = R3 ? new Set(v2.map((s2) => I(s2 == null ? null : String(s2))).filter(Boolean)).size : 0, x3 = R3 && L3 >= 2, w4 = !!(i.lat && i.lon) && t.some((s2) => {
+  let A2 = i.country ? b2(i.country) : [], R3 = !!i.country && N(A2), v2 = R3 ? new Set(A2.map((s2) => I(s2 == null ? null : String(s2))).filter(Boolean)).size : 0, x3 = R3 && v2 >= 2, w4 = !!(i.lat && i.lon) && t.some((s2) => {
     let d2 = +String(s2[i.lat] ?? "").trim(), S = +String(s2[i.lon] ?? "").trim();
     return isFinite(d2) && isFinite(S) && d2 >= -90 && d2 <= 90 && S >= -180 && S <= 180 && String(s2[i.lat] ?? "").trim() !== "" && String(s2[i.lon] ?? "").trim() !== "";
   });
-  return i.lat && i.lon && !w4 && l2.push(`lat/lon=${i.lat}/${i.lon} (no row holds a usable coordinate pair)`), i.country && !x3 && !(i.city || i.state || i.zip || w4) && l2.push(R3 ? `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 || w4) ? i : null, backfilled: u3, refused: l2, ...Object.keys(C3).length ? { labelFallback: C3 } : {} };
+  return i.lat && i.lon && !w4 && l2.push(`lat/lon=${i.lat}/${i.lon} (no row holds a usable coordinate pair)`), i.country && !x3 && !(i.city || i.state || i.zip || w4) && l2.push(R3 ? `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 || w4) ? i : null, backfilled: u3, refused: l2, ...Object.keys(y3).length ? { labelFallback: y3 } : {} };
 }
 var r = (e, ...t) => ({ part: e, langs: Object.freeze(t) });
 var ae = 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 xr = Object.freeze(Array.from(new Set(Object.values(ae).flatMap((e) => e.langs))));
 var ye = Object.freeze(["fa", "ar", "he", "th"]);
-var no = Object.freeze({ integer: "number", decimal: "number", double: "number", datetime: "date", date: "date", boolean: "boolean", string: "text" });
-var co = 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 mo = Object.freeze(["open", "generate", "version", "rebind", "data", "sample", "fix", "resize", "other"]);
+var ro = Object.freeze({ integer: "number", decimal: "number", double: "number", datetime: "date", date: "date", boolean: "boolean", string: "text" });
+var mo = 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 fo = Object.freeze(["open", "generate", "version", "rebind", "data", "sample", "fix", "resize", "other"]);
 var Ne = 2 ** 31 - 1;
 
 export {

package/dist/{chunk-IE7TM6DX.mjs → chunk-TN5JRULV.mjs}

@@ -2,7 +2,7 @@
 import {
   CONTAINER_SLOT_SCROLL,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-7XRQUFVH.mjs";
+} from "./chunk-USZSHKIB.mjs";
 
 // src/fit.ts
 var SCROLL_SLACK_PX = 8;

package/dist/{chunk-7XRQUFVH.mjs → chunk-USZSHKIB.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.20.0";
+var HOST_CONTRACT_VERSION = "1.22.0";
 var GEO_POINT_PRECISIONS = ["latlon", "city", "zip3", "state", "country"];
 var MARK_CLASS = "d3-mark";
 var LEGEND_MARK_CLASS = "d3-legend-mark";
@@ -16,6 +16,7 @@ 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";
+var CONTAINER_SLOT_HOST_SELECTION = "__lchHostSelection";
 var CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
 var CONTAINER_SLOT_XF_CLEAR = "__llmXfClear";
 var CONTAINER_SLOT_INITIAL_XF_MARK = "__llmInitialXfMark";
@@ -33,6 +34,7 @@ function withoutViewOnlyKeys(bag) {
 var HOST_CONTAINER_CLASS = "bic-chart-host";
 var SELECTION_ACTIVE_CLASS = "lch-has-selection";
 var MARK_SELECTED_CLASS = "lch-mark-selected";
+var MARKS_INERT_CLASS = "lch-marks-inert";
 var ACTIVE_TICK_CLASS = "lch-tick-active";
 var DIM_OPACITY_VAR = "--lch-dim-opacity";
 var DIM_OPACITY_DEFAULT = 0.25;
@@ -88,6 +90,7 @@ export {
   NO_ROW_MARKS_ATTR,
   SNAPSHOT_SVG_ATTR,
   XFILTER_REFRESH_EVENT,
+  CONTAINER_SLOT_HOST_SELECTION,
   CONTAINER_SLOT_ANIM_STOP,
   CONTAINER_SLOT_XF_CLEAR,
   CONTAINER_SLOT_INITIAL_XF_MARK,
@@ -99,6 +102,7 @@ export {
   HOST_CONTAINER_CLASS,
   SELECTION_ACTIVE_CLASS,
   MARK_SELECTED_CLASS,
+  MARKS_INERT_CLASS,
   ACTIVE_TICK_CLASS,
   DIM_OPACITY_VAR,
   DIM_OPACITY_DEFAULT,

package/dist/index.mjs

@@ -5,7 +5,7 @@ import {
   formatSourceDateFor,
   isExcelDateFormat,
   normaliseAggregation
-} from "./chunk-MU4BWWO6.mjs";
+} from "./chunk-G4CKILIL.mjs";
 import {
   captureSvgSnapshot,
   chartSvgOf,
@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-PA5V6J6K.mjs";
+} from "./chunk-3EQOJHRA.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -29,6 +29,8 @@ import {
   DARK_TEXT,
   EXPORT_FORMATS,
   GLYPH_SAMPLE_N,
+  KEYBOARD_CLASS,
+  KEYBOARD_STAMP,
   LABEL_CONTRAST_CAP,
   LABEL_CONTRAST_DONE_ATTR,
   LABEL_PILL_CLASS,
@@ -47,6 +49,7 @@ import {
   STRADDLE_TARGET_CONTRAST,
   VALUE_AXIS_MIN_FIT,
   WHITE_TEXT_BG_LUM,
+  WIRED_ATTR,
   XLSX_MIME,
   applyLabelContrast,
   assembleD3,
@@ -63,7 +66,9 @@ import {
   censusColourSpread,
   censusMarks,
   censusValuePlacement,
+  cleanHostSelection,
   clippedTextFlag,
+  codeHasKeyboardStamp,
   colourSpreadFlag,
   compileRenderFn,
   compositeOver,
@@ -79,6 +84,7 @@ import {
   exportFormatsFor,
   exportTableService,
   glyphSampleGrid,
+  installKeyboard,
   invalidSentinelReason,
   isBlankRender,
   isInvalidSentinelError,
@@ -89,9 +95,12 @@ import {
   pickColorOver,
   pillBacksGlyph,
   relativeLuminance,
+  rememberFocus,
   requiredD3Plugins,
   resolveAutoColorScale,
   resolveOptions,
+  restoreFocus,
+  rowNameOf,
   scopeChartIds,
   sessionViewStateProvider,
   sheetName,
@@ -105,7 +114,7 @@ import {
   toRGBA,
   toSourceRows,
   valuePlacementFlag
-} from "./chunk-BWR35DEK.mjs";
+} from "./chunk-JQ7FFCOE.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -132,13 +141,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-IE426WU6.mjs";
+} from "./chunk-4DOKJ3R3.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-CPLWAW3Z.mjs";
+} from "./chunk-GQLEU3VC.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -163,7 +172,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-P2DLK7WZ.mjs";
+} from "./chunk-3ER4C7TG.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -192,7 +201,7 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-IE7TM6DX.mjs";
+} from "./chunk-TN5JRULV.mjs";
 import {
   clearGeoCache,
   geoAssetFor,
@@ -205,7 +214,7 @@ import {
   Kt,
   l,
   o
-} from "./chunk-SYUJ4TPX.mjs";
+} from "./chunk-TH577JHI.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -225,6 +234,7 @@ import {
   COLOR_SCALE_SELF_CLAMP_PCT_MIN,
   CONTAINER_SLOT_ANIM_STOP,
   CONTAINER_SLOT_CLICKED_MARKS,
+  CONTAINER_SLOT_HOST_SELECTION,
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_SCROLL,
   CONTAINER_SLOT_UI_STATE,
@@ -242,6 +252,7 @@ import {
   HOST_CONTRACT_VERSION,
   LEGEND_MARK_CLASS,
   LIFT_SELECTED_CLASS,
+  MARKS_INERT_CLASS,
   MARK_CLASS,
   MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
@@ -260,7 +271,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-7XRQUFVH.mjs";
+} from "./chunk-USZSHKIB.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/hostLinks.ts
@@ -2330,6 +2341,7 @@ export {
   COLOR_SCALE_SELF_CLAMP_PCT_MIN,
   CONTAINER_SLOT_ANIM_STOP,
   CONTAINER_SLOT_CLICKED_MARKS,
+  CONTAINER_SLOT_HOST_SELECTION,
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_PRESS_AT,
   CONTAINER_SLOT_SCROLL,
@@ -2365,6 +2377,9 @@ export {
   HOST_CONTAINER_CLASS,
   HOST_CONTRACT_VERSION,
   INLINE_FILTER_MIN_ROWS,
+  KEYBOARD_CLASS,
+  KEYBOARD_STAMP,
+  WIRED_ATTR as KEYBOARD_WIRED_ATTR,
   LABEL_CONTRAST_CAP,
   LABEL_CONTRAST_DONE_ATTR,
   LABEL_PILL_CLASS,
@@ -2391,6 +2406,7 @@ export {
   LIGHT_TEXT,
   LIMIT_COUNT_MAX,
   LIVE_OPTION_KEYS,
+  MARKS_INERT_CLASS,
   MARK_CLASS,
   MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
@@ -2477,12 +2493,14 @@ export {
   chartOwnsTimeline,
   chartSvgOf,
   chooserFitsViewport,
+  cleanHostSelection,
   clearGeoCache,
   clearLasso,
   clearPress,
   clearSelectionGlyphs,
   clickWasDrag,
   clippedTextFlag,
+  codeHasKeyboardStamp,
   codeReadsDatesInLocalTime,
   codeReadsOption,
   collectD3GlyphCenters,
@@ -2533,6 +2551,7 @@ export {
   htmlNaturalSize,
   htmlToSvgDataUrl,
   inlineFilterGate,
+  installKeyboard,
   installLasso,
   invalidSentinelReason,
   isBlankRender,
@@ -2626,11 +2645,14 @@ export {
   registerGeoAsset,
   registerLassoAction,
   relativeLuminance,
+  rememberFocus,
   rememberScroll,
   requiredD3Plugins,
   resolveAutoColorScale,
   resolveOptions,
+  restoreFocus,
   rowIdxsFromMark,
+  rowNameOf,
   sameMarker,
   sameRowSet,
   scopeChartIds,

package/dist/legend-fit.mjs

@@ -2,13 +2,13 @@
 import {
   chartSvgOf,
   tableHostOf
-} from "./chunk-PA5V6J6K.mjs";
+} from "./chunk-3EQOJHRA.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-IE7TM6DX.mjs";
-import "./chunk-7XRQUFVH.mjs";
+} from "./chunk-TN5JRULV.mjs";
+import "./chunk-USZSHKIB.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/legendFit/legendReconcile.ts

package/dist/page.mjs

@@ -14,10 +14,10 @@ import {
   readControls,
   viewFromToken,
   viewToken
-} from "./chunk-TLIBO5PT.mjs";
-import "./chunk-IE426WU6.mjs";
-import "./chunk-P2DLK7WZ.mjs";
-import "./chunk-7XRQUFVH.mjs";
+} from "./chunk-QAPZIFOB.mjs";
+import "./chunk-4DOKJ3R3.mjs";
+import "./chunk-3ER4C7TG.mjs";
+import "./chunk-USZSHKIB.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   LINKED_HOVER_CLASS,

package/dist/provinces.mjs

@@ -7,7 +7,7 @@ import {
   Si,
   W,
   bt
-} from "./chunk-SYUJ4TPX.mjs";
+} from "./chunk-TH577JHI.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/react.mjs

@@ -13,25 +13,25 @@ import {
   payloadRowReader,
   viewFromToken,
   viewToken
-} from "./chunk-TLIBO5PT.mjs";
+} from "./chunk-QAPZIFOB.mjs";
 import {
   assembleD3,
   createChartGroup,
   createChartHost,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-BWR35DEK.mjs";
-import "./chunk-IE426WU6.mjs";
-import "./chunk-CPLWAW3Z.mjs";
-import "./chunk-P2DLK7WZ.mjs";
-import "./chunk-IE7TM6DX.mjs";
+} from "./chunk-JQ7FFCOE.mjs";
+import "./chunk-4DOKJ3R3.mjs";
+import "./chunk-GQLEU3VC.mjs";
+import "./chunk-3ER4C7TG.mjs";
+import "./chunk-TN5JRULV.mjs";
 import {
   geoFromCache,
   loadGeo
 } from "./chunk-5WTQN5DL.mjs";
-import "./chunk-SYUJ4TPX.mjs";
+import "./chunk-TH577JHI.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-7XRQUFVH.mjs";
+import "./chunk-USZSHKIB.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx
@@ -185,7 +185,11 @@ function BicChart(props) {
       // siblings of a chart that has an id in a group. This binding always
       // subscribes to the selection (for onSelect), so the host cannot count
       // subscribers here; an onSelect callback alone is not the page's filter.
-      selectionReachesPage: () => !!reachRef.current.selects || !!(reachRef.current.group && reachRef.current.id)
+      selectionReachesPage: () => !!reachRef.current.selects || !!(reachRef.current.group && reachRef.current.id),
+      // Whether a click on a mark does anything at all: the same two,
+      // or an onSelect the page passed. A chart with none of them draws its marks
+      // inert rather than dimming the others for a click that filters nothing.
+      marksSelect: () => !!reachRef.current.selects || !!(reachRef.current.group && reachRef.current.id) || typeof onSelectRef.current === "function"
     });
     hostRef.current = host;
     builtAnnKeyRef.current = annKey;

package/dist/testing.mjs

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

package/dist/types/annotations.d.ts

@@ -40,4 +40,6 @@ export interface AnnotationLayer {
     readonly report: AnnotationReport;
     destroy(): void;
 }
-export declare function createAnnotationLayer(container: HTMLElement, onClick?: (a: MarkAnnotation) => void): AnnotationLayer;
+export declare function createAnnotationLayer(container: HTMLElement, onClick?: (a: MarkAnnotation) => void, opts?: {
+    keyboard?: () => boolean;
+}): AnnotationLayer;

package/dist/types/contract.d.ts

@@ -1,5 +1,5 @@
 import type { ExportFormat, ExportTableService, SaveFileService } from "./exportTable";
-export declare const HOST_CONTRACT_VERSION = "1.20.0";
+export declare const HOST_CONTRACT_VERSION = "1.22.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[];
@@ -32,7 +32,25 @@ export type XfilterRefreshDetail = {
 } | {
     rows: readonly number[];
     source?: string;
+    keepHidden?: boolean;
 };
+/**
+ * WHAT THE HOST HOLDS OF THE SELECTION (1.21.0), as RenderOptions.hostSelection on a draw and as the argument of the
+ * CONTAINER_SLOT_HOST_SELECTION slot between draws. Untrusted on the chart side like every option: rows are this draw's
+ * row indices (whole, non-negative), hidden a count.
+ */
+export interface HostSelectionFact {
+    /** Row indices of this draw's data the host's selection holds, ascending. */
+    rows: readonly number[];
+    /** Held identities that match no row of this draw: a filter hid them, and the host still filters by them. */
+    hidden: number;
+    /** Set when the host kept fewer identities than a publish gave it. */
+    narrowed?: {
+        published: number;
+        kept: number;
+    };
+}
+export declare const CONTAINER_SLOT_HOST_SELECTION = "__lchHostSelection";
 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";
@@ -72,6 +90,7 @@ export interface ViewStateProvider {
 export declare const HOST_CONTAINER_CLASS = "bic-chart-host";
 export declare const SELECTION_ACTIVE_CLASS = "lch-has-selection";
 export declare const MARK_SELECTED_CLASS = "lch-mark-selected";
+export declare const MARKS_INERT_CLASS = "lch-marks-inert";
 export declare const ACTIVE_TICK_CLASS = "lch-tick-active";
 export declare const DIM_OPACITY_VAR = "--lch-dim-opacity";
 export declare const DIM_OPACITY_DEFAULT = 0.25;
@@ -129,6 +148,7 @@ export interface RenderOptions {
     dataComplete?: boolean;
     rowsWithheld?: number;
     rowsFilteredOut?: number;
+    hostSelection?: HostSelectionFact;
     openUrl?: (url: string) => void;
     copyText?: (text: string) => boolean | void | Promise<boolean | void>;
     saveFile?: SaveFileService;
@@ -177,6 +197,10 @@ export interface RenderOptions {
     selectionGlyph?: "none" | "dot" | "check";
     /** A host FACT from the generate answer: this chart's family never takes a selection glyph. */
     suppressSelectionGlyph?: boolean;
+    /** A host FACT: this chart works from the keyboard (its code carries the keyboard stamp), so the host has made its
+     *  selectable marks focusable. A chart or helper drawing its own controls (a flip arrow, a sort header) gives them
+     *  a tabindex, a role and an Enter / Space press when this is true. */
+    keyboardMarks?: boolean;
     animAutoPlay?: boolean;
     animPlaySpeedMs?: number;
     animLoopDelaySec?: number;