@bicharts/chart-host 0.6.108 → 0.6.109

package/dist/adapters.mjs

@@ -3,7 +3,7 @@ import {
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-UKXGOQMS.mjs";
+} from "./chunk-GQLEU3VC.mjs";
 import {
   clickWasDrag,
   collectD3GlyphCenters,
@@ -12,13 +12,13 @@ import {
   markKeyOf,
   rowIdxsFromMark,
   selectionRuleOf
-} from "./chunk-LGWTV5PB.mjs";
+} from "./chunk-3ER4C7TG.mjs";
 import {
   AXIS_FILTER_CLASS,
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-PHUUFCJY.mjs";
+} from "./chunk-USZSHKIB.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/adapters/types.ts

package/dist/card.mjs

@@ -1,8 +1,8 @@
 /*! @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 {
   computeSelectionCard
-} from "./chunk-MU4BWWO6.mjs";
-import "./chunk-SYUJ4TPX.mjs";
+} from "./chunk-G4CKILIL.mjs";
+import "./chunk-TH577JHI.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/selectionCardChrome.ts

package/dist/{chunk-FCLPMC6Q.mjs → chunk-3EQOJHRA.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 {
   SNAPSHOT_SVG_ATTR
-} from "./chunk-PHUUFCJY.mjs";
+} from "./chunk-USZSHKIB.mjs";
 
 // src/snapshot.ts
 var DEFAULT_TIMEOUT_MS = 2e3;

package/dist/{chunk-LGWTV5PB.mjs → chunk-3ER4C7TG.mjs}

@@ -8,7 +8,7 @@ import {
   SELECTION_RULE_ATTR,
   SELECTION_RULE_CLICKED_MARKS,
   XFILTER_REFRESH_EVENT
-} from "./chunk-PHUUFCJY.mjs";
+} from "./chunk-USZSHKIB.mjs";
 
 // src/selection.ts
 function rowIdxsFromMark(el) {

package/dist/{chunk-ESBH2L6E.mjs → chunk-4DOKJ3R3.mjs}

@@ -4,7 +4,7 @@ import {
   gestureWasDrag,
   isInsideControl,
   rowIdxsFromMark
-} from "./chunk-LGWTV5PB.mjs";
+} from "./chunk-3ER4C7TG.mjs";
 import {
   AXIS_FILTER_CLASS,
   CONTROL_CLASS,
@@ -12,7 +12,7 @@ import {
   MARK_CLASS,
   ROW_IDX_ATTR,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-PHUUFCJY.mjs";
+} from "./chunk-USZSHKIB.mjs";
 
 // src/lasso.ts
 var LASSO_ROW_CAP = 5e3;

package/dist/{chunk-MU4BWWO6.mjs → chunk-G4CKILIL.mjs}

@@ -6,7 +6,7 @@ import {
   Ti,
   j,
   u
-} from "./chunk-SYUJ4TPX.mjs";
+} from "./chunk-TH577JHI.mjs";
 
 // src/sourceDateFormat.ts
 function formatSourceDate(raw, opts = {}) {

package/dist/{chunk-UKXGOQMS.mjs → chunk-GQLEU3VC.mjs}

@@ -4,7 +4,7 @@ import {
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-PHUUFCJY.mjs";
+} from "./chunk-USZSHKIB.mjs";
 
 // src/hitTargets.ts
 var SVG_NS = "http://www.w3.org/2000/svg";

package/dist/{chunk-MO2GR56D.mjs → chunk-JQ7FFCOE.mjs}

@@ -4,11 +4,11 @@ import {
   claimParkedLasso,
   installLasso,
   lassoEffect
-} from "./chunk-ESBH2L6E.mjs";
+} from "./chunk-4DOKJ3R3.mjs";
 import {
   censusHitBands,
   ensureCrossfilterHitTargets
-} from "./chunk-UKXGOQMS.mjs";
+} from "./chunk-GQLEU3VC.mjs";
 import {
   clearPress,
   clearSelectionGlyphs,
@@ -25,14 +25,14 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-LGWTV5PB.mjs";
+} from "./chunk-3ER4C7TG.mjs";
 import {
   clipWindowOf,
   fitRenderedChart,
   rememberScroll,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-OSREEGBN.mjs";
+} from "./chunk-TN5JRULV.mjs";
 import {
   geoFromCache
 } from "./chunk-5WTQN5DL.mjs";
@@ -43,7 +43,7 @@ import {
   Rr,
   Yn,
   tt
-} from "./chunk-SYUJ4TPX.mjs";
+} from "./chunk-TH577JHI.mjs";
 import {
   ACTIVE_TICK_CLASS,
   ANIM_LOOP_DELAY_DEFAULT,
@@ -75,6 +75,7 @@ import {
   HOST_CONTRACT_VERSION,
   LEGEND_MARK_CLASS,
   LIFT_SELECTED_CLASS,
+  MARKS_INERT_CLASS,
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   MAX_MAP_POINTS_DEFAULT,
@@ -87,7 +88,7 @@ import {
   XFILTER_REFRESH_EVENT,
   chartOwnsTimeline,
   periodTickSuppressesFeedback
-} from "./chunk-PHUUFCJY.mjs";
+} from "./chunk-USZSHKIB.mjs";
 
 // src/labelContrast.ts
 function parseRGBA(c) {
@@ -1159,6 +1160,8 @@ function resolveOptions(p) {
     })(),
     // A host FACT from the generate answer, true only for a literal true: silence never suppresses anything.
     suppressSelectionGlyph: p.suppressSelectionGlyph === true ? true : void 0,
+    // A host FACT (1.22.0): the chart works from the keyboard. True only for a literal true, like the one above.
+    keyboardMarks: p.keyboardMarks === true ? true : void 0,
     onSelect: p.onSelect,
     // Control gestures (1.10.0). Passed straight through like onSelect: the host owns what a gesture MEANS,
     // and a host that supplies nothing leaves every control behaving exactly as before.
@@ -2322,7 +2325,7 @@ var DOT = 8;
 var RING = 1.5;
 var DOT_HALF = DOT / 2 + RING;
 var DOT_IN = 8;
-function createAnnotationLayer(container, onClick) {
+function createAnnotationLayer(container, onClick, opts) {
   let list = [];
   let report = { shown: 0, notShown: 0 };
   let last = null;
@@ -2446,7 +2449,7 @@ function createAnnotationLayer(container, onClick) {
       const after = own.filter((t) => t.b.l >= run.r && t.b.b > run.t && t.b.t < run.b).map((t) => t.b.l);
       return { r: Math.min(run.r, seen), y: (run.t + run.b) / 2, next: after.length ? Math.min(...after) : v.r };
     };
-    const clear = (v, len, mark) => {
+    const clear = (v, len, mark, whole = v) => {
       const hw = Math.max(16, len * 6 + 8) / 2, hh = 8, g = 2;
       const cx = (v.l + v.r) / 2, cy = (v.t + v.b) / 2;
       const at = (x, y) => ({ l: x - hw, t: y - hh, r: x + hw, b: y + hh });
@@ -2459,6 +2462,7 @@ function createAnnotationLayer(container, onClick) {
       const tries = [];
       const add = (x, y, px = x, py = y) => tries.push({ x: clampX(x, hw), y: clampY(y, hh), px, py });
       const label = rowLabel(v, mark);
+      if (!label && whole !== v && rowLabel(whole, mark)) return null;
       if (label) {
         const x = label.r + g + hw;
         if (x + hw <= label.next - g || label.next >= v.r) add(x, label.y, Math.min(x, v.r - 1), label.y);
@@ -2523,7 +2527,7 @@ function createAnnotationLayer(container, onClick) {
         }
       }
       const dot = wantsDot(bestMark ?? hits2.values().next().value ?? null);
-      const pt = !best ? null : dot ? dotSpot(best, bestWhole) : clear(best, (a.label ?? "\u2022").length, bestMark);
+      const pt = !best ? null : dot ? dotSpot(best, bestWhole) : clear(best, (a.label ?? "\u2022").length, bestMark, bestWhole ?? best);
       if (laidOut && !pt) continue;
       shown++;
       const badge = doc.createElement("div");
@@ -2564,6 +2568,15 @@ function createAnnotationLayer(container, onClick) {
         e.stopPropagation();
         onClick?.(a);
       });
+      if (opts?.keyboard?.()) {
+        badge.setAttribute("tabindex", "0");
+        badge.addEventListener("keydown", (e) => {
+          if (e.key !== "Enter" && e.key !== " " && e.key !== "Spacebar") return;
+          e.preventDefault();
+          e.stopPropagation();
+          onClick?.(a);
+        });
+      }
       layer.appendChild(badge);
     }
     report = { shown, notShown: list.length - shown };
@@ -2590,6 +2603,222 @@ function createAnnotationLayer(container, onClick) {
   };
 }
 
+// src/focusKeep.ts
+function signatureOf(el) {
+  const a = (n) => el.getAttribute(n) ?? "";
+  const cls = Array.from(el.classList ?? []).filter((c) => !/^lch-|^bic-/.test(c)).sort().join(" ");
+  return [el.localName, a("type"), cls, a("name"), a("placeholder"), a("aria-label"), a("role")].join("|");
+}
+function alike(container, sig) {
+  const tag = sig.split("|", 1)[0];
+  if (!tag) return [];
+  return Array.from(container.querySelectorAll(tag)).filter((e) => signatureOf(e) === sig);
+}
+function rememberFocus(container) {
+  try {
+    const active = container.ownerDocument?.activeElement;
+    if (!active || active === container || !container.contains(active)) return null;
+    const sig = signatureOf(active);
+    const nth = alike(container, sig).indexOf(active);
+    const t = active;
+    let start = null, end = null, dir = null;
+    try {
+      if (typeof t.selectionStart === "number") {
+        start = t.selectionStart;
+        end = t.selectionEnd;
+        dir = t.selectionDirection ?? null;
+      }
+    } catch {
+    }
+    return { sig, nth: Math.max(0, nth), start, end, dir };
+  } catch {
+    return null;
+  }
+}
+function restoreFocus(container, memory) {
+  if (!memory) return false;
+  try {
+    const active = container.ownerDocument?.activeElement;
+    if (active && active !== container && container.contains(active)) return false;
+    const list = alike(container, memory.sig);
+    const el = list[memory.nth] ?? (list.length === 1 ? list[0] : null);
+    if (!el || typeof el.focus !== "function") return false;
+    el.focus({ preventScroll: true });
+    const t = el;
+    if (memory.start != null && typeof t.setSelectionRange === "function") {
+      const len = typeof t.value === "string" ? t.value.length : 0;
+      try {
+        t.setSelectionRange(Math.min(memory.start, len), Math.min(memory.end ?? memory.start, len), memory.dir ?? void 0);
+      } catch {
+      }
+    }
+    return container.ownerDocument?.activeElement === el;
+  } catch {
+    return false;
+  }
+}
+
+// src/keyboardMarks.ts
+var KEYBOARD_STAMP = "// bic:keyboard-marks";
+var STAMP_RE = /^[ \t]*\/\/[ \t]*bic:keyboard-marks\b/;
+var STAMP_HEAD_LINES = 12;
+function codeHasKeyboardStamp(code) {
+  if (typeof code !== "string" || !code) return false;
+  let start = 0;
+  for (let n = 0; n < STAMP_HEAD_LINES && start <= code.length; n++) {
+    const end = code.indexOf("\n", start);
+    const line = code.slice(start, end < 0 ? code.length : end);
+    if (STAMP_RE.test(line)) return true;
+    if (end < 0) break;
+    start = end + 1;
+  }
+  return false;
+}
+var KEYBOARD_CLASS = "lch-keyboard";
+var WIRED_ATTR = "data-lch-kb";
+function rowNameOf(columns, row, culture) {
+  if (!row) return null;
+  const parts = [];
+  (columns || []).forEach((c, i) => {
+    const name = typeof c === "string" ? c : c?.name;
+    const v = row[i];
+    if (parts.length >= 4 || v == null || v === "" || typeof name === "string" && name.startsWith("__")) return;
+    parts.push(typeof v === "number" ? v.toLocaleString(culture || void 0, { maximumFractionDigits: 2 }) : String(v));
+  });
+  return parts.length ? parts.join(", ") : null;
+}
+var isClearChord = (e) => !!e.ctrlKey && !!e.shiftKey && (e.key === "C" || e.key === "c");
+var NATIVE = /* @__PURE__ */ new Set(["input", "select", "textarea", "button", "a"]);
+var isNative = (el) => NATIVE.has((el.localName || "").toLowerCase()) || el.isContentEditable === true;
+function installKeyboard(env) {
+  const { container } = env;
+  let rovingKey = null;
+  let destroyed = false;
+  const marksNow = () => {
+    if (env.inert()) return [];
+    return Array.from(container.querySelectorAll(env.markSelector)).filter((m) => !m.closest(env.skipSelector) && (m.getAttribute("data-row-idx") ?? "") !== "");
+  };
+  const wired = (el) => el.hasAttribute(WIRED_ATTR);
+  const wire = (el, tabindex, role) => {
+    if (el.hasAttribute("tabindex") && !wired(el)) return false;
+    el.setAttribute(WIRED_ATTR, "");
+    el.setAttribute("tabindex", tabindex);
+    if (!el.hasAttribute("role")) el.setAttribute("role", role);
+    return true;
+  };
+  const setRoving = (list, to) => {
+    for (const m of list) if (wired(m)) m.setAttribute("tabindex", m === to ? "0" : "-1");
+    rovingKey = env.keyOf(to);
+  };
+  const refresh = () => {
+    if (destroyed) return;
+    try {
+      container.classList?.add(KEYBOARD_CLASS);
+      const list = marksNow();
+      for (const m of list) {
+        if (!wire(m, "-1", "button")) continue;
+        m.setAttribute("aria-pressed", env.isSelected(m) ? "true" : "false");
+        if (!m.hasAttribute("aria-label") && !m.querySelector(":scope > title")) {
+          const name = env.labelOf(m);
+          if (name) m.setAttribute("aria-label", name);
+        }
+      }
+      if (!list.length) {
+        for (const m of Array.from(container.querySelectorAll(`[${WIRED_ATTR}]`)))
+          if (m.matches(env.markSelector)) {
+            m.removeAttribute("tabindex");
+            m.removeAttribute(WIRED_ATTR);
+          }
+      }
+      const own = list.filter(wired);
+      if (own.length) {
+        const keep = own.find((m) => env.keyOf(m) === rovingKey) ?? own.find((m) => env.isSelected(m)) ?? own[0];
+        setRoving(own, keep);
+      }
+      for (const c of Array.from(container.querySelectorAll(env.pressSelector))) {
+        if (isNative(c)) continue;
+        wire(c, "0", "button");
+      }
+    } catch {
+    }
+  };
+  const onKey = (e) => {
+    if (destroyed || e.defaultPrevented) return;
+    const t = e.target;
+    if (!t || !container.contains(t)) return;
+    const k = e.key;
+    if (isClearChord(e)) {
+      e.preventDefault();
+      env.clear();
+      return;
+    }
+    const press = t.closest?.(env.pressSelector);
+    if (press && wired(press) && container.contains(press)) {
+      if (k === "Enter" || k === " " || k === "Spacebar") {
+        e.preventDefault();
+        const ME = container.ownerDocument.defaultView?.MouseEvent ?? MouseEvent;
+        press.dispatchEvent(new ME("click", { bubbles: true, cancelable: true }));
+      } else if (k === "Escape" && env.escapeClears !== false) env.clear();
+      return;
+    }
+    const mark = t.closest?.(env.markSelector);
+    if (!mark || !wired(mark) || !container.contains(mark)) return;
+    const list = marksNow().filter(wired);
+    const at = list.indexOf(mark);
+    const go = (i) => {
+      const to = list[Math.max(0, Math.min(list.length - 1, i))];
+      if (!to) return;
+      setRoving(list, to);
+      try {
+        to.focus({ preventScroll: false });
+      } catch {
+      }
+    };
+    switch (k) {
+      case "ArrowRight":
+      case "ArrowDown":
+        e.preventDefault();
+        go(at + 1);
+        break;
+      case "ArrowLeft":
+      case "ArrowUp":
+        e.preventDefault();
+        go(at - 1);
+        break;
+      case "Home":
+        e.preventDefault();
+        go(0);
+        break;
+      case "End":
+        e.preventDefault();
+        go(list.length - 1);
+        break;
+      case "Enter":
+      case " ":
+      case "Spacebar":
+        e.preventDefault();
+        rovingKey = env.keyOf(mark);
+        env.select(mark, { ctrl: !!(e.ctrlKey || e.metaKey), shift: !!e.shiftKey });
+        break;
+      case "Escape":
+        if (env.escapeClears !== false) env.clear();
+        break;
+    }
+  };
+  container.addEventListener("keydown", onKey);
+  return {
+    refresh,
+    destroy() {
+      destroyed = true;
+      container.removeEventListener("keydown", onKey);
+      try {
+        container.classList?.remove(KEYBOARD_CLASS);
+      } catch {
+      }
+    }
+  };
+}
+
 // src/host.ts
 function sessionViewStateProvider(container) {
   const holder = container;
@@ -2738,6 +2967,9 @@ function createChartHost(container, config) {
     }
   }
   let lassoClaimed = false;
+  let ownBag = null;
+  const seedKey = (s) => s && typeof s === "object" ? JSON.stringify(s) : void 0;
+  let lastSeed = seedKey(raw.uiState);
   if (typeof raw.setUiState !== "function") {
     const provider = config.viewState ?? sessionViewStateProvider(container);
     let bag;
@@ -2751,6 +2983,7 @@ function createChartHost(container, config) {
     if (raw.uiState && typeof raw.uiState === "object" && Object.keys(bag).length === 0)
       Object.assign(bag, raw.uiState);
     raw.uiState = bag;
+    ownBag = { bag, provider };
     raw.setUiState = (s) => {
       if (!s || typeof s !== "object") return;
       try {
@@ -2759,6 +2992,26 @@ function createChartHost(container, config) {
       }
     };
   }
+  const takeSeed = (partial) => {
+    if (typeof partial.setUiState === "function") {
+      ownBag = null;
+      return partial;
+    }
+    if (!ownBag || !("uiState" in partial)) return partial;
+    const { uiState: seed, ...rest } = partial;
+    const key = seedKey(seed);
+    if (key !== void 0 && key !== lastSeed) {
+      lastSeed = key;
+      const { bag, provider } = ownBag;
+      for (const k of Object.keys(bag)) delete bag[k];
+      Object.assign(bag, seed);
+      try {
+        provider.save({ ...bag });
+      } catch {
+      }
+    }
+    return rest;
+  };
   const resolveForHost = (input) => {
     const out = resolveOptions(input);
     return out.allowTooltips == null ? { ...out, allowTooltips: true } : out;
@@ -2773,7 +3026,9 @@ function createChartHost(container, config) {
   let warnedLassoNoFilter = false;
   const idScope = newIdScope();
   let renderSeq = 0;
-  const annotationLayer = createAnnotationLayer(container, (a) => config.onAnnotationClick?.(a));
+  const keyboardOn = codeHasKeyboardStamp(config.code);
+  let keyboard = null;
+  const annotationLayer = createAnnotationLayer(container, (a) => config.onAnnotationClick?.(a), { keyboard: () => keyboardOn });
   const drawAnnotations = () => annotationLayer.draw(
     { columns: data.columns, rows: data.rows },
     {
@@ -2857,7 +3112,18 @@ function createChartHost(container, config) {
    anomaly badge, a highlight stroke) and must keep dimming with its datum. */
 .${HOST_CONTAINER_CLASS} .${MARK_CLASS} { cursor: pointer; transition: opacity 120ms ease-in-out, filter 100ms ease-in-out; }
 .${HOST_CONTAINER_CLASS} .${MARK_CLASS}:not([${ROW_IDX_ATTR}=""]):hover { filter: brightness(1.1) drop-shadow(0 0 1.5px rgba(0,0,0,0.5)) !important; }
-.${HOST_CONTAINER_CLASS}:has(.${MARK_CLASS}:not([${ROW_IDX_ATTR}=""]):hover) .${MARK_CLASS}:not(:hover):not([${ROW_IDX_ATTR}=""]) { opacity: 0.55; }
+.${HOST_CONTAINER_CLASS}:not(.${MARKS_INERT_CLASS}):has(.${MARK_CLASS}:not([${ROW_IDX_ATTR}=""]):hover) .${MARK_CLASS}:not(:hover):not([${ROW_IDX_ATTR}=""]) { opacity: 0.55; }
+/* A MARK THAT SELECTS NOTHING DOESN'T LOOK CLICKABLE: no pointer, over the inline cursor generated code
+   sets on its marks, and no dimming of the others on hover (the rule above). A control the chart draws keeps its own. */
+.${HOST_CONTAINER_CLASS}.${MARKS_INERT_CLASS} .${MARK_CLASS} { cursor: default !important; }
+/* THE KEYBOARD'S FOCUS: a ring on the mark, control or badge that holds keyboard focus, in the colour the
+   chart's text is drawn in, so it reads in either theme. A pointer's focus shows none. */
+.${HOST_CONTAINER_CLASS}.${KEYBOARD_CLASS} [${WIRED_ATTR}]:focus:not(:focus-visible) { outline: none; }
+.${HOST_CONTAINER_CLASS}.${KEYBOARD_CLASS} [${WIRED_ATTR}]:focus-visible,
+.${HOST_CONTAINER_CLASS} .bic-annotation:focus-visible { outline: 2px solid var(--lch-focus-ring, currentColor) !important; outline-offset: 2px; }
+/* A dimmed mark that takes keyboard focus is drawn at full strength while it has it, ring included: the dim would
+   otherwise fade the ring with the mark. */
+.${HOST_CONTAINER_CLASS}.${KEYBOARD_CLASS}.${SELECTION_ACTIVE_CLASS} .${MARK_CLASS}[${WIRED_ATTR}]:focus-visible:not(.${MARK_SELECTED_CLASS}) { opacity: 1 !important; }
 .${HOST_CONTAINER_CLASS}.${SELECTION_ACTIVE_CLASS} .${MARK_CLASS}:not(.${MARK_SELECTED_CLASS}):not([${ROW_IDX_ATTR}=""]) {
     opacity: var(${DIM_OPACITY_VAR}, ${DIM_OPACITY_DEFAULT}) !important;
 }
@@ -2890,9 +3156,18 @@ function createChartHost(container, config) {
     } catch {
     }
   };
+  const marksInert = () => {
+    if (typeof config.marksSelect !== "function") return false;
+    try {
+      return config.marksSelect() === false;
+    } catch {
+      return false;
+    }
+  };
   const paintSelection = () => {
     if (destroyed) return;
     try {
+      container.classList?.[marksInert() ? "add" : "remove"](MARKS_INERT_CLASS);
       const sel = current;
       const active = !!sel && sel.length > 0;
       const dim = active && !selectionIsPeriod;
@@ -3161,6 +3436,7 @@ function createChartHost(container, config) {
     factFresh = true;
     paintSelection();
     paintGlyphLayer();
+    keyboard?.refresh();
     if (publish) for (const cb of subs) {
       try {
         cb(rowIdxs, source, meta);
@@ -3196,6 +3472,7 @@ function createChartHost(container, config) {
     const d = e?.detail || {};
     xfAt = Date.now();
     if (d.clear) notify([], d.source || "chart", void 0, false, selectionPublished || !(current && current.length));
+    else if (marksInert()) return;
     else if (d.mark) notify(parseRowIdxs(d.mark.getAttribute?.(ROW_IDX_ATTR)), d.source || "chart", d.mark, true);
     else if (Array.isArray(d.rows)) notify(validRowSet(d.rows), d.source || "chart", null, true, true, d.keepHidden === true ? { keepHidden: true } : void 0);
   };
@@ -3231,6 +3508,9 @@ function createChartHost(container, config) {
     const wasDrag = clickWasDrag(container, e);
     clearPress(container);
     if (wasDrag) return;
+    const inert = marksInert();
+    container.classList?.[inert ? "add" : "remove"](MARKS_INERT_CLASS);
+    if (inert) return;
     if (Date.now() - xfAt < XF_ECHO_MS) return;
     if (isInsideControl(e?.target, container)) return;
     let el = resolver.findMark(e?.target, clickSel, e);
@@ -3258,6 +3538,27 @@ function createChartHost(container, config) {
   container.addEventListener(XFILTER_REFRESH_EVENT, onXf);
   const untrackPress = trackPress(container);
   container.addEventListener("click", onClick);
+  if (keyboardOn) {
+    const nameOfRow = (m) => {
+      const r = parseRowIdxs(m.getAttribute(ROW_IDX_ATTR))[0];
+      return rowNameOf(data.columns || [], r == null ? null : data.rows?.[r], resolved.cultureCode);
+    };
+    keyboard = installKeyboard({
+      container,
+      markSelector: clickSel,
+      pressSelector: `.${CONTROL_CLASS}`,
+      skipSelector: `.${ANNOTATION_LAYER_CLASS}, .${GLYPH_LAYER_CLASS}, .${LASSO_OUTLINE_CLASS}`,
+      inert: marksInert,
+      select: (m, mods) => {
+        const ME = win?.MouseEvent ?? MouseEvent;
+        m.dispatchEvent(new ME("click", { bubbles: true, cancelable: true, ctrlKey: mods.ctrl, shiftKey: mods.shift }));
+      },
+      clear: clearFromGesture,
+      isSelected: (m) => !!m.classList?.contains(MARK_SELECTED_CLASS),
+      labelOf: nameOfRow,
+      keyOf: (m) => m.getAttribute(ROW_IDX_ATTR) ?? ""
+    });
+  }
   container.classList?.add(HOST_CONTAINER_CLASS);
   ensureAffordanceStyles();
   const fitOpts = config.fit ?? true;
@@ -3405,6 +3706,15 @@ function createChartHost(container, config) {
     } catch {
     }
     paintGlyphLayer();
+    installLassoHere();
+    keyboard?.refresh();
+    const fw = focusWas;
+    focusWas = null;
+    restoreFocus(container, fw);
+    selfRedraw?.takeRecords();
+    watchSelfRedraw();
+  };
+  function installLassoHere() {
     try {
       lasso = installLasso({
         container,
@@ -3415,7 +3725,38 @@ function createChartHost(container, config) {
       });
     } catch {
     }
+  }
+  let selfRedraw = null;
+  let focusWas = null;
+  let notesHeld = (config.annotations ?? []).length > 0;
+  const takesMarks = (n) => n.nodeType === 1 && (!!n.classList?.contains(MARK_CLASS) || !!n.querySelector?.(`.${MARK_CLASS}`));
+  const lassoLost = () => !!lasso?.surface && !lasso.surface.isConnected;
+  const repaintAfterChart = () => {
+    if (destroyed) return;
+    try {
+      ensureCrossfilterHitTargets(container, doc);
+    } catch {
+    }
+    paintSelection();
+    try {
+      drawAnnotations();
+    } catch {
+    }
+    paintGlyphLayer(false);
+    if (lassoLost()) installLassoHere();
+    keyboard?.refresh();
+    selfRedraw?.takeRecords();
   };
+  function watchSelfRedraw() {
+    const MO = win?.MutationObserver;
+    if (selfRedraw || !MO || destroyed) return;
+    selfRedraw = new MO((records) => {
+      if (destroyed || !records.some((r) => Array.from(r.removedNodes).some(takesMarks))) return;
+      if (!(current && current.length) && !notesHeld && !lassoLost()) return;
+      repaintAfterChart();
+    });
+    selfRedraw.observe(container, { childList: true, subtree: true });
+  }
   const renderFailure = (err) => {
     const message = String(err?.message ?? err ?? "");
     if (config.onInvalidSentinel && isInvalidSentinelError(message)) {
@@ -3435,7 +3776,9 @@ function createChartHost(container, config) {
       disposeLasso();
       flushZoom();
       if (hasRendered && keepScroll) rememberScroll(container, scrollKey());
+      focusWas = rememberFocus(container);
       container.innerHTML = "";
+      selfRedraw?.takeRecords();
       hasRendered = true;
       if (!renderFn) {
         if (!config.code) throw new Error("createChartHost: provide code or renderFn");
@@ -3461,6 +3804,7 @@ function createChartHost(container, config) {
       if (resolved.dateCellsAreUtcDays === void 0 && data.dateCellsAreUtcDays) resolved = { ...resolved, dateCellsAreUtcDays: true };
       if (resolved.suppressSelectionGlyph === void 0 && data.meta?.suppressSelectionGlyph === true)
         resolved = { ...resolved, suppressSelectionGlyph: true };
+      if (keyboardOn) resolved = { ...resolved, keyboardMarks: true };
       let outcome;
       zoomCap = null;
       if (zoomMemory && config.code && !config.renderFn) {
@@ -3536,7 +3880,7 @@ function createChartHost(container, config) {
     // callback) must not clear, stop or annotate the chart that is on screen now.
     setOptions(partial) {
       if (destroyed) return;
-      raw = { ...raw, ...partial };
+      raw = { ...raw, ...takeSeed(partial ?? {}) };
       resolved = resolveForHost(raw);
       host.render();
     },
@@ -3551,6 +3895,7 @@ function createChartHost(container, config) {
     },
     setAnnotations(list) {
       if (destroyed) return;
+      notesHeld = (list ?? []).length > 0;
       annotationLayer.set(list);
       try {
         drawAnnotations();
@@ -3612,6 +3957,12 @@ function createChartHost(container, config) {
       if (destroyed) return;
       destroyed = true;
       stopAnim();
+      if (selfRedraw) {
+        selfRedraw.disconnect();
+        selfRedraw = null;
+      }
+      keyboard?.destroy();
+      keyboard = null;
       container.removeEventListener(XFILTER_REFRESH_EVENT, onXf);
       container.removeEventListener("click", onClick);
       untrackPress();
@@ -3858,6 +4209,14 @@ export {
   invalidSentinelReason,
   ANNOTATION_LAYER_CLASS,
   ANNOTATION_CLASS,
+  rememberFocus,
+  restoreFocus,
+  KEYBOARD_STAMP,
+  codeHasKeyboardStamp,
+  KEYBOARD_CLASS,
+  WIRED_ATTR,
+  rowNameOf,
+  installKeyboard,
   sessionViewStateProvider,
   noopViewStateProvider,
   assembleD3,

package/dist/{chunk-JU2PQ22J.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-ESBH2L6E.mjs";
+} from "./chunk-4DOKJ3R3.mjs";
 
 // src/filterScope.ts
 function viewToken(view) {

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-OSREEGBN.mjs → chunk-TN5JRULV.mjs}

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

package/dist/{chunk-PHUUFCJY.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.21.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";
@@ -34,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;
@@ -101,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-FCLPMC6Q.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,
@@ -65,6 +68,7 @@ import {
   censusValuePlacement,
   cleanHostSelection,
   clippedTextFlag,
+  codeHasKeyboardStamp,
   colourSpreadFlag,
   compileRenderFn,
   compositeOver,
@@ -80,6 +84,7 @@ import {
   exportFormatsFor,
   exportTableService,
   glyphSampleGrid,
+  installKeyboard,
   invalidSentinelReason,
   isBlankRender,
   isInvalidSentinelError,
@@ -90,9 +95,12 @@ import {
   pickColorOver,
   pillBacksGlyph,
   relativeLuminance,
+  rememberFocus,
   requiredD3Plugins,
   resolveAutoColorScale,
   resolveOptions,
+  restoreFocus,
+  rowNameOf,
   scopeChartIds,
   sessionViewStateProvider,
   sheetName,
@@ -106,7 +114,7 @@ import {
   toRGBA,
   toSourceRows,
   valuePlacementFlag
-} from "./chunk-MO2GR56D.mjs";
+} from "./chunk-JQ7FFCOE.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -133,13 +141,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-ESBH2L6E.mjs";
+} from "./chunk-4DOKJ3R3.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-UKXGOQMS.mjs";
+} from "./chunk-GQLEU3VC.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -164,7 +172,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-LGWTV5PB.mjs";
+} from "./chunk-3ER4C7TG.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -193,7 +201,7 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-OSREEGBN.mjs";
+} from "./chunk-TN5JRULV.mjs";
 import {
   clearGeoCache,
   geoAssetFor,
@@ -206,7 +214,7 @@ import {
   Kt,
   l,
   o
-} from "./chunk-SYUJ4TPX.mjs";
+} from "./chunk-TH577JHI.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -244,6 +252,7 @@ import {
   HOST_CONTRACT_VERSION,
   LEGEND_MARK_CLASS,
   LIFT_SELECTED_CLASS,
+  MARKS_INERT_CLASS,
   MARK_CLASS,
   MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
@@ -262,7 +271,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-PHUUFCJY.mjs";
+} from "./chunk-USZSHKIB.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/hostLinks.ts
@@ -2368,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,
@@ -2394,6 +2406,7 @@ export {
   LIGHT_TEXT,
   LIMIT_COUNT_MAX,
   LIVE_OPTION_KEYS,
+  MARKS_INERT_CLASS,
   MARK_CLASS,
   MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
@@ -2487,6 +2500,7 @@ export {
   clearSelectionGlyphs,
   clickWasDrag,
   clippedTextFlag,
+  codeHasKeyboardStamp,
   codeReadsDatesInLocalTime,
   codeReadsOption,
   collectD3GlyphCenters,
@@ -2537,6 +2551,7 @@ export {
   htmlNaturalSize,
   htmlToSvgDataUrl,
   inlineFilterGate,
+  installKeyboard,
   installLasso,
   invalidSentinelReason,
   isBlankRender,
@@ -2630,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-FCLPMC6Q.mjs";
+} from "./chunk-3EQOJHRA.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-OSREEGBN.mjs";
-import "./chunk-PHUUFCJY.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-JU2PQ22J.mjs";
-import "./chunk-ESBH2L6E.mjs";
-import "./chunk-LGWTV5PB.mjs";
-import "./chunk-PHUUFCJY.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-JU2PQ22J.mjs";
+} from "./chunk-QAPZIFOB.mjs";
 import {
   assembleD3,
   createChartGroup,
   createChartHost,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-MO2GR56D.mjs";
-import "./chunk-ESBH2L6E.mjs";
-import "./chunk-UKXGOQMS.mjs";
-import "./chunk-LGWTV5PB.mjs";
-import "./chunk-OSREEGBN.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-PHUUFCJY.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-PHUUFCJY.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.21.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[];
@@ -90,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;
@@ -196,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;

package/dist/types/focusKeep.d.ts

@@ -0,0 +1,12 @@
+export interface FocusMemory {
+    sig: string;
+    nth: number;
+    start: number | null;
+    end: number | null;
+    dir: "forward" | "backward" | "none" | null;
+}
+/** The focused element inside the container and its caret, or null when focus is elsewhere (or on the container). */
+export declare function rememberFocus(container: HTMLElement): FocusMemory | null;
+/** Give focus back to the same element of the new draw, with its caret. Nothing when the chart already moved focus into
+ *  itself, or when the new draw has no such element. Returns whether focus was restored. */
+export declare function restoreFocus(container: HTMLElement, memory: FocusMemory | null): boolean;

package/dist/types/host.d.ts

@@ -280,6 +280,16 @@ export interface ChartHostConfig {
      * `selects` and the group itself. Never throws through: an answer that throws counts as reached.
      */
     selectionReachesPage?: () => boolean;
+    /**
+     * WHETHER A CLICK ON A MARK SELECTS ANYTHING. False: nothing listens to this chart's selection - no
+     * page filter, no group sibling, no callback - so its marks are drawn inert: no pointer cursor (over the chart's own
+     * inline one), no hover dimming of the others, and the reader's click, or a selection the chart dispatches itself,
+     * lights and dims nothing. A selection the page hands in (selection.highlight) still paints. Read at every click and
+     * every paint, so a binding added later counts at once. Absent: true, which every host but React relies on (a Power
+     * BI click always reaches its selection manager; an Excel click always opens a selection card). An answer that
+     * throws counts as true.
+     */
+    marksSelect?: () => boolean;
 }
 export interface ChartHost {
     /** Replace the notes drawn on marks (see ChartHostConfig.annotations); redraws them at once. */

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, NOTE_STYLE_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, CONTAINER_SLOT_SCROLL, CONTAINER_SLOT_HOST_SELECTION, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, DIM_OPACITY_MIN, 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, type XfilterRefreshDetail, type HostSelectionFact, } 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, NOTE_STYLE_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, CONTAINER_SLOT_SCROLL, CONTAINER_SLOT_HOST_SELECTION, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, MARKS_INERT_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, DIM_OPACITY_MIN, 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, type XfilterRefreshDetail, type HostSelectionFact, } from "./contract";
 export { resolveOptions, cleanHostSelection, type ResolveOptionsInput } from "./defaults";
 export { hostLinkServices, type HostLinkServices, type ClipboardLike } from "./hostLinks";
 export { tableToCsv, tableToXlsx, buildExportFile, exportFileName, sheetName as exportSheetName, excelNumberFormat, excelSerial, bytesToBase64, exportFormatsFor, exportTableService, browserSaveFile, EXPORT_FORMATS, XLSX_MIME, CSV_MIME, type ExportTable, type ExportColumn, type ExportColumnType, type ExportCell, type ExportFormat, type ExportFile, type SaveFileService, type ExportTableService, } from "./exportTable";
@@ -11,6 +11,8 @@ export { buildRenderPayload, type RenderPayload, type GeoPointBinding, type GeoB
 export { codeReadsDatesInLocalTime, vegaSpecReadsDatesInLocalTime } from "./dateCells";
 export { createChartHost, compileRenderFn, stripEsmExports, requiredD3Plugins, explainRenderFailure, sessionViewStateProvider, noopViewStateProvider, assembleD3, D3_PLUGIN_PACKAGES, type ChartHost, type ChartHostConfig, type RenderFn, type SelectionPaintReport, type SelectionChangeMeta } from "./host";
 export { ANNOTATION_CLASS, ANNOTATION_LAYER_CLASS, type MarkAnnotation, type AnnotationReport } from "./annotations";
+export { KEYBOARD_STAMP, KEYBOARD_CLASS, WIRED_ATTR as KEYBOARD_WIRED_ATTR, codeHasKeyboardStamp, installKeyboard, rowNameOf, type KeyboardEnv, type KeyboardHandle } from "./keyboardMarks";
+export { rememberFocus, restoreFocus, type FocusMemory } from "./focusKeep";
 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";

package/dist/types/keyboardMarks.d.ts

@@ -0,0 +1,43 @@
+export declare const KEYBOARD_STAMP = "// bic:keyboard-marks";
+/** Whether the code carries the keyboard stamp in its header. */
+export declare function codeHasKeyboardStamp(code: unknown): boolean;
+/** On the container while its chart works from the keyboard. */
+export declare const KEYBOARD_CLASS = "lch-keyboard";
+/** On each element the host made focusable, so it never touches one the chart made focusable itself. */
+export declare const WIRED_ATTR = "data-lch-kb";
+export interface KeyboardEnv {
+    container: HTMLElement;
+    /** The elements a click selects (the host's click selector). */
+    markSelector: string;
+    /** Elements pressed with Enter: the chart's declared controls and the host's badges. */
+    pressSelector: string;
+    /** Elements never to treat as marks (the host's own layers). */
+    skipSelector: string;
+    /** True while a click on a mark selects nothing (the marks are then not made focusable). */
+    inert(): boolean;
+    /** Select a mark as a click on it would. */
+    select(mark: Element, mods: {
+        ctrl: boolean;
+        shift: boolean;
+    }): void;
+    /** The reader's clear: Ctrl+Shift+C on every host (Power BI's own clear-selection key), and Escape where the host
+     *  lets it (escapeClears). */
+    clear(): void;
+    /** Whether Escape clears. False for a host whose frame uses Escape to move focus out of the chart (Power BI), so
+     *  leaving the chart never wipes the reader's selection there. Default true. */
+    escapeClears?: boolean;
+    isSelected(mark: Element): boolean;
+    /** What a screen reader calls a mark that names nothing itself. */
+    labelOf(mark: Element): string | null;
+    /** A stable key for a mark across redraws (its rows). */
+    keyOf(mark: Element): string;
+}
+export interface KeyboardHandle {
+    /** Re-apply tab stops, roles, names and pressed state after a draw or a selection change. */
+    refresh(): void;
+    destroy(): void;
+}
+/** What a screen reader calls a row: its first few values, numbers in the reader's culture, internal columns left out.
+ *  Shared so every host names a mark the same way. */
+export declare function rowNameOf(columns: ReadonlyArray<unknown>, row: ReadonlyArray<unknown> | null | undefined, culture?: string): string | null;
+export declare function installKeyboard(env: KeyboardEnv): KeyboardHandle;

package/dist/zoom-memory.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 {
   K
-} from "./chunk-SYUJ4TPX.mjs";
+} from "./chunk-TH577JHI.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/zoomMemory/zoomMemory.ts

package/package.json

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