@bicharts/chart-host 0.6.88 → 0.6.90

package/README.md

@@ -277,6 +277,41 @@ stylesheet's `0.25`, or whatever your page sets on the variable.
 createChartHost(el, { code, data, options: { dimOpacity: 0.15 } });
 ```
 
+**A glyph on each selected mark.** `options.selectionGlyph` (`"dot"` or `"check"`; absent or
+`"none"` draws nothing, the default) puts a small glyph on every selected mark, in a layer the host
+owns inside the container (`.bic-selection-glyphs`, each glyph `.lch-sel-glyph`, never hit-tested).
+It is painted after every selection change and, on a redraw, after the layout pass and the fit, so
+nothing measures it as part of the chart. Only a mark the reader can see gets one: a mark hidden by
+`visibility` or `opacity` (a legend toggle) and a mark outside its svg's frame or its plot's
+`clip-path` (a point panned into the axis margin) get none. While a selection is lit, a mark that
+moves or hides without a redraw (a pan or zoom, a transition, an animation frame, a legend toggle)
+takes its glyph with it on the next frame; a write that holds no mark (a hover dot, a tooltip)
+repaints nothing, and that repaint is not reported again. Where the browser has a `ResizeObserver`,
+a container resized without a redraw (a responsive chart, a hidden tab shown) is repainted too, and
+reported when it drew a different count. The layer clips at the container's scroll area, so a
+glyph never widens what the container scrolls, and it sits under the note badges, under a chart's
+own tooltip or control that sets a `z-index` above 1, and under a pinned axis, so a glyph on a row
+scrolled beneath the axis is covered with its row. When the page left the container
+`position: static`, the host makes it `relative` so the layer scrolls and clips with the marks, and
+`destroy()` puts back what the page had. A period picked on a chart's own timeline dims nothing and
+marks nothing.
+
+Some charts never take a glyph: on a flow or relationship chart a selected series would get one on
+every point. The generate answer says so (`suppressSelectionGlyph`, read by shape-core's
+`parseGenerateResponse`); pass it as `options.suppressSelectionGlyph`, or leave it in the payload's
+`meta` (`data.meta.suppressSelectionGlyph`) and the host promotes it, the way it promotes
+`geoPoint`. Keep it with the chart's code, so a redraw from a cache honors it too.
+`onSelectionGlyphs` reports what each paint did (`{ mode, drawn, total, suppressed }`), and is
+called only when a glyph mode is set:
+
+```js
+createChartHost(el, {
+  code, data,
+  options: { selectionGlyph: "dot", suppressSelectionGlyph: answer.suppressSelectionGlyph },
+  onSelectionGlyphs: r => console.debug("glyphs", r),
+});
+```
+
 **Which marks count as selected.** By default a mark is selected when *any* of the rows in its
 `data-row-idx` list is selected, which is what lights a legend swatch together with its series. A
 chart whose marks share rows declares the other rule by stamping
@@ -385,6 +420,20 @@ only while `rememberAcrossSessions()` is true. It is keyed by the chart's code a
 somewhere arbitrary. A chart with several zoomable panels is left alone. In React, pass the hook as
 the `zoomMemory` prop of `<BicChart>`.
 
+**A scrolled chart** keeps its place with no setup. A chart taller than its frame scrolls, and every
+redraw empties the container, which used to send the reader back to the top. The host now parks the
+scroll offset on the container before it clears it, and the fit puts it back once the new layout has
+decided whether it still scrolls. The offset is clamped to what the new layout can scroll, and only
+restored on an axis that still scrolls. That covers a resize, a filter, a restyle, and a new host
+created on the same element. The memory is keyed by the chart (its `code`, or the `renderFn`'s
+source text), so a different chart opens at the top, while a `renderFn` closure rebuilt on every draw
+is still the same chart. It lives on the element for the session
+only, and nothing is persisted. A page that manages the container's scrolling itself passes
+`restoreScroll: false` (the `restoreScroll` prop of `<BicChart>`), and then nothing is remembered or
+restored. A host that clears and fits its container on its own can use the same pieces:
+`rememberScroll` before the clear, `takeScroll` after the render, and `fitRenderedChart`'s
+`restoreScroll` option (or the pure `planScrollRestore`).
+
 ## Keeping a drawn chart readable inside its frame
 
 A generated chart cannot know how wide its own legend text will come out, where its tick labels will

package/dist/adapters.mjs

@@ -3,7 +3,7 @@ import {
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-XNS34AMM.mjs";
+} from "./chunk-PDVEIW42.mjs";
 import {
   clickWasDrag,
   collectD3GlyphCenters,
@@ -12,13 +12,13 @@ import {
   markKeyOf,
   rowIdxsFromMark,
   selectionRuleOf
-} from "./chunk-IUXNCX7D.mjs";
+} from "./chunk-VEVBXK44.mjs";
 import {
   AXIS_FILTER_CLASS,
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-YDHXOIAI.mjs";
+} from "./chunk-45VILLJT.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/adapters/types.ts

package/dist/{chunk-YDHXOIAI.mjs → chunk-45VILLJT.mjs}

@@ -19,6 +19,7 @@ var CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
 var CONTAINER_SLOT_XF_CLEAR = "__llmXfClear";
 var CONTAINER_SLOT_INITIAL_XF_MARK = "__llmInitialXfMark";
 var CONTAINER_SLOT_UI_STATE = "__lchUiState";
+var CONTAINER_SLOT_SCROLL = "__lchScroll";
 var CONTAINER_SLOT_CLICKED_MARKS = "__lchClickedMarks";
 var VIEW_ONLY_UI_STATE_KEYS = Object.freeze(["camera", "llmZoom"]);
 function withoutViewOnlyKeys(bag) {
@@ -89,6 +90,7 @@ export {
   CONTAINER_SLOT_XF_CLEAR,
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
+  CONTAINER_SLOT_SCROLL,
   CONTAINER_SLOT_CLICKED_MARKS,
   VIEW_ONLY_UI_STATE_KEYS,
   withoutViewOnlyKeys,

package/dist/{chunk-56IZWXW2.mjs → chunk-CR7DSJVG.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-IZXVV74H.mjs";
+} from "./chunk-QHMLMF4L.mjs";
 
 // src/filterScope.ts
 function viewToken(view) {

package/dist/{chunk-HXH6NIRV.mjs → chunk-FHHT7DBM.mjs}

@@ -2,30 +2,35 @@
 import {
   LASSO_OUTLINE_CLASS,
   installLasso
-} from "./chunk-IZXVV74H.mjs";
+} from "./chunk-QHMLMF4L.mjs";
 import {
   censusHitBands,
   ensureCrossfilterHitTargets
-} from "./chunk-XNS34AMM.mjs";
+} from "./chunk-PDVEIW42.mjs";
 import {
   clearPress,
+  clearSelectionGlyphs,
   clickWasDrag,
+  collectGlyphCentersWhere,
   createMarkResolver,
   isInsideControl,
   markKeyOf,
   nextClickedMarks,
   nextSelection,
+  paintSelectionGlyphs,
   planSelectionPaint,
   sameRowSet,
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-IUXNCX7D.mjs";
+} from "./chunk-VEVBXK44.mjs";
 import {
   clipWindowOf,
   fitRenderedChart,
+  rememberScroll,
+  takeScroll,
   unpinScrolledAxis
-} from "./chunk-QHIPRAZK.mjs";
+} from "./chunk-NNLBFIWU.mjs";
 import {
   Fn,
   J3,
@@ -79,7 +84,7 @@ import {
   XFILTER_REFRESH_EVENT,
   chartOwnsTimeline,
   periodTickSuppressesFeedback
-} from "./chunk-YDHXOIAI.mjs";
+} from "./chunk-45VILLJT.mjs";
 
 // src/labelContrast.ts
 function parseRGBA(c) {
@@ -615,6 +620,14 @@ function resolveOptions(p) {
       const n = numberOr(p.dimOpacity, NaN);
       return Number.isFinite(n) ? clamp(n, DIM_OPACITY_MIN, 1) : void 0;
     })(),
+    // A recognised glyph or none: an unknown string must never reach the painter as a live mode, and "none" is
+    // undefined rather than a value, so a host that passes nothing and one that passes "none" resolve alike.
+    selectionGlyph: (() => {
+      const v = (p.selectionGlyph == null ? "" : String(p.selectionGlyph)).toLowerCase();
+      return v === "dot" || v === "check" ? v : void 0;
+    })(),
+    // A host FACT from the generate answer, true only for a literal true: silence never suppresses anything.
+    suppressSelectionGlyph: p.suppressSelectionGlyph === 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.
@@ -2208,12 +2221,209 @@ function createChartHost(container, config) {
     } catch {
     }
   };
+  const GLYPH_LAYER_CLASS = "bic-selection-glyphs";
+  let glyphPositionWas = null;
+  let glyphObserver = null;
+  let glyphResize = null;
+  let glyphSize = "";
+  let glyphQueued = false;
+  let glyphQueuedReport = false;
+  let glyphReported = "";
+  const sizeOfContainer = () => `${container.offsetWidth ?? 0}x${container.offsetHeight ?? 0}`;
+  const glyphBlind = `.${GLYPH_LAYER_CLASS}, .${LASSO_OUTLINE_CLASS}`;
+  const movesAMark = (r) => {
+    const t = r.target;
+    if (!t || t.closest?.(glyphBlind)) return false;
+    return !!(t.classList?.contains(MARK_CLASS) || t.querySelector?.(`.${MARK_CLASS}`));
+  };
+  const queueGlyphs = (reportIfChanged) => {
+    if (reportIfChanged) glyphQueuedReport = true;
+    if (glyphQueued) return;
+    glyphQueued = true;
+    const run = () => {
+      const r = glyphQueuedReport;
+      glyphQueued = false;
+      glyphQueuedReport = false;
+      if (glyphObserver || glyphResize) paintGlyphLayer(r ? "if-changed" : false);
+    };
+    if (win?.requestAnimationFrame) win.requestAnimationFrame(run);
+    else setTimeout(run, 16);
+  };
+  const followGlyphs = (on) => {
+    if (!on) {
+      if (glyphObserver) {
+        glyphObserver.disconnect();
+        glyphObserver = null;
+      }
+      if (glyphResize) {
+        glyphResize.disconnect();
+        glyphResize = null;
+      }
+      return;
+    }
+    const MO = win?.MutationObserver;
+    if (!glyphObserver && MO) {
+      glyphObserver = new MO((records) => {
+        if (!glyphQueued && records.some(movesAMark)) queueGlyphs(false);
+      });
+      glyphObserver.observe(container, {
+        subtree: true,
+        attributes: true,
+        attributeFilter: [
+          "transform",
+          "d",
+          "x",
+          "y",
+          "cx",
+          "cy",
+          "points",
+          "width",
+          "height",
+          "visibility",
+          "opacity",
+          "style",
+          "class"
+        ]
+      });
+    }
+    const RO = win?.ResizeObserver;
+    if (!glyphResize && RO) {
+      glyphResize = new RO(() => {
+        if (sizeOfContainer() !== glyphSize) queueGlyphs(true);
+      });
+      glyphResize.observe(container);
+    }
+  };
+  const markShown = (m) => {
+    try {
+      const cv = m.checkVisibility;
+      if (typeof cv === "function") return cv.call(m, { visibilityProperty: true, opacityProperty: true }) !== false;
+      const cs = win?.getComputedStyle;
+      if (typeof cs !== "function") return true;
+      const own = cs.call(win, m);
+      if (own.visibility === "hidden" || own.visibility === "collapse") return false;
+      for (let el = m; el && el !== container; el = el.parentElement) {
+        const s = el === m ? own : cs.call(win, el);
+        if (s.display === "none" || s.opacity !== "" && parseFloat(s.opacity) === 0) return false;
+      }
+    } catch {
+    }
+    return true;
+  };
+  const glyphWindows = () => {
+    const windowOf = /* @__PURE__ */ new Map();
+    const read = (el) => {
+      if (!windowOf.has(el)) {
+        let w = null;
+        try {
+          if ((el.tagName || "").toLowerCase() === "svg") {
+            const r = el.getBoundingClientRect();
+            if (r.width > 0 && r.height > 0) w = r;
+          } else if (el.hasAttribute?.("clip-path")) w = clipWindowOf(el);
+        } catch {
+          w = null;
+        }
+        windowOf.set(el, w);
+      }
+      return windowOf.get(el) ?? null;
+    };
+    const EPS2 = 0.5;
+    return (m, x, y) => {
+      for (let el = m; el && el !== container; el = el.parentElement) {
+        const w = read(el);
+        if (w && (x < w.left - EPS2 || x > w.right + EPS2 || y < w.top - EPS2 || y > w.bottom + EPS2)) return false;
+      }
+      return true;
+    };
+  };
+  const paintGlyphLayer = (report = true) => {
+    if (destroyed) return;
+    let follow = false;
+    try {
+      let layer = container.querySelector(`:scope > .${GLYPH_LAYER_CLASS}`);
+      clearSelectionGlyphs(layer);
+      const mode = resolved.selectionGlyph;
+      if (mode !== "dot" && mode !== "check") {
+        glyphReported = "";
+        return;
+      }
+      const active = !!current && current.length > 0 && !selectionIsPeriod;
+      if (!active) {
+        glyphReported = "";
+        return;
+      }
+      if (resolved.suppressSelectionGlyph) {
+        if (report === true) try {
+          config.onSelectionGlyphs?.({ mode, drawn: 0, total: 0, suppressed: true });
+        } catch {
+        }
+        glyphReported = "";
+        return;
+      }
+      follow = true;
+      if (!layer) {
+        layer = doc.createElement("div");
+        layer.className = GLYPH_LAYER_CLASS;
+        layer.setAttribute("aria-hidden", "true");
+        Object.assign(layer.style, {
+          position: "absolute",
+          left: "0",
+          top: "0",
+          width: "0",
+          height: "0",
+          overflow: "hidden",
+          pointerEvents: "none",
+          zIndex: "1"
+        });
+        try {
+          const pos = win?.getComputedStyle?.(container)?.position || container.style.position;
+          if (!pos || pos === "static") {
+            const was = container.style.position;
+            container.style.position = "relative";
+            if (glyphPositionWas === null) glyphPositionWas = was;
+          }
+        } catch {
+        }
+        container.appendChild(layer);
+      }
+      layer.style.width = "0";
+      layer.style.height = "0";
+      const sw = container.scrollWidth || 0, sh = container.scrollHeight || 0;
+      layer.style.width = `${sw}px`;
+      layer.style.height = `${sh}px`;
+      glyphSize = sizeOfContainer();
+      const centers = [];
+      collectGlyphCentersWhere(container, layer.getBoundingClientRect(), centers, { shown: markShown, at: glyphWindows() });
+      const hc = !!resolved.isHighContrast;
+      const drawn = centers.length ? paintSelectionGlyphs(layer, centers, {
+        symbol: mode === "check" ? "\u2713" : "\u25CF",
+        color: hc ? resolved.themeFg || "#111" : "#111",
+        halo: hc ? resolved.themeBg || "#fff" : "#fff"
+      }) : 0;
+      const said = `${mode}:${drawn}:${centers.length}`;
+      if (report === true || report === "if-changed" && said !== glyphReported) {
+        glyphReported = said;
+        try {
+          config.onSelectionGlyphs?.({ mode, drawn, total: centers.length, suppressed: false });
+        } catch {
+        }
+      }
+    } catch {
+    } finally {
+      try {
+        followGlyphs(follow);
+        glyphObserver?.takeRecords();
+      } catch {
+      }
+    }
+  };
   const notify = (rowIdxs, source, tick, fromChart = false) => {
     current = rowIdxs;
     selectionFromChart = rowIdxs.length > 0 && fromChart;
     activeTickEl = rowIdxs.length ? tick ?? null : null;
     selectionIsPeriod = rowIdxs.length > 0 && periodTickSuppressesFeedback(!!tick, chartOwnsTimeline(container));
     paintSelection();
+    paintGlyphLayer();
     for (const cb of subs) {
       try {
         cb(rowIdxs, source);
@@ -2313,6 +2523,20 @@ function createChartHost(container, config) {
       }
     }
   };
+  const keepScroll = config.restoreScroll !== false;
+  let chartSource;
+  const scrollKey = () => {
+    if (config.code) return config.code;
+    if (chartSource === void 0 && typeof config.renderFn === "function") {
+      try {
+        chartSource = Function.prototype.toString.call(config.renderFn);
+      } catch {
+        return config.renderFn;
+      }
+    }
+    return chartSource;
+  };
+  let hasRendered = false;
   const runPostRenderPasses = () => {
     if (zoomMemory && zoomCap) {
       try {
@@ -2400,9 +2624,11 @@ function createChartHost(container, config) {
       } catch {
       }
     }
+    const scrollMem = takeScroll(container);
     if (fitOpts !== false) {
       try {
-        const r = fitRenderedChart(container, fitOpts === true ? {} : fitOpts);
+        const base = fitOpts === true ? {} : fitOpts;
+        const r = fitRenderedChart(container, keepScroll ? { ...base, restoreScroll: { memory: scrollMem, key: scrollKey() } } : base);
         config.onFit?.(r);
       } catch {
       }
@@ -2411,6 +2637,7 @@ function createChartHost(container, config) {
       drawAnnotations();
     } catch {
     }
+    paintGlyphLayer();
     try {
       lasso = installLasso({
         container,
@@ -2437,9 +2664,12 @@ function createChartHost(container, config) {
       if (destroyed) return;
       const seq2 = ++renderSeq;
       stopAnim();
+      followGlyphs(false);
       disposeLasso();
       flushZoom();
+      if (hasRendered && keepScroll) rememberScroll(container, scrollKey());
       container.innerHTML = "";
+      hasRendered = true;
       if (!renderFn) {
         if (!config.code) throw new Error("createChartHost: provide code or renderFn");
         renderFn = compileRenderFn(config.code, win, doc, chartD3);
@@ -2461,6 +2691,8 @@ function createChartHost(container, config) {
       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.dateCellsAreUtcDays === void 0 && data.dateCellsAreUtcDays) resolved = { ...resolved, dateCellsAreUtcDays: true };
+      if (resolved.suppressSelectionGlyph === void 0 && data.meta?.suppressSelectionGlyph === true)
+        resolved = { ...resolved, suppressSelectionGlyph: true };
       let outcome;
       zoomCap = null;
       if (zoomMemory && config.code && !config.renderFn) {
@@ -2604,9 +2836,18 @@ function createChartHost(container, config) {
         dimVarSet = false;
       }
       annotationLayer.destroy();
+      if (hasRendered && keepScroll) rememberScroll(container, scrollKey());
       unpinScrolledAxis(container);
       flushZoom();
+      followGlyphs(false);
       container.innerHTML = "";
+      if (glyphPositionWas !== null) {
+        try {
+          if (container.style.position === "relative") container.style.position = glyphPositionWas;
+        } catch {
+        }
+        glyphPositionWas = null;
+      }
     }
   };
   return host;

package/dist/{chunk-QHIPRAZK.mjs → chunk-NNLBFIWU.mjs}

@@ -1,7 +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 {
+  CONTAINER_SLOT_SCROLL,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-YDHXOIAI.mjs";
+} from "./chunk-45VILLJT.mjs";
 
 // src/fit.ts
 var SCROLL_SLACK_PX = 8;
@@ -104,6 +105,15 @@ function axisPinPlacement(band, scrollTop, viewportH) {
   if (band.bottom > scrollTop + viewportH) return "bottom";
   return null;
 }
+var nonNegative = (n) => typeof n === "number" && isFinite(n) && n > 0 ? n : 0;
+function planScrollRestore(saved, key, m) {
+  if (!saved || key === void 0 || key === null || saved.key !== key) return { x: 0, y: 0 };
+  const room = (content, view) => Math.max(0, nonNegative(content) - nonNegative(view));
+  return {
+    x: m.overflowX === "auto" ? Math.min(nonNegative(saved.x), room(m.scrollWidth, m.clientWidth)) : 0,
+    y: m.overflowY === "auto" ? Math.min(nonNegative(saved.y), room(m.scrollHeight, m.clientHeight)) : 0
+  };
+}
 
 // src/fitDom.ts
 var FIT_WALK_CAP = 8e3;
@@ -256,6 +266,28 @@ function unpinScrolledAxis(container) {
   } catch {
   }
 }
+function rememberScroll(container, key) {
+  if (!container) return;
+  try {
+    const slot = container;
+    if (slot[CONTAINER_SLOT_SCROLL]) return;
+    if (container.querySelector(".llm-mm-scroll")) return;
+    const x = container.scrollLeft, y = container.scrollTop;
+    if (x > 0 || y > 0) slot[CONTAINER_SLOT_SCROLL] = { key, x, y };
+  } catch {
+  }
+}
+function takeScroll(container) {
+  if (!container) return null;
+  try {
+    const slot = container;
+    const m = slot[CONTAINER_SLOT_SCROLL] ?? null;
+    delete slot[CONTAINER_SLOT_SCROLL];
+    return m;
+  } catch {
+    return null;
+  }
+}
 function textHidden(t, view) {
   if (t.getAttribute("display") === "none" || t.getAttribute("visibility") === "hidden") return true;
   try {
@@ -476,7 +508,8 @@ function fitRenderedChart(container, opts = {}) {
     overflowX: "hidden",
     overflowY: "hidden",
     reading: null,
-    axisPin: noPin("no-container")
+    axisPin: noPin("no-container"),
+    scrolledTo: null
   };
   if (!container) return result;
   try {
@@ -537,6 +570,19 @@ function fitRenderedChart(container, opts = {}) {
     if (opts.applyOverflow !== false) {
       container.style.overflowX = fit.overflowX;
       container.style.overflowY = fit.overflowY;
+      if (opts.restoreScroll) {
+        const to = planScrollRestore(opts.restoreScroll.memory, opts.restoreScroll.key, {
+          scrollWidth: container.scrollWidth,
+          scrollHeight: container.scrollHeight,
+          clientWidth: container.clientWidth,
+          clientHeight: container.clientHeight,
+          overflowX: fit.overflowX,
+          overflowY: fit.overflowY
+        });
+        if (container.scrollLeft !== to.x) container.scrollLeft = to.x;
+        if (container.scrollTop !== to.y) container.scrollTop = to.y;
+        result.scrolledTo = to;
+      }
       if (fit.overflowY !== "auto") {
         unpinScrolledAxis(container);
         result.axisPin = noPin("not-scrolling");
@@ -571,12 +617,15 @@ export {
   labelBand,
   planAxisPin,
   axisPinPlacement,
+  planScrollRestore,
   ctmScaleOf,
   svgInkReach,
   clipWindowOf,
   measureContainerBoxes,
   fitReadingFor,
   unpinScrolledAxis,
+  rememberScroll,
+  takeScroll,
   pinScrolledAxis,
   fitRenderedChart
 };

package/dist/{chunk-XNS34AMM.mjs → chunk-PDVEIW42.mjs}

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

package/dist/{chunk-IZXVV74H.mjs → chunk-QHMLMF4L.mjs}

@@ -4,7 +4,7 @@ import {
   gestureWasDrag,
   isInsideControl,
   rowIdxsFromMark
-} from "./chunk-IUXNCX7D.mjs";
+} from "./chunk-VEVBXK44.mjs";
 import {
   AXIS_FILTER_CLASS,
   CONTROL_CLASS,
@@ -12,7 +12,7 @@ import {
   MARK_CLASS,
   ROW_IDX_ATTR,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-YDHXOIAI.mjs";
+} from "./chunk-45VILLJT.mjs";
 
 // src/lasso.ts
 var LASSO_ROW_CAP = 5e3;

package/dist/{chunk-UBB5LNH4.mjs → chunk-VC3Z5CH7.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-YDHXOIAI.mjs";
+} from "./chunk-45VILLJT.mjs";
 
 // src/snapshot.ts
 var DEFAULT_TIMEOUT_MS = 2e3;

package/dist/{chunk-IUXNCX7D.mjs → chunk-VEVBXK44.mjs}

@@ -8,7 +8,7 @@ import {
   SELECTION_RULE_ATTR,
   SELECTION_RULE_CLICKED_MARKS,
   XFILTER_REFRESH_EVENT
-} from "./chunk-YDHXOIAI.mjs";
+} from "./chunk-45VILLJT.mjs";
 
 // src/selection.ts
 function rowIdxsFromMark(el) {
@@ -304,8 +304,12 @@ function createMarkResolver(env) {
   return { isInvisibleStrokePath, distToPathCenterline, refineHitCorridor, findMark, rowIdxsFromMark, penetrateOverlayAt, resolveByGeometry };
 }
 function collectD3GlyphCenters(container, baseRect, out) {
+  collectGlyphCentersWhere(container, baseRect, out);
+}
+function collectGlyphCentersWhere(container, baseRect, out, filter) {
   const Point = container.ownerDocument?.defaultView?.DOMPoint ?? globalThis.DOMPoint;
-  const marks = container.querySelectorAll(`.${MARK_CLASS}.${MARK_SELECTED_CLASS}`);
+  let marks = container.querySelectorAll(`.${MARK_CLASS}.${MARK_SELECTED_CLASS}`);
+  if (filter?.shown) marks = Array.from(marks).filter((m) => filter.shown(m));
   const rects = [];
   for (let i = 0; i < marks.length; i++) {
     const r = marks[i].getBoundingClientRect();
@@ -385,6 +389,7 @@ function collectD3GlyphCenters(container, baseRect, out) {
       sx = isRect ? r.left + r.width * 0.8 : r.left + r.width / 2;
       sy = isRect ? r.top + r.height * 0.2 : r.top + r.height / 2;
     }
+    if (filter?.at && !filter.at(el, sx, sy)) continue;
     out.push({ x: sx - baseRect.left, y: sy - baseRect.top });
   }
 }
@@ -439,6 +444,7 @@ export {
   clickWasDrag,
   createMarkResolver,
   collectD3GlyphCenters,
+  collectGlyphCentersWhere,
   SELECTION_GLYPH_CLASS,
   clearSelectionGlyphs,
   paintSelectionGlyphs

package/dist/index.mjs

@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-UBB5LNH4.mjs";
+} from "./chunk-VC3Z5CH7.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -97,7 +97,7 @@ import {
   toRGBA,
   toSourceRows,
   valuePlacementFlag
-} from "./chunk-HXH6NIRV.mjs";
+} from "./chunk-FHHT7DBM.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -122,13 +122,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-IZXVV74H.mjs";
+} from "./chunk-QHMLMF4L.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-XNS34AMM.mjs";
+} from "./chunk-PDVEIW42.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -153,7 +153,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-IUXNCX7D.mjs";
+} from "./chunk-VEVBXK44.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -176,10 +176,13 @@ import {
   pinScrolledAxis,
   planAxisPin,
   planFrameGrow,
+  planScrollRestore,
+  rememberScroll,
   scrollFitFor,
   svgInkReach,
+  takeScroll,
   unpinScrolledAxis
-} from "./chunk-QHIPRAZK.mjs";
+} from "./chunk-NNLBFIWU.mjs";
 import {
   _3,
   l,
@@ -205,6 +208,7 @@ import {
   CONTAINER_SLOT_ANIM_STOP,
   CONTAINER_SLOT_CLICKED_MARKS,
   CONTAINER_SLOT_INITIAL_XF_MARK,
+  CONTAINER_SLOT_SCROLL,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
   CONTROL_CLASS,
@@ -237,7 +241,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-YDHXOIAI.mjs";
+} from "./chunk-45VILLJT.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/optionsVocabulary.ts
@@ -2154,6 +2158,7 @@ export {
   CONTAINER_SLOT_CLICKED_MARKS,
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_PRESS_AT,
+  CONTAINER_SLOT_SCROLL,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
   CONTROL_CLASS,
@@ -2393,6 +2398,7 @@ export {
   pinScrolledAxis,
   planAxisPin,
   planFrameGrow,
+  planScrollRestore,
   planSelectionPaint,
   planTrivialChart,
   pointInShape,
@@ -2429,6 +2435,7 @@ export {
   registerGeoAsset,
   registerLassoAction,
   relativeLuminance,
+  rememberScroll,
   requiredD3Plugins,
   resolveAutoColorScale,
   resolveOptions,
@@ -2455,6 +2462,7 @@ export {
   svgToDataUrl,
   syncMemberSelection,
   tableHostOf,
+  takeScroll,
   toRGBA,
   toSourceRows,
   trackPress,

package/dist/legend-fit.mjs

@@ -2,13 +2,13 @@
 import {
   chartSvgOf,
   tableHostOf
-} from "./chunk-UBB5LNH4.mjs";
+} from "./chunk-VC3Z5CH7.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-QHIPRAZK.mjs";
-import "./chunk-YDHXOIAI.mjs";
+} from "./chunk-NNLBFIWU.mjs";
+import "./chunk-45VILLJT.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/legendFit/legendReconcile.ts

package/dist/page.mjs

@@ -14,10 +14,10 @@ import {
   readControls,
   viewFromToken,
   viewToken
-} from "./chunk-56IZWXW2.mjs";
-import "./chunk-IZXVV74H.mjs";
-import "./chunk-IUXNCX7D.mjs";
-import "./chunk-YDHXOIAI.mjs";
+} from "./chunk-CR7DSJVG.mjs";
+import "./chunk-QHMLMF4L.mjs";
+import "./chunk-VEVBXK44.mjs";
+import "./chunk-45VILLJT.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   LINKED_HOVER_CLASS,

package/dist/react.mjs

@@ -13,7 +13,7 @@ import {
   payloadRowReader,
   viewFromToken,
   viewToken
-} from "./chunk-56IZWXW2.mjs";
+} from "./chunk-CR7DSJVG.mjs";
 import {
   assembleD3,
   createChartGroup,
@@ -22,14 +22,14 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-HXH6NIRV.mjs";
-import "./chunk-IZXVV74H.mjs";
-import "./chunk-XNS34AMM.mjs";
-import "./chunk-IUXNCX7D.mjs";
-import "./chunk-QHIPRAZK.mjs";
+} from "./chunk-FHHT7DBM.mjs";
+import "./chunk-QHMLMF4L.mjs";
+import "./chunk-PDVEIW42.mjs";
+import "./chunk-VEVBXK44.mjs";
+import "./chunk-NNLBFIWU.mjs";
 import "./chunk-KQN5C7SZ.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-YDHXOIAI.mjs";
+import "./chunk-45VILLJT.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx
@@ -69,7 +69,9 @@ function BicChart(props) {
     viewState,
     zoomMemory,
     labelContrast,
+    restoreScroll,
     onLabelContrast,
+    onSelectionGlyphs,
     layoutPass,
     onInvalidSentinel,
     id,
@@ -116,6 +118,8 @@ function BicChart(props) {
   onSelectRef.current = onSelect;
   const onLabelContrastRef = useRef(onLabelContrast);
   onLabelContrastRef.current = onLabelContrast;
+  const onSelectionGlyphsRef = useRef(onSelectionGlyphs);
+  onSelectionGlyphsRef.current = onSelectionGlyphs;
   const onInvalidSentinelRef = useRef(onInvalidSentinel);
   onInvalidSentinelRef.current = onInvalidSentinel;
   const onAnnotationClickRef = useRef(onAnnotationClick);
@@ -154,7 +158,9 @@ function BicChart(props) {
       zoomMemory,
       labelContrast,
       layoutPass,
+      restoreScroll,
       onLabelContrast: (r) => onLabelContrastRef.current?.(r),
+      onSelectionGlyphs: (r) => onSelectionGlyphsRef.current?.(r),
       // A GETTER, not a wrapper: the host decides whether to
       // swallow the sentinel throw by whether this is SET, so
       // an always-present wrapper would hide the throw from a
@@ -185,7 +191,7 @@ function BicChart(props) {
       host.destroy();
       hostRef.current = null;
     };
-  }, [code, renderFn, d3, geoKind, labelContrast, layoutPass, controls]);
+  }, [code, renderFn, d3, geoKind, labelContrast, layoutPass, restoreScroll, controls]);
   useLayoutEffect(() => {
     const host = hostRef.current;
     if (!host || !selects) return;
@@ -211,7 +217,7 @@ function BicChart(props) {
       b.detach();
       if (bindingRef.current === b) bindingRef.current = null;
     };
-  }, [selects, code, renderFn, d3, geoKind, labelContrast, layoutPass]);
+  }, [selects, code, renderFn, d3, geoKind, labelContrast, layoutPass, restoreScroll]);
   useEffect(() => {
     if (!hostRef.current || !options) return;
     if (builtWithRef.current?.optKey === optKey) return;

package/dist/testing.mjs

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

package/dist/types/contract.d.ts

@@ -35,6 +35,7 @@ export declare const CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
 export declare const CONTAINER_SLOT_XF_CLEAR = "__llmXfClear";
 export declare const CONTAINER_SLOT_INITIAL_XF_MARK = "__llmInitialXfMark";
 export declare const CONTAINER_SLOT_UI_STATE = "__lchUiState";
+export declare const CONTAINER_SLOT_SCROLL = "__lchScroll";
 export declare const CONTAINER_SLOT_CLICKED_MARKS = "__lchClickedMarks";
 export declare const VIEW_ONLY_UI_STATE_KEYS: readonly string[];
 /** The bag with every view-only key removed: what a host persists when the reader has not asked
@@ -163,6 +164,10 @@ export interface RenderOptions {
     /** How far a selection dims the marks outside it, as a share of full opacity (DIM_OPACITY_MIN-1). Absent: the
      *  stylesheet decides - DIM_OPACITY_DEFAULT, or whatever the page sets on --lch-dim-opacity. */
     dimOpacity?: number;
+    /** A small glyph on each selected mark: "dot" or "check". Absent or "none": no glyph (the default). */
+    selectionGlyph?: "none" | "dot" | "check";
+    /** A host FACT from the generate answer: this chart's family never takes a selection glyph. */
+    suppressSelectionGlyph?: boolean;
     animAutoPlay?: boolean;
     animPlaySpeedMs?: number;
     animLoopDelaySec?: number;

package/dist/types/fit.d.ts

@@ -90,3 +90,26 @@ export type AxisPinEdge = "top" | "bottom";
  * one drawn over it.
  */
 export declare function axisPinPlacement(band: AxisBand, scrollTop: number, viewportH: number): AxisPinEdge | null;
+/** A reader's scroll offsets and the identity of the chart they were made on. */
+export interface ScrollMemory {
+    key: unknown;
+    x: number;
+    y: number;
+}
+/** What the container reports once the overflow is decided. */
+export interface ScrollMetrics {
+    scrollWidth: number;
+    scrollHeight: number;
+    clientWidth: number;
+    clientHeight: number;
+    overflowX: string;
+    overflowY: string;
+}
+/**
+ * Where the scroll goes after a redraw. The saved offsets when the SAME chart is back, clamped to what the new layout can scroll and
+ * applied per axis only where the container scrolls; otherwise the origin. A new chart opens at the top.
+ */
+export declare function planScrollRestore(saved: ScrollMemory | null | undefined, key: unknown, m: ScrollMetrics): {
+    x: number;
+    y: number;
+};

package/dist/types/fitDom.d.ts

@@ -1,4 +1,4 @@
-import type { ContentExtent, MeasuredBox, AxisPinEdge } from "./fit";
+import type { ContentExtent, MeasuredBox, AxisPinEdge, ScrollMemory } from "./fit";
 export declare function ctmScaleOf(m: {
     a: number;
     b: number;
@@ -59,6 +59,16 @@ export interface FitRenderedChartOptions {
      * Set false for a host that draws its own sticky header.
      */
     pinAxis?: boolean;
+    /**
+     * Put the reader's scroll back once the overflow is decided: `memory` (what `takeScroll` handed
+     * back) is restored only when its key is `key`, the chart now drawn, clamped to what the new
+     * layout can scroll and only on an axis that scrolls. Applied before the axis pin, which places
+     * its copy from the scroll it finds. Absent, the container is left where the render put it.
+     */
+    restoreScroll?: {
+        memory: ScrollMemory | null;
+        key: unknown;
+    };
 }
 export interface FitRenderedChartResult {
     /** The frame was grown, so content that was being clipped is now painted. */
@@ -73,6 +83,11 @@ export interface FitRenderedChartResult {
     reading: FitReading | null;
     /** The axis pin: what was pinned when the container scrolls, or why nothing was. */
     axisPin: AxisPinReport;
+    /** Where `restoreScroll` put the container ({0,0} for a different chart), or null when it was not asked or the overflow was not applied. */
+    scrolledTo: {
+        x: number;
+        y: number;
+    } | null;
 }
 export interface AxisPinReport {
     pinned: boolean;
@@ -94,5 +109,13 @@ export interface AxisPinReport {
  *  when there is none. Hosts that clear the container themselves still need this for the
  *  listener, which outlives the overlay. */
 export declare function unpinScrolledAxis(container: HTMLElement | null | undefined): void;
+/**
+ * Remember where the container is scrolled, BEFORE the container is cleared. A memory already waiting is kept: a second render that
+ * starts before the first one restored sees an emptied (unscrolled) container, and must not overwrite what the reader really did.
+ * A diagram that scrolls inside itself remembers its own position, so it is left alone.
+ */
+export declare function rememberScroll(container: HTMLElement | null | undefined, key: unknown): void;
+/** The waiting memory, removed. The one place it is consumed, so a stale memory can never outlive a render. */
+export declare function takeScroll(container: HTMLElement | null | undefined): ScrollMemory | null;
 export declare function pinScrolledAxis(container: HTMLElement | null | undefined, svg: SVGSVGElement | null | undefined): AxisPinReport;
 export declare function fitRenderedChart(container: HTMLElement | null | undefined, opts?: FitRenderedChartOptions): FitRenderedChartResult;

package/dist/types/host.d.ts

@@ -62,6 +62,9 @@ export interface ChartHostConfig {
         meta?: {
             hostContract?: string;
             chart?: string;
+            /** The generate answer's fact that this chart's family never takes a selection glyph. Promoted into
+             *  options.suppressSelectionGlyph, so a host that hands over the whole payload honors it unasked. */
+            suppressSelectionGlyph?: boolean;
         };
     };
     /** Generated render() source — compiled exactly like the visual/preview/exec-gate. */
@@ -178,6 +181,15 @@ export interface ChartHostConfig {
      * reading without touching the chart (`grow: false`, `applyOverflow: false`).
      */
     fit?: boolean | FitRenderedChartOptions;
+    /**
+     * KEEP THE READER'S SCROLL when the SAME chart is drawn again - a resize, a filter, a theme
+     * switch, or a new host on the same element. Default true: the offset is parked on the
+     * container before each clear and put back by the fit, clamped to what the new layout can
+     * scroll; a different chart (other code, or a renderFn with other source) opens at the top. Pass `false`
+     * for a page that manages the container's scrolling itself: nothing is remembered or restored,
+     * and a memory an earlier host left on the element is discarded at the next render.
+     */
+    restoreScroll?: boolean;
     /** The fit result after each render - what was grown, and how the chart measured. */
     onFit?: (result: FitRenderedChartResult) => void;
     /**
@@ -199,6 +211,18 @@ export interface ChartHostConfig {
     labelContrast?: boolean | LabelContrastOptions;
     /** What the label-contrast pass did after each render - counts, so a host can log them. */
     onLabelContrast?: (report: LabelContrastReport) => void;
+    /**
+     * What the selection-glyph pass did after each paint of an active selection - counts, so a host can log them.
+     * Called only when options.selectionGlyph is "dot" or "check"; `suppressed` is true when the chart's family never
+     * takes a glyph (options.suppressSelectionGlyph, or the same fact in data.meta). A repaint that only follows marks
+     * moving without a render (a pan, a transition) is not reported again.
+     */
+    onSelectionGlyphs?: (report: {
+        mode: "dot" | "check";
+        drawn: number;
+        total: number;
+        suppressed: boolean;
+    }) => void;
     /**
      * A LAYOUT PASS the host brings, run after every render (both the synchronous and the promise lane, and every
      * setOptions / setData re-render) AFTER the label-contrast pass and BEFORE the hit-target heal, the selection

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, SELECTION_RULE_ATTR, SELECTION_RULE_CLICKED_MARKS, MARK_KEY_ATTR, CONTAINER_SLOT_CLICKED_MARKS, SNAPSHOT_SVG_ATTR, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, 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 { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, CONTROL_CLASS, NO_ROW_MARKS_ATTR, SELECTION_RULE_ATTR, SELECTION_RULE_CLICKED_MARKS, MARK_KEY_ATTR, CONTAINER_SLOT_CLICKED_MARKS, SNAPSHOT_SVG_ATTR, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, 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 { 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";
 export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";
@@ -42,6 +42,8 @@ export { SCROLL_SLACK_PX, MAX_FRAME_GROW_FACTOR, PHANTOM_FRACTION, FIT_CONTENT_S
 export { fitRenderedChart, fitReadingFor, measureContainerBoxes, svgInkReach, ctmScaleOf, type FitReading, type InkReach, type FitRenderedChartOptions, type FitRenderedChartResult, } from "./fitDom";
 export { AXIS_PIN_MIN_LABELS, AXIS_PIN_BAND_PAD_PX, AXIS_PIN_MAX_BAND_FRACTION, AXIS_PIN_TRACK_REACH_PX, isHorizontalLabelRow, labelBand, planAxisPin, axisPinPlacement, type LabelRowBox, type AxisBand, type AxisPinCandidate, type AxisPinPlan, type AxisPinEdge, } from "./fit";
 export { pinScrolledAxis, unpinScrolledAxis, type AxisPinReport } from "./fitDom";
+export { planScrollRestore, type ScrollMemory, type ScrollMetrics } from "./fit";
+export { rememberScroll, takeScroll } from "./fitDom";
 export { MIN_DELTA_E, pickDistinctColorFromSeed, buildPalette, buildPaletteFromSeed, orderMostDistinct, LEGIBLE_LIGHTNESS, type PaletteResult, type SeedForSlot, type PaletteOptions, } from "./palette";
 export { deltaEHex } from "./deltaE";
 export { resolveAutoColorScale, autoRampMinStep, autoRampCanvas, AUTO_RAMP_CLASSES, AUTO_RAMP_DRAWN_OPACITY, AUTO_RAMP_MIN_STEP_DELTA_E, type AutoColorScale, type AutoColorScaleInput } from "./autoRamp";

package/dist/types/react.d.ts

@@ -46,8 +46,17 @@ export interface BicChartProps {
      * themed page is not white, and readability is measured against it. See createChartHost.
      */
     labelContrast?: ChartHostConfig["labelContrast"];
+    /**
+     * KEEP THE READER'S SCROLL when the same chart repaints (new data, new options, a rebuild).
+     * Default on; a different chart opens at the top. Pass `false` for a page that manages the
+     * chart's scrolling itself. Host config: changing it rebuilds the host. See createChartHost.
+     */
+    restoreScroll?: ChartHostConfig["restoreScroll"];
     /** What the label-contrast pass did after each render - counts, for a page that logs. */
     onLabelContrast?: ChartHostConfig["onLabelContrast"];
+    /** What the selection-glyph pass did after each paint, when `options.selectionGlyph` is set - counts, for a page
+     *  that logs. The glyph itself, the dim level and the suppression fact ride the `options` prop. */
+    onSelectionGlyphs?: ChartHostConfig["onSelectionGlyphs"];
     /**
      * A LAYOUT PASS run after every render, after label contrast and before the fit - e.g.
      * `createLegendFitPass()` from "@bicharts/chart-host/legend-fit", which slides a legend clear of

package/dist/types/selection.d.ts

@@ -169,6 +169,18 @@ export declare function collectD3GlyphCenters(container: Element, baseRect: {
     left: number;
     top: number;
 }, out: GlyphCenter[]): void;
+/** Which selected marks get a glyph, for a host that draws its own layer: `shown` drops a mark before anything is
+ *  measured against it (a mark the reader can't see), `at` drops one by where its glyph would go, in client
+ *  coordinates (a mark panned or zoomed out of its plot). Either absent keeps every mark. */
+export interface GlyphCenterFilter {
+    shown?(mark: Element): boolean;
+    at?(mark: Element, clientX: number, clientY: number): boolean;
+}
+/** collectD3GlyphCenters with a filter. Package-internal: the exported function keeps every mark, as it always has. */
+export declare function collectGlyphCentersWhere(container: Element, baseRect: {
+    left: number;
+    top: number;
+}, out: GlyphCenter[], filter?: GlyphCenterFilter): void;
 /** The class every painted selection glyph carries. */
 export declare const SELECTION_GLYPH_CLASS = "lch-sel-glyph";
 /** Removes every glyph (every child) from the overlay. */

package/package.json

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