@bicharts/chart-host 0.6.112 → 0.6.115

package/dist/index.mjs

@@ -5,7 +5,7 @@ import {
   formatSourceDateFor,
   isExcelDateFormat,
   normaliseAggregation
-} from "./chunk-OLCUKXKL.mjs";
+} from "./chunk-YSRMSDRP.mjs";
 import {
   captureSvgSnapshot,
   chartSvgOf,
@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-PELRAFYZ.mjs";
+} from "./chunk-QLIRQJ6B.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -35,15 +35,21 @@ import {
   LABEL_CONTRAST_DONE_ATTR,
   LABEL_PILL_CLASS,
   LIGHT_TEXT,
+  MAP_SELECTION_MARKER_DEFAULT,
+  MARK_MOVE_ATTRIBUTES,
   MIN_CONTRAST,
   MIN_RAMP_FILLS,
+  NEUTRAL_CENTRE_RAMP_SELECTOR,
   PAGE_MATCH_TOLERANCE,
   PILL_MIN_ALPHA,
   PILL_MIN_COVERAGE,
   PILL_OPAQUE_ALPHA,
+  REGION_JOIN_COLUMN,
   ROW_GROWTH_MIN_EXTRA,
   ROW_GROWTH_MIN_RATIO,
   SAME_SHADE_DELTA_E,
+  SELECTION_MARKER_DEFAULT,
+  SELECTION_OUTLINE_CLASS,
   STRADDLE_COLS,
   STRADDLE_MIN_SHARE,
   STRADDLE_PILL_ALPHA,
@@ -72,10 +78,12 @@ import {
   cleanHostSelection,
   clippedTextFlag,
   codeHasKeyboardStamp,
+  collectOutlineMarks,
   colourSpreadFlag,
   compileRenderFn,
   compositeOver,
   contrastRatio,
+  controlBoxesIn,
   createChartGroup,
   createChartHost,
   decideLabelColor,
@@ -86,17 +94,25 @@ import {
   exportFileName,
   exportFormatsFor,
   exportTableService,
+  followMarks,
   glyphSampleGrid,
+  hasNeutralCentreRamp,
   installKeyboard,
   invalidSentinelReason,
+  isAreaMark,
   isBlankRender,
   isInvalidSentinelError,
   isPillBackdropAlpha,
+  isRegionMapData,
   minContrastOver,
   newIdScope,
   noopViewStateProvider,
+  outlineWindowOf,
+  paintSelectionOutlines,
   pickColorOver,
   pillBacksGlyph,
+  readMapSelectionMarker,
+  readSelectionMarker,
   relativeLuminance,
   rememberFocus,
   requiredD3Plugins,
@@ -106,6 +122,7 @@ import {
   rowGrowthNotice,
   rowNameOf,
   scopeChartIds,
+  selectionMarkerFor,
   sessionViewStateProvider,
   sheetName,
   straddleSampleGrid,
@@ -119,7 +136,7 @@ import {
   toSourceRows,
   trackFocus,
   valuePlacementFlag
-} from "./chunk-TE54AFRN.mjs";
+} from "./chunk-7K3F3RZ6.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -146,13 +163,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-IL5M7K6Z.mjs";
+} from "./chunk-CVTCR7HQ.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-AEO5SFEQ.mjs";
+} from "./chunk-YOCYWON4.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -177,7 +194,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-KGVNZR23.mjs";
+} from "./chunk-PQKLWYKK.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -206,7 +223,7 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-7XT5OJ6M.mjs";
+} from "./chunk-AQO4ROMU.mjs";
 import {
   clearGeoCache,
   geoAssetFor,
@@ -219,7 +236,7 @@ import {
   Ot,
   l,
   o
-} from "./chunk-FIG5DIW7.mjs";
+} from "./chunk-VPFP35XI.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -276,7 +293,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-KY4FI2HA.mjs";
+} from "./chunk-GXR7T6G5.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/hostLinks.ts
@@ -2411,9 +2428,11 @@ export {
   LIGHT_TEXT,
   LIMIT_COUNT_MAX,
   LIVE_OPTION_KEYS,
+  MAP_SELECTION_MARKER_DEFAULT,
   MARKS_INERT_CLASS,
   MARK_CLASS,
   MARK_KEY_ATTR,
+  MARK_MOVE_ATTRIBUTES,
   MARK_SELECTED_CLASS,
   MAX_FRAME_GROW_FACTOR,
   MAX_MAP_POINTS_DEFAULT,
@@ -2423,6 +2442,7 @@ export {
   MIN_DELTA_E,
   MIN_HIT_BAND_PX,
   MIN_RAMP_FILLS,
+  NEUTRAL_CENTRE_RAMP_SELECTOR,
   NOTE_STYLE_ATTR,
   NO_ROW_MARKS_ATTR,
   OPTIONS_VOCABULARY,
@@ -2445,6 +2465,7 @@ export {
   QUALIFY_TILE_REFUSAL_CODES,
   QUALIFY_TOO_SMALL_HEADING,
   RECOVERY_UNREACHABLE_MESSAGE,
+  REGION_JOIN_COLUMN,
   ROW_GROWTH_MIN_EXTRA,
   ROW_GROWTH_MIN_RATIO,
   ROW_IDX_ATTR,
@@ -2454,6 +2475,8 @@ export {
   SEASONAL_MARKERS_DEFAULT,
   SELECTION_ACTIVE_CLASS,
   SELECTION_GLYPH_CLASS,
+  SELECTION_MARKER_DEFAULT,
+  SELECTION_OUTLINE_CLASS,
   SELECTION_RULE_ATTR,
   SELECTION_RULE_CLICKED_MARKS,
   SNAPSHOT_SVG_ATTR,
@@ -2512,6 +2535,7 @@ export {
   codeReadsDatesInLocalTime,
   codeReadsOption,
   collectD3GlyphCenters,
+  collectOutlineMarks,
   colourSpreadFlag,
   compileRenderFn,
   compileTrivialSource,
@@ -2522,6 +2546,7 @@ export {
   confirmLaunch,
   contentExtentOf,
   contrastRatio,
+  controlBoxesIn,
   createChartGroup,
   createChartHost,
   createMarkResolver,
@@ -2546,6 +2571,7 @@ export {
   fingerprintComponentDigest,
   fitReadingFor,
   fitRenderedChart,
+  followMarks,
   formatSourceDate,
   formatSourceDateFor,
   generationCancelledMessage,
@@ -2553,6 +2579,7 @@ export {
   geoFromCache,
   gestureWasDrag,
   glyphSampleGrid,
+  hasNeutralCentreRamp,
   hasRefusalsToShow,
   hitBandFlag,
   hostLinkServices,
@@ -2562,6 +2589,7 @@ export {
   installKeyboard,
   installLasso,
   invalidSentinelReason,
+  isAreaMark,
   isBlankRender,
   isBlindMarker,
   isDuplicateGenerate,
@@ -2574,6 +2602,7 @@ export {
   isPhantomBox,
   isPickableModelCode,
   isPillBackdropAlpha,
+  isRegionMapData,
   labelBand,
   lassoActions,
   lassoEffect,
@@ -2605,7 +2634,9 @@ export {
   normalizeFilterTerm,
   orderMostDistinct,
   orderRefusalsForDisplay,
+  outlineWindowOf,
   paintSelectionGlyphs,
+  paintSelectionOutlines,
   parsePendingGenerate,
   pendingRecoveryNextDelayMs,
   pendingRecoveryRemainingMs,
@@ -2634,8 +2665,10 @@ export {
   qualifyRefusalReason,
   qualifyTableRows,
   rasterizeSvgToPngDataUrl,
+  readMapSelectionMarker,
   readQualifyChartRow,
   readQualifyRefusalRow,
+  readSelectionMarker,
   reconcileChartPick,
   reconcileModelPick,
   recoveryAnswerIsCancelled,
@@ -2666,6 +2699,7 @@ export {
   sameRowSet,
   scopeChartIds,
   scrollFitFor,
+  selectionMarkerFor,
   selectionRuleOf,
   servedCorrelationProves,
   sessionViewStateProvider,

package/dist/legend-fit.mjs

@@ -2,13 +2,13 @@
 import {
   chartSvgOf,
   tableHostOf
-} from "./chunk-PELRAFYZ.mjs";
+} from "./chunk-QLIRQJ6B.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-7XT5OJ6M.mjs";
-import "./chunk-KY4FI2HA.mjs";
+} from "./chunk-AQO4ROMU.mjs";
+import "./chunk-GXR7T6G5.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/legendFit/legendReconcile.ts

package/dist/page.mjs

@@ -6,10 +6,10 @@ import {
   noteBadges,
   notesFor,
   readControls
-} from "./chunk-GTJG3SMD.mjs";
-import "./chunk-IL5M7K6Z.mjs";
-import "./chunk-KGVNZR23.mjs";
-import "./chunk-KY4FI2HA.mjs";
+} from "./chunk-DILJDN6C.mjs";
+import "./chunk-CVTCR7HQ.mjs";
+import "./chunk-PQKLWYKK.mjs";
+import "./chunk-GXR7T6G5.mjs";
 import {
   ANY_VALUE,
   LINKED_HOVER_CLASS,
@@ -20,9 +20,10 @@ import {
   fromVegaInteraction,
   isAnyValue,
   payloadRowReader,
+  scopeFilterOf,
   viewFromToken,
   viewToken
-} from "./chunk-2KLFIGTQ.mjs";
+} from "./chunk-2GW3S5VD.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   ANY_VALUE,
@@ -40,6 +41,7 @@ export {
   notesFor,
   payloadRowReader,
   readControls,
+  scopeFilterOf,
   viewFromToken,
   viewToken
 };

package/dist/provinces.mjs

@@ -8,7 +8,7 @@ import {
   Rt,
   W,
   bt
-} from "./chunk-FIG5DIW7.mjs";
+} from "./chunk-VPFP35XI.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/react.mjs

@@ -5,25 +5,25 @@ import {
   createControls,
   noteBadges,
   notesFor
-} from "./chunk-GTJG3SMD.mjs";
+} from "./chunk-DILJDN6C.mjs";
 import {
   assembleD3,
   createChartGroup,
   createChartHost,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-TE54AFRN.mjs";
-import "./chunk-IL5M7K6Z.mjs";
-import "./chunk-AEO5SFEQ.mjs";
-import "./chunk-KGVNZR23.mjs";
-import "./chunk-7XT5OJ6M.mjs";
+} from "./chunk-7K3F3RZ6.mjs";
+import "./chunk-CVTCR7HQ.mjs";
+import "./chunk-YOCYWON4.mjs";
+import "./chunk-PQKLWYKK.mjs";
+import "./chunk-AQO4ROMU.mjs";
 import {
   geoFromCache,
   loadGeo
 } from "./chunk-5YSZABCS.mjs";
-import "./chunk-FIG5DIW7.mjs";
+import "./chunk-VPFP35XI.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-KY4FI2HA.mjs";
+import "./chunk-GXR7T6G5.mjs";
 import {
   ANY_VALUE,
   LINKED_HOVER_CLASS,
@@ -34,9 +34,10 @@ import {
   fromVegaInteraction,
   isAnyValue,
   payloadRowReader,
+  scopeFilterOf,
   viewFromToken,
   viewToken
-} from "./chunk-2KLFIGTQ.mjs";
+} from "./chunk-2GW3S5VD.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx
@@ -96,7 +97,8 @@ function BicChart(props) {
     controls,
     ariaLabel
   } = props;
-  const scopeList = scopedBy == null ? [] : Array.isArray(scopedBy) ? scopedBy : [scopedBy];
+  const scopeSources = scopedBy == null ? [] : Array.isArray(scopedBy) ? scopedBy : [scopedBy];
+  const scopeList = scopeSources.map(scopeFilterOf).filter((f) => !!f);
   const scopeIds = scopeList.map((f) => f?.id).join("
");
   const subscribeScope = useCallback((cb) => {
     const offs = scopeList.map((f) => f?.onChange?.(() => cb()));
@@ -108,7 +110,7 @@ function BicChart(props) {
   useSyncExternalStore(subscribeScope, scopeSnapshot, scopeSnapshot);
   const [scopeEver, setScopeEver] = useState(scopedBy !== void 0);
   if (scopedBy !== void 0 && !scopeEver) setScopeEver(true);
-  const scopeFact = scopedBy === void 0 ? void 0 : filterScopeOf(scopeList);
+  const scopeFact = scopedBy === void 0 ? void 0 : filterScopeOf(scopeSources);
   const scopeKey = scopeFact ? JSON.stringify(scopeFact) : "";
   const options = useMemo(
     () => scopeEver ? { ...pageOptions ?? {}, filterScope: scopeFact ?? pageOptions?.filterScope } : pageOptions,
@@ -338,7 +340,8 @@ function useBicFilter(columns, opts) {
   if (!ref.current) ref.current = createFilter(columns, opts);
   const f = ref.current;
   useEffect(() => scope.add(f), [scope, f]);
-  useSyncExternalStore((cb) => f.onChange(() => cb()), () => f.version, () => f.version);
+  const snapshot = () => `${f.version}:${f.pick?.id ?? ""}:${f.pick?.version ?? ""}`;
+  useSyncExternalStore((cb) => f.onPick ? f.onPick(() => cb()) : f.onChange(() => cb()), snapshot, snapshot);
   return f;
 }
 function useBicControls(initial, opts) {

package/dist/testing.mjs

@@ -4,7 +4,7 @@ import {
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-KY4FI2HA.mjs";
+} from "./chunk-GXR7T6G5.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.23.0";
+export declare const HOST_CONTRACT_VERSION = "1.24.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[];
@@ -206,8 +206,19 @@ 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";
+    /** The SELECTION MARKER on every chart that is not a region map (the key keeps its first name, from when the only
+     *  markers were glyphs): "auto" (the default; an outline on a chart whose colour ramp has a neutral centre, nothing
+     *  elsewhere), "none", "dot" or "check" (a small glyph on each selected mark), or "outline" (a stroke in the text
+     *  colour around each selected area mark). Resolved, it reads "dot", "check" or "outline" when one of those was
+     *  chosen and undefined otherwise; `selectionMarker` holds the whole choice. */
+    selectionGlyph?: "auto" | "none" | "dot" | "check" | "outline";
+    /** The selection marker on a REGION MAP (a chart whose rows carry the host's region join column): "outline" (the
+     *  default), "none", "dot" or "check". */
+    mapSelectionGlyph?: "none" | "dot" | "check" | "outline";
+    /** Resolved only: the whole choice `selectionGlyph` made, "auto" when it made none. */
+    selectionMarker?: "auto" | "none" | "dot" | "check" | "outline";
+    /** Resolved only: the whole choice `mapSelectionGlyph` made, "outline" when it made none. */
+    mapSelectionMarker?: "none" | "dot" | "check" | "outline";
     /** 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

package/dist/types/filterScope.d.ts

@@ -23,6 +23,15 @@ export interface FilterOptions {
      * chart bound to it (a glow, never a filter). Off by default.
      */
     hover?: boolean;
+    /**
+     * ONE PICK ACROSS SEVERAL PANELS. Filters with the same group name in one scope (one page) are one pick: a map, a
+     * table and a scatter that each pick a country, each with its own filter so each panel's query can leave its own pick
+     * out. A pick in one member clears the others, so the most recent pick is the page's one pick, and only the member
+     * holding it is active: one chip, one scope line, and a side list over the members' keys names that pick alone.
+     * Every member's chart shows the pick, so clicking the picked mark again in whichever panel shows it clears it.
+     * The members share their key columns; a filter keyed differently stays out of the group (said once in the console).
+     */
+    group?: string;
 }
 export interface Filter {
     readonly id: string;
@@ -56,9 +65,11 @@ export interface Filter {
     /**
      * The display text for ANY key - a badge's, a key set by value - read from `rows` (a table carrying the display
      * columns, e.g. the chart's own rows) or else from the rows this filter has seen; the key's values when neither
-     * has it.
+     * has it. `parts` names the key columns to say (a query that maps only some of them, see ScopedFilter): a display
+     * column speaks for the key column it is, or for the key column in its place when there is one display column per
+     * key column; a wildcard part says nothing. Absent, or naming every key column: the whole key.
      */
-    textOf(key: FilterKey | unknown, rows?: readonly Record<string, unknown>[]): string;
+    textOf(key: FilterKey | unknown, rows?: readonly Record<string, unknown>[], parts?: readonly string[]): string;
     /** Why the last change happened (null before any). */
     readonly reason: FilterChangeReason | null;
     /** Bumped on every change: a cheap identity for memoising on the filter's state. */
@@ -82,6 +93,15 @@ export interface Filter {
     keep<T extends Record<string, unknown>>(rows: readonly T[], columns?: readonly string[]): T[];
     /** Subscribe to changes. Returns the unsubscribe. */
     onChange(cb: (filter: Filter, reason: FilterChangeReason) => void): () => void;
+    /** Its group's name (FilterOptions.group), or null. */
+    readonly group?: string | null;
+    /**
+     * The filter holding the pick this one shows: the group member a reader last picked in, or this filter itself when it
+     * has no group; null while nothing is picked. A chart bound to a member paints this filter's keys.
+     */
+    readonly pick?: Filter | null;
+    /** Subscribe to the pick changing: this filter's, or any member's of its group. Returns the unsubscribe. */
+    onPick?(cb: () => void): () => void;
 }
 /** A page's filters: what a chip bar lists and what clear-all clears. */
 export interface FilterScope {
@@ -130,13 +150,32 @@ export declare function isAnyValue(v: unknown): boolean;
 export declare function createFilter(columns: string | readonly string[], opts?: FilterOptions): Filter;
 /** Make a page's filter scope. */
 export declare function createFilterScope(): FilterScope;
+/**
+ * A FILTER AS ONE PANEL'S QUERY TAKES IT, for filterScopeOf and BicChart's scopedBy. A query that maps only some of a
+ * compound key's columns (treatAs(cell, "Accounts[Region]") on a Region x Stage pick) is narrowed by those parts alone,
+ * so its scope line names only them: `{ filter: cell, takes: ["Region"] }` says "Europe", never "Europe → 3-Propose".
+ */
+export interface ScopedFilter {
+    filter: Filter;
+    /** The filter's key columns this panel's query maps (by name, as the filter is keyed). Absent: the whole key. */
+    takes?: readonly string[];
+    /** What the scope line calls it. Default: the filter's label, or the taken columns while the filter has no label of its own. */
+    label?: string;
+}
+/** What filterScopeOf and scopedBy take: a filter whose whole key the query maps, or a ScopedFilter. */
+export type ScopeSource = Filter | ScopedFilter;
+/** The filter behind a scope source, or null. */
+export declare function scopeFilterOf(src: ScopeSource | null | undefined): Filter | null;
 /**
  * THE PAGE FILTERS THAT NARROWED A CHART'S ROWS, as the fact the chart is told (RenderOptions.filterScope, contract
  * 1.23.0). For filters applied to the chart's QUERY, so its rows arrive already narrowed and it can't see the filter.
  * Only the active ones count. The field is each one's label (its key columns when it has none), joined ", "; the values
  * are what its chip shows for each key, in order, each once. Nothing active, nothing to say: undefined.
+ *
+ * A ScopedFilter whose `takes` leaves key columns out says only the taken parts, as treatAs maps them: a pick whose
+ * taken parts are all wildcards keeps every row of that query, so while one is held the filter narrows nothing there.
  */
-export declare function filterScopeOf(filters: Filter | readonly Filter[] | null | undefined): FilterScopeFact | undefined;
+export declare function filterScopeOf(filters: ScopeSource | readonly ScopeSource[] | null | undefined): FilterScopeFact | undefined;
 export interface FilterBinding {
     /**
      * Call after the chart is handed new data. The selection is repainted where its keys are drawn now, and a key the new

package/dist/types/host.d.ts

@@ -9,6 +9,9 @@ export interface SelectionChangeMeta {
     /** The pick was a category label (an axis label carrying its category's rows), not a mark: a page filter selects on
      *  the label's own field (bindFilter), leaving the key columns the label doesn't name free. */
     fromLabel?: boolean;
+    /** The pick was ONE mark clicked on its own (no Ctrl/Shift, not a lasso): a page filter selects the key columns that
+     *  mark's rows share, leaving the ones they differ on free (bindFilter), so a region row over its stages picks the region. */
+    fromMark?: boolean;
 }
 export interface SelectionPaintReport {
     rule: SelectionRule;
@@ -224,13 +227,14 @@ export interface ChartHostConfig {
     /** 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.
+     * What the selection-marker pass did after each paint of an active selection - counts, so a host can log them.
+     * Called only when the chart's marker is "dot", "check" or "outline" (options.selectionGlyph, or on a region map
+     * options.mapSelectionGlyph; "auto" decided); `suppressed` is true when the chart's family never takes a marker
+     * (options.suppressSelectionGlyph, or the same fact in data.meta). For an outline, `total` counts the selected
+     * area marks. A repaint that only follows marks moving without a render (a pan, a transition) is not reported again.
      */
     onSelectionGlyphs?: (report: {
-        mode: "dot" | "check";
+        mode: "dot" | "check" | "outline";
         drawn: number;
         total: number;
         suppressed: boolean;

package/dist/types/index.d.ts

@@ -16,8 +16,10 @@ export { rememberFocus, restoreFocus, trackFocus, type FocusMemory, type FocusTr
 export type { MarkNoteLike, NoteBadgeOptions } from "./markNotes";
 export type { Controls, ControlInfo, ControlsAttachment } from "./controls";
 export { createChartGroup, toSourceRows, syncMemberSelection, type ChartGroup, type ChartGroupMember, type ChartGroupSelection, type ChartGroupChange, type ChartGroupMemberOptions, type ChartGroupSourceOptions, type ChartGroupPayload } from "./group";
-export type { Filter, FilterScope, FilterOptions, FilterKey, FilterChangeReason, FilterBinding, BindFilterOptions, VegaInteractionEvent, PageView } from "./filterScope";
+export type { Filter, FilterScope, FilterOptions, FilterKey, FilterChangeReason, FilterBinding, BindFilterOptions, VegaInteractionEvent, PageView, ScopedFilter, ScopeSource } from "./filterScope";
 export { createMarkResolver, isInsideControl, rowIdxsFromMark, nextSelection, DRAG_NOT_CLICK_PX, gestureWasDrag, trackPress, pressOf, clearPress, clickWasDrag, CONTAINER_SLOT_PRESS_AT, type PressPoint, dispatchRowSet, validRowSet, ROW_SET_MAX, selectionRuleOf, markKeyOf, planSelectionPaint, nextClickedMarks, sameRowSet, type SelectionRule, type ClickedMarks, type SelectionPaintMark, type SelectionPaintMode, type SelectionPaintPlan, collectD3GlyphCenters, clearSelectionGlyphs, paintSelectionGlyphs, SELECTION_GLYPH_CLASS, type MarkResolver, type MarkResolverEnv, type GlyphCenter, type SelectionGlyphStyle, type SelectionModifiers, } from "./selection";
+export { readSelectionMarker, readMapSelectionMarker, selectionMarkerFor, SELECTION_MARKER_DEFAULT, MAP_SELECTION_MARKER_DEFAULT, REGION_JOIN_COLUMN, isRegionMapData, NEUTRAL_CENTRE_RAMP_SELECTOR, hasNeutralCentreRamp, isAreaMark, collectOutlineMarks, outlineWindowOf, controlBoxesIn, paintSelectionOutlines, SELECTION_OUTLINE_CLASS, type SelectionMarkerChoice, type MapSelectionMarkerChoice, type SelectionMarker, type SelectionOutlineStyle, type OutlineMarkFilter, } from "./selectionMarker";
+export { followMarks, MARK_MOVE_ATTRIBUTES, type MarkFollower, type MarkFollowerOptions } from "./markFollower";
 export { installLasso, clearLasso, lassoVerdict, lassoRowCap, lassoActions, lassoEffect, registerLassoAction, pointInShape, LASSO_ROW_CAP, LASSO_DRAG_PX, LASSO_SAMPLE_PX, LASSO_MAX_VERTICES, LASSO_RESTORE_MAX_VERTICES, LASSO_RESTORE_MAX_SHAPES, LASSO_EVENT, LASSO_SURFACE_CLASS, LASSO_OUTLINE_CLASS, LASSO_COUNT_CLASS, LASSO_NOTE_CLASS, LASSO_PLOT_CLASS, LASSO_MODE_ATTR, LASSO_KNOB_KEY, LASSO_AXES_SLOT, LASSO_DEFAULT_ACTIONS, LASSO_DEFAULT_EFFECT, type LassoSetting, type LassoVerdict, type LassoEffect, type LassoMode, type LassoSpace, type LassoShape, type LassoStored, type LassoEventDetail, type LassoAxes, type LassoAction, type LassoActionContext, type LassoEnv, type LassoHandle, } from "./lasso";
 export type { AdapterEvent, AdapterHit, AdapterId, AdapterScene, MarkHandle, MarkInfo, MarkRole, PaintRequest, RendererAdapter, RowTable, } from "./adapters/types";
 export { planTrivialChart, compileTrivialSource, type TrivialPlan, type TrivialShapeKind } from "./trivial";

package/dist/types/keyboardMarks.d.ts

@@ -13,7 +13,7 @@ export interface KeyboardEnv {
     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). */
+    /** True while a click on a mark selects nothing (the marks are then read as images, with no pressed state). */
     inert(): boolean;
     /** Select a mark as a click on it would. */
     select(mark: Element, mods: {

package/dist/types/markFollower.d.ts

@@ -0,0 +1,21 @@
+export interface MarkFollowerOptions {
+    /** Elements whose own writes never count (the host's layers), as a selector. */
+    blind?: string;
+    /** The window whose observers and frames to use. Default: the container's own. */
+    win?: any;
+    /** Called on the next frame after the marks moved; `resized` is true when the container's size changed. */
+    repaint(resized: boolean): void;
+}
+export interface MarkFollower {
+    /** Start (true) or stop (false) following. Connecting twice is harmless. */
+    follow(on: boolean): void;
+    /** Note the container's size now, as painted at: a later size equal to it repaints nothing. Call at each paint. */
+    painted(): void;
+    /** Drop the writes already recorded: call after a paint, whose own writes (the selection's classes) are in it. */
+    takeRecords(): void;
+    /** Whether it is following now. */
+    readonly following: boolean;
+}
+/** The attributes whose writes can move or hide a mark. */
+export declare const MARK_MOVE_ATTRIBUTES: readonly string[];
+export declare function followMarks(container: HTMLElement, opts: MarkFollowerOptions): MarkFollower;

package/dist/types/page.d.ts

@@ -1,4 +1,4 @@
 export { viewToken, viewFromToken, LINKED_HOVER_CLASS, type PageView } from "./filterScope";
-export { createFilter, createFilterScope, bindFilter, payloadRowReader, fromVegaInteraction, filterScopeOf, ANY_VALUE, isAnyValue, type Filter, type FilterScope, type FilterOptions, type FilterKey, type FilterChangeReason, type FilterBinding, type BindFilterOptions, type VegaInteractionEvent } from "./filterScope";
+export { createFilter, createFilterScope, bindFilter, payloadRowReader, fromVegaInteraction, filterScopeOf, scopeFilterOf, ANY_VALUE, isAnyValue, type Filter, type FilterScope, type FilterOptions, type FilterKey, type FilterChangeReason, type FilterBinding, type BindFilterOptions, type VegaInteractionEvent, type ScopedFilter, type ScopeSource } from "./filterScope";
 export { createControls, attachControls, readControls, type Controls, type ControlInfo, type ControlsAttachment } from "./controls";
 export { noteBadges, badgeKey, notesFor, type MarkNoteLike, type NoteBadgeOptions } from "./markNotes";

package/dist/types/react.d.ts

@@ -2,13 +2,13 @@ import type { ReactNode, RefObject } from "react";
 import { type ChartHostConfig } from "./host";
 import type { ResolveOptionsInput } from "./defaults";
 import type { GeoPointBinding } from "./payload";
-import { type PageView, type Filter, type FilterOptions } from "./filterScope";
+import { type PageView, type Filter, type FilterOptions, type ScopeSource } from "./filterScope";
 export { assembleD3 } from "./host";
 import { type Controls } from "./controls";
 export { createControls, type Controls, type ControlInfo } from "./controls";
 export { noteBadges, badgeKey, notesFor, type MarkNoteLike, type NoteBadgeOptions } from "./markNotes";
 export { viewToken, viewFromToken, LINKED_HOVER_CLASS, type PageView } from "./filterScope";
-export { createFilter, createFilterScope, fromVegaInteraction, filterScopeOf, ANY_VALUE, isAnyValue, type Filter, type FilterOptions, type FilterScope, type FilterChangeReason } from "./filterScope";
+export { createFilter, createFilterScope, fromVegaInteraction, filterScopeOf, ANY_VALUE, isAnyValue, type Filter, type FilterOptions, type FilterScope, type FilterChangeReason, type ScopedFilter, type ScopeSource } from "./filterScope";
 export interface BicChartProps {
     /** Generated render() source (an ES module's `code` export, or the raw string). */
     code?: string;
@@ -111,8 +111,11 @@ export interface BicChartProps {
      * chip shows), and its titles and comparisons say so ("North America · United States only", "rank 2 of 3 (United
      * States only)"). Cleared again when the filters clear. Not for the filter this chart `selects` unless its own rows
      * are narrowed by it too. Absent: the page's own options.filterScope, if any, goes through untouched.
+     * A query that maps only some of a compound key's columns names them, `{ filter, takes }`: with
+     * `treatAs(cell, "Accounts[Region]")` on a Region x Stage pick, `scopedBy={{ filter: cell, takes: ["Region"] }}` says
+     * the region alone, and a stage-label pick (any region) says nothing, since that query keeps every row.
      */
-    scopedBy?: Filter | readonly Filter[];
+    scopedBy?: ScopeSource | readonly ScopeSource[];
     /**
      * THE CHART'S OWN CONTROLS AS PAGE STATE - from useBicControls(). For a chart that draws
      * sliders (the What-if projection's rate and horizon): `controls.values` holds every
@@ -183,6 +186,11 @@ export declare function BicPage({ children }: {
  * ["OriginCode", "DestinationCode"]). Pass it to a chart's `selects` and read
  * `value` / `values` / `row` / `active` for the rest of the page; `clear()` clears it and the
  * chart's marks. Re-renders the component on every change. The key columns are read once.
+ *
+ * SEVERAL PANELS PICKING ONE KEY ARE ONE PICK: give their filters one `group` ("country") and the most recent pick is
+ * the page's one pick - a pick in one clears the others, the picked mark shows in every member's chart and a click on it
+ * in any of them clears it, and only the member holding it is active (one chip, one scope line). Each panel's query
+ * still takes every member but its own, so the panel a reader picked in keeps all its marks.
  */
 export declare function useBicFilter(columns: string | readonly string[], opts?: FilterOptions): Filter;
 /**