@bicharts/chart-host 0.6.106 → 0.6.108

package/dist/adapters.mjs

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

package/dist/{chunk-IE426WU6.mjs → chunk-ESBH2L6E.mjs}

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

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

package/dist/{chunk-TLIBO5PT.mjs → chunk-JU2PQ22J.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-ESBH2L6E.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-P2DLK7WZ.mjs → chunk-LGWTV5PB.mjs}

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

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

@@ -4,11 +4,11 @@ import {
   claimParkedLasso,
   installLasso,
   lassoEffect
-} from "./chunk-IE426WU6.mjs";
+} from "./chunk-ESBH2L6E.mjs";
 import {
   censusHitBands,
   ensureCrossfilterHitTargets
-} from "./chunk-CPLWAW3Z.mjs";
+} from "./chunk-UKXGOQMS.mjs";
 import {
   clearPress,
   clearSelectionGlyphs,
@@ -25,14 +25,14 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-P2DLK7WZ.mjs";
+} from "./chunk-LGWTV5PB.mjs";
 import {
   clipWindowOf,
   fitRenderedChart,
   rememberScroll,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-IE7TM6DX.mjs";
+} from "./chunk-OSREEGBN.mjs";
 import {
   geoFromCache
 } from "./chunk-5WTQN5DL.mjs";
@@ -61,6 +61,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_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
@@ -86,7 +87,7 @@ import {
   XFILTER_REFRESH_EVENT,
   chartOwnsTimeline,
   periodTickSuppressesFeedback
-} from "./chunk-7XRQUFVH.mjs";
+} from "./chunk-PHUUFCJY.mjs";
 
 // src/labelContrast.ts
 function parseRGBA(c) {
@@ -1057,6 +1058,18 @@ function themedLand(p) {
   const fg = toRGBA(p.themeFg) ?? [255, 255, 255, 1];
   return "#" + compositeOver([fg[0], fg[1], fg[2], 0.18], [bg[0], bg[1], bg[2]]).map((v) => v.toString(16).padStart(2, "0")).join("");
 }
+function cleanHostSelection(v) {
+  if (!v || typeof v !== "object" || !Array.isArray(v.rows)) return void 0;
+  const raw = v.rows;
+  const rows = Array.from(new Set(raw.filter((n2) => typeof n2 === "number" && Number.isInteger(n2) && n2 >= 0))).sort((a, b) => a - b);
+  const h = Number(v.hidden);
+  const out = { rows, hidden: Number.isFinite(h) && h > 0 ? Math.floor(h) : 0 };
+  const n = v.narrowed;
+  if (n && typeof n === "object" && Number.isInteger(n.published) && Number.isInteger(n.kept) && n.kept >= 0 && n.kept < n.published) {
+    out.narrowed = { published: n.published, kept: n.kept };
+  }
+  return out;
+}
 var clamp = (n, lo, hi) => Math.max(lo, Math.min(hi, n));
 var numberOr = (raw, dflt) => {
   const n = raw == null || raw === "" ? NaN : Number(raw);
@@ -1080,6 +1093,8 @@ function resolveOptions(p) {
     // tests/defaults.test.ts now compares the two lists, because four instances of one
     // omission is a missing check, not four mistakes.
     geoPointDest: p.geoPointDest,
+    // Why a point map placed nothing (the resolver's sentences), passed through untouched.
+    geoPointRefused: p.geoPointRefused,
     // A host FACT about the data it serialised (contract 1.9.0), passed through untouched.
     dateCellsAreUtcDays: p.dateCellsAreUtcDays,
     // Host FACTS about whether every row arrived (contract 1.15.0), passed through untouched: an
@@ -1087,6 +1102,8 @@ function resolveOptions(p) {
     dataComplete: p.dataComplete,
     rowsWithheld: p.rowsWithheld,
     rowsFilteredOut: p.rowsFilteredOut,
+    // A host FACT about its selection (contract 1.21.0), cleaned, never invented: absent stays absent.
+    hostSelection: cleanHostSelection(p.hostSelection),
     // Host services (contract 1.18.0): a FUNCTION or nothing, so a junk value never reaches a chart as something
     // it would try to call. Passed through untouched otherwise: the host owns what opening or copying means.
     openUrl: typeof p.openUrl === "function" ? p.openUrl : void 0,
@@ -2800,6 +2817,21 @@ function createChartHost(container, config) {
     }
   };
   const subs = /* @__PURE__ */ new Set();
+  let hiddenHeld = 0;
+  let factFresh = true;
+  const selectionFact = () => {
+    const n = Array.isArray(data?.rows) ? data.rows.length : 0;
+    const rows = Array.from(new Set((current ?? []).filter((r) => Number.isInteger(r) && r >= 0 && r < n))).sort((a, b) => a - b);
+    return { rows, hidden: hiddenHeld };
+  };
+  const tellSelection = () => {
+    const slot = container[CONTAINER_SLOT_HOST_SELECTION];
+    if (typeof slot !== "function") return;
+    try {
+      slot(selectionFact());
+    } catch {
+    }
+  };
   const ensureAffordanceStyles = () => {
     try {
       if (!doc || doc.getElementById("bic-chart-host-affordances")) return;
@@ -3118,22 +3150,24 @@ function createChartHost(container, config) {
       }
     }
   };
-  const notify = (rowIdxs, source, tick, fromChart = false, publish = true) => {
+  const notify = (rowIdxs, source, tick, fromChart = false, publish = true, meta) => {
     if (destroyed) return;
     current = rowIdxs;
     selectionFromChart = rowIdxs.length > 0 && fromChart;
     selectionPublished = publish;
     activeTickEl = rowIdxs.length ? tick ?? null : null;
     selectionIsPeriod = rowIdxs.length > 0 && periodTickSuppressesFeedback(!!tick, chartOwnsTimeline(container));
+    if (!rowIdxs.length && !meta?.keepHidden) hiddenHeld = 0;
+    factFresh = true;
     paintSelection();
     paintGlyphLayer();
-    if (!publish) return;
-    for (const cb of subs) {
+    if (publish) for (const cb of subs) {
       try {
-        cb(rowIdxs, source);
+        cb(rowIdxs, source, meta);
       } catch {
       }
     }
+    tellSelection();
   };
   const selectFromLasso = (rows) => {
     if (lassoEffect(resolved.lasso) === "highlight") {
@@ -3163,7 +3197,7 @@ function createChartHost(container, config) {
     xfAt = Date.now();
     if (d.clear) notify([], d.source || "chart", void 0, false, selectionPublished || !(current && current.length));
     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);
+    else if (Array.isArray(d.rows)) notify(validRowSet(d.rows), d.source || "chart", null, true, true, d.keepHidden === true ? { keepHidden: true } : void 0);
   };
   const resolver = createMarkResolver({
     root: container,
@@ -3423,6 +3457,7 @@ function createChartHost(container, config) {
       if (resolved.geoUnmatched === void 0 && data.geoUnmatched) resolved = { ...resolved, geoUnmatched: data.geoUnmatched };
       if (resolved.geoPoint === void 0 && data.geoPoint) resolved = { ...resolved, geoPoint: data.geoPoint };
       if (resolved.geoPointDest === void 0 && data.geoPointDest) resolved = { ...resolved, geoPointDest: data.geoPointDest };
+      if (resolved.geoPointRefused === void 0 && data.geoPointRefused?.length) resolved = { ...resolved, geoPointRefused: data.geoPointRefused };
       if (resolved.dateCellsAreUtcDays === void 0 && data.dateCellsAreUtcDays) resolved = { ...resolved, dateCellsAreUtcDays: true };
       if (resolved.suppressSelectionGlyph === void 0 && data.meta?.suppressSelectionGlyph === true)
         resolved = { ...resolved, suppressSelectionGlyph: true };
@@ -3440,6 +3475,7 @@ function createChartHost(container, config) {
           zoomCap = null;
         }
       }
+      if (raw.hostSelection == null) resolved.hostSelection = factFresh ? selectionFact() : void 0;
       try {
         try {
           outcome = renderFn(container, { columns: data.columns, rows: data.rows }, resolved);
@@ -3507,6 +3543,7 @@ function createChartHost(container, config) {
     setData(next) {
       if (destroyed) return;
       data = next;
+      factFresh = false;
       host.render();
     },
     get options() {
@@ -3552,6 +3589,15 @@ function createChartHost(container, config) {
         if (lasso && lasso.rows().length && !sameRowSet(rows, lasso.rows())) lasso.clear({ publish: false, source: "host" });
         notify(rows, "host");
       },
+      setHidden(count) {
+        if (destroyed) return;
+        const n = Number(count);
+        const next = Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+        if (next === hiddenHeld && factFresh) return;
+        hiddenHeld = next;
+        factFresh = true;
+        tellSelection();
+      },
       get current() {
         return current;
       }
@@ -3789,6 +3835,7 @@ export {
   exportFormatsFor,
   exportTableService,
   browserSaveFile,
+  cleanHostSelection,
   resolveOptions,
   buildRenderPayload,
   stripJsComments,

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

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

package/dist/{chunk-7XRQUFVH.mjs → chunk-PHUUFCJY.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.21.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";
@@ -88,6 +89,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,

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

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

package/dist/index.mjs

@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-PA5V6J6K.mjs";
+} from "./chunk-FCLPMC6Q.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -63,6 +63,7 @@ import {
   censusColourSpread,
   censusMarks,
   censusValuePlacement,
+  cleanHostSelection,
   clippedTextFlag,
   colourSpreadFlag,
   compileRenderFn,
@@ -105,7 +106,7 @@ import {
   toRGBA,
   toSourceRows,
   valuePlacementFlag
-} from "./chunk-K6UXTDMR.mjs";
+} from "./chunk-MO2GR56D.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -132,13 +133,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-IE426WU6.mjs";
+} from "./chunk-ESBH2L6E.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-CPLWAW3Z.mjs";
+} from "./chunk-UKXGOQMS.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -163,7 +164,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-P2DLK7WZ.mjs";
+} from "./chunk-LGWTV5PB.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -192,7 +193,7 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-IE7TM6DX.mjs";
+} from "./chunk-OSREEGBN.mjs";
 import {
   clearGeoCache,
   geoAssetFor,
@@ -225,6 +226,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,
@@ -260,7 +262,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-7XRQUFVH.mjs";
+} from "./chunk-PHUUFCJY.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/hostLinks.ts
@@ -2130,7 +2132,7 @@ function transportFailureShouldRecover(_headersReceived, genNew) {
   return genNew;
 }
 var TRANSPORT_LOST_CHECKING_MESSAGE = "The connection dropped while your chart was being generated - checking whether it finished on the server...";
-var GENERATION_CANCELLED_MESSAGE = "The connection dropped before the chart finished - nothing was charged. Generate again.";
+var GENERATION_CANCELLED_MESSAGE = "The connection dropped before the chart finished. You were charged only for the work already done. Generate again.";
 function recoveryAnswerIsCancelled(r2) {
   return !!r2 && r2.isGenerationCancelled === true;
 }
@@ -2153,7 +2155,7 @@ function recoveryFinalOutcome(r2) {
   return null;
 }
 function recoveryProvesNothingCharged(o3) {
-  return o3 === "cancelled" || o3 === "not-received";
+  return o3 === "not-received";
 }
 function recoveryGiveUpRefunds(outcome) {
   return outcome === "window-closed" || outcome === "hard-error" || outcome === "unreachable";
@@ -2330,6 +2332,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,
@@ -2477,6 +2480,7 @@ export {
   chartOwnsTimeline,
   chartSvgOf,
   chooserFitsViewport,
+  cleanHostSelection,
   clearGeoCache,
   clearLasso,
   clearPress,

package/dist/legend-fit.mjs

@@ -2,13 +2,13 @@
 import {
   chartSvgOf,
   tableHostOf
-} from "./chunk-PA5V6J6K.mjs";
+} from "./chunk-FCLPMC6Q.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-IE7TM6DX.mjs";
-import "./chunk-7XRQUFVH.mjs";
+} from "./chunk-OSREEGBN.mjs";
+import "./chunk-PHUUFCJY.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-JU2PQ22J.mjs";
+import "./chunk-ESBH2L6E.mjs";
+import "./chunk-LGWTV5PB.mjs";
+import "./chunk-PHUUFCJY.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   LINKED_HOVER_CLASS,

package/dist/react.mjs

@@ -13,25 +13,25 @@ import {
   payloadRowReader,
   viewFromToken,
   viewToken
-} from "./chunk-TLIBO5PT.mjs";
+} from "./chunk-JU2PQ22J.mjs";
 import {
   assembleD3,
   createChartGroup,
   createChartHost,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-K6UXTDMR.mjs";
-import "./chunk-IE426WU6.mjs";
-import "./chunk-CPLWAW3Z.mjs";
-import "./chunk-P2DLK7WZ.mjs";
-import "./chunk-IE7TM6DX.mjs";
+} from "./chunk-MO2GR56D.mjs";
+import "./chunk-ESBH2L6E.mjs";
+import "./chunk-UKXGOQMS.mjs";
+import "./chunk-LGWTV5PB.mjs";
+import "./chunk-OSREEGBN.mjs";
 import {
   geoFromCache,
   loadGeo
 } from "./chunk-5WTQN5DL.mjs";
 import "./chunk-SYUJ4TPX.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-7XRQUFVH.mjs";
+import "./chunk-PHUUFCJY.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-7XRQUFVH.mjs";
+} from "./chunk-PHUUFCJY.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/testing/interact.ts

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.21.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";
@@ -124,10 +142,12 @@ export interface RenderOptions {
         rolesBackfilled?: string[];
         rolesRefused?: string[];
     } | null;
+    geoPointRefused?: string[];
     dateCellsAreUtcDays?: boolean;
     dataComplete?: boolean;
     rowsWithheld?: number;
     rowsFilteredOut?: number;
+    hostSelection?: HostSelectionFact;
     openUrl?: (url: string) => void;
     copyText?: (text: string) => boolean | void | Promise<boolean | void>;
     saveFile?: SaveFileService;

package/dist/types/defaults.d.ts

@@ -1,4 +1,5 @@
-import { type RenderOptions } from "./contract";
+import { type RenderOptions, type HostSelectionFact } from "./contract";
+export declare function cleanHostSelection(v: unknown): HostSelectionFact | undefined;
 export type ResolveOptionsInput = {
     [K in keyof RenderOptions]?: any;
 };

package/dist/types/filterScope.d.ts

@@ -62,8 +62,9 @@ export interface Filter {
     readonly reason: FilterChangeReason | null;
     /** Bumped on every change: a cheap identity for memoising on the filter's state. */
     readonly version: number;
-    /** Select these rows' keys (replacing the selection). An empty list clears. */
-    selectRows(rows: readonly Record<string, unknown>[], reason?: FilterChangeReason): void;
+    /** Select these rows' keys (replacing the selection). An empty list clears. `keep` adds keys held already that these
+     *  rows cannot name (keys another filter hid from the chart that made the selection): they stay selected. */
+    selectRows(rows: readonly Record<string, unknown>[], reason?: FilterChangeReason, keep?: readonly FilterKey[]): void;
     /** Select keys by value: one value per key (a one-column filter) or one array per key. */
     set(keys: readonly unknown[] | readonly FilterKey[] | unknown, reason?: FilterChangeReason): void;
     /** Clear the selection (and every bound chart's marks). */
@@ -119,9 +120,8 @@ export declare function createFilter(columns: string | readonly string[], opts?:
 export declare function createFilterScope(): FilterScope;
 export interface FilterBinding {
     /**
-     * Call after the chart is handed new data. A selection whose key is still drawn is repainted;
-     * one whose key is gone is cleared (reason "data") when this chart made it. An empty payload is
-     * treated as data still arriving, not as the key being gone.
+     * Call after the chart is handed new data. The selection is repainted where its keys are drawn now, and a key the new
+     * rows do not carry stays selected (the chart is told how many through hostSelection.hidden): new data never clears it.
      */
     reconcile(): void;
     /** Repaint the filter's selection onto the chart's marks. */

package/dist/types/host.d.ts

@@ -2,6 +2,11 @@ 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. */
+/** What a selection change carries besides its rows (1.21.0): `keepHidden` when the chart's set is what the reader holds among
+ *  the rows in view, so a subscriber that holds keys the data no longer carries keeps them. */
+export interface SelectionChangeMeta {
+    keepHidden?: boolean;
+}
 export interface SelectionPaintReport {
     rule: SelectionRule;
     mode: SelectionPaintMode;
@@ -55,6 +60,8 @@ export interface ChartHostConfig {
          *  into options exactly like geoPoint, so a host that hands over the whole payload
          *  gets both ends annotated without knowing the field exists. */
         geoPointDest?: RenderOptions["geoPointDest"];
+        /** Why a point map placed nothing (the resolver's sentences) - promoted into options exactly like geoPoint. */
+        geoPointRefused?: string[];
         /** Set by buildRenderPayload(..., { utcDays: true }) - promoted into options exactly like geoPoint. */
         dateCellsAreUtcDays?: boolean;
         /** Provenance the MCP stamps into data.sample.json. `hostContract` is checked
@@ -302,7 +309,7 @@ export interface ChartHost {
     selection: {
         /** Subscribe to cross-filter changes (mark clicks + the chart's own
          *  llm-xfilter-refresh dispatches). rowIdxs = [] means cleared. */
-        onChange(cb: (rowIdxs: number[], source: string) => void): () => void;
+        onChange(cb: (rowIdxs: number[], source: string, meta?: SelectionChangeMeta) => void): () => void;
         /** Clear the chart's own selection (calls __llmXfClear when the chart set it). */
         clear(): void;
         /**
@@ -321,6 +328,12 @@ export interface ChartHost {
          * republish what the other just sent and fight itself.
          */
         highlight(rowIdxs: number[]): void;
+        /**
+         * How many of the selection's identities the data on screen does not carry (1.21.0): a filter keyed by value that
+         * another filter narrowed knows, this host does not. Told to the chart (RenderOptions.hostSelection and the
+         * CONTAINER_SLOT_HOST_SELECTION slot), so a checkbox column can say "2 selected, 2 hidden". A clear resets it.
+         */
+        setHidden?(count: number): void;
         readonly current: number[] | null;
     };
     animation: {

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
-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, 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, } from "./contract";
-export { resolveOptions, type ResolveOptionsInput } from "./defaults";
+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 { 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";
 export { OPTIONS_VOCABULARY, LIVE_OPTION_KEYS, MAX_MAP_POINTS_MIN, MAX_MAP_POINTS_MAX, LIMIT_COUNT_MAX, wireLimitCount, codeReadsOption, type OptionVocabularyEntry, type OptionTiming, type OptionWire, type OptionKey, } from "./optionsVocabulary";
@@ -9,7 +9,7 @@ export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clea
 export declare function registerCityTable(packed: string): void;
 export { buildRenderPayload, type RenderPayload, type GeoPointBinding, type GeoBinding, type GeoProvinceReport, type ProvinceJoin } 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, type SelectionPaintReport } from "./host";
+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 type { MarkNoteLike, NoteBadgeOptions } from "./markNotes";
 export type { Controls, ControlInfo, ControlsAttachment } from "./controls";

package/dist/types/pendingGenerate.d.ts

@@ -190,7 +190,7 @@ export declare const TRANSPORT_LOST_CHECKING_MESSAGE = "The connection dropped w
  * own. The server's errorMessage is preferred - it is the one author of the sentence - and this is the same
  * sentence, for a server that set the flag and left the message blank.
  */
-export declare const GENERATION_CANCELLED_MESSAGE = "The connection dropped before the chart finished - nothing was charged. Generate again.";
+export declare const GENERATION_CANCELLED_MESSAGE = "The connection dropped before the chart finished. You were charged only for the work already done. Generate again.";
 /**
  * Is this recovery answer the server saying the generation was CANCELLED - so nothing will ever be ready?
  *
@@ -217,9 +217,10 @@ export declare function recoveryFinalOutcome(r: {
     isVersionNotFound?: boolean | null;
     errorCode?: string | null;
 } | null | undefined): RecoveryFinalOutcome | null;
-/** Did the server PROVE nothing was charged? Only a cancel and a request it never received do; a
- *  failed generation's charge is its own, and a generate that died with a restart may have been charged
- *  before its record was written, so a host claims nothing about either. */
+/** Did the server PROVE nothing was charged? Only a request it never received does. A cancel is billed for
+ *  the passes that ran before it; a failed generation's charge is its own, and a
+ *  generate that died with a restart may have been charged before its record was written, so a host claims
+ *  nothing about any of those. */
 export declare function recoveryProvesNothingCharged(o: string | null | undefined): boolean;
 /** Does a recovery that ended this way send the refund? Only when it ended with NOTHING PAINTED and
  *  nothing proven - the window closed, the poll itself was refused, or the service could not be

package/dist/types/react.d.ts

@@ -95,7 +95,7 @@ export interface BicChartProps {
      * THE PAGE FILTER THIS CHART SELECTS - from useBicFilter("RegionCode"). A click sets it, the
      * same click or a click on empty canvas clears it, and the filter's state is painted onto the
      * marks whoever changed it: `filter.clear()` from a page button clears the marks too. New data
-     * keeps a selection whose key is still drawn and clears (reason "data") one whose key is gone.
+     * keeps the selection, a key it no longer draws included; the chart is told how many are hidden.
      * The page reads `filter.value` / `filter.row` and never writes a select handler. With
      * `selects`, the filter owns what this chart shows as selected.
      */

package/package.json

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