@bicharts/chart-host 0.6.109 → 0.6.111

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

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

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

package/dist/{chunk-5WTQN5DL.mjs → chunk-S564YXNE.mjs}

@@ -59,7 +59,7 @@ async function loadGeo(geoKind) {
   } else if (asset === "us-zip3") {
     byAsset.set(asset, (await import("./geoUsZip3.generated-VSWL7D6F.mjs")).US_ZIP3);
   } else {
-    byAsset.set(asset, (await import("./geoWorld110m.generated-TD2TA7S7.mjs")).WORLD_110M);
+    byAsset.set(asset, (await import("./geoWorld110m-3PRV3V4G.mjs")).WORLD_110M);
   }
   return fromAssets(key);
 }

package/dist/geo-world.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 {
   WORLD_110M
-} from "./chunk-ABGDJ3NJ.mjs";
+} from "./chunk-3JCWTEEH.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   WORLD_110M

package/dist/geo.mjs

@@ -6,7 +6,7 @@ import {
 } from "./chunk-A2GMXZP7.mjs";
 import {
   WORLD_110M
-} from "./chunk-ABGDJ3NJ.mjs";
+} from "./chunk-3JCWTEEH.mjs";
 import {
   US_STATES
 } from "./chunk-75ZJSYIF.mjs";

package/dist/{geoWorld110m.generated-TD2TA7S7.mjs → geoWorld110m-3PRV3V4G.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 {
   WORLD_110M
-} from "./chunk-ABGDJ3NJ.mjs";
+} from "./chunk-3JCWTEEH.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   WORLD_110M

package/dist/index.mjs

@@ -5,7 +5,7 @@ import {
   formatSourceDateFor,
   isExcelDateFormat,
   normaliseAggregation
-} from "./chunk-G4CKILIL.mjs";
+} from "./chunk-Q43WOKSV.mjs";
 import {
   captureSvgSnapshot,
   chartSvgOf,
@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-3EQOJHRA.mjs";
+} from "./chunk-PELRAFYZ.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -66,6 +66,7 @@ import {
   censusColourSpread,
   censusMarks,
   censusValuePlacement,
+  cleanFilterScope,
   cleanHostSelection,
   clippedTextFlag,
   codeHasKeyboardStamp,
@@ -114,7 +115,7 @@ import {
   toRGBA,
   toSourceRows,
   valuePlacementFlag
-} from "./chunk-JQ7FFCOE.mjs";
+} from "./chunk-CASW2BIB.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -141,13 +142,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-4DOKJ3R3.mjs";
+} from "./chunk-IL5M7K6Z.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-GQLEU3VC.mjs";
+} from "./chunk-AEO5SFEQ.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -172,7 +173,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-3ER4C7TG.mjs";
+} from "./chunk-KGVNZR23.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -201,7 +202,7 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-TN5JRULV.mjs";
+} from "./chunk-7XT5OJ6M.mjs";
 import {
   clearGeoCache,
   geoAssetFor,
@@ -209,12 +210,12 @@ import {
   loadGeo,
   registerGeo,
   registerGeoAsset
-} from "./chunk-5WTQN5DL.mjs";
+} from "./chunk-S564YXNE.mjs";
 import {
-  Kt,
+  Ot,
   l,
   o
-} from "./chunk-TH577JHI.mjs";
+} from "./chunk-NJWR3DFK.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -271,7 +272,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-USZSHKIB.mjs";
+} from "./chunk-KY4FI2HA.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/hostLinks.ts
@@ -2308,7 +2309,7 @@ function fingerprintComponentDigest(components) {
 
 // src/index.ts
 function registerCityTable(packed) {
-  Kt(packed);
+  Ot(packed);
 }
 export {
   ACTIVE_TICK_CLASS,
@@ -2493,6 +2494,7 @@ export {
   chartOwnsTimeline,
   chartSvgOf,
   chooserFitsViewport,
+  cleanFilterScope,
   cleanHostSelection,
   clearGeoCache,
   clearLasso,

package/dist/legend-fit.mjs

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

package/dist/page.mjs

@@ -7,6 +7,7 @@ import {
   createControls,
   createFilter,
   createFilterScope,
+  filterScopeOf,
   fromVegaInteraction,
   noteBadges,
   notesFor,
@@ -14,10 +15,10 @@ import {
   readControls,
   viewFromToken,
   viewToken
-} from "./chunk-QAPZIFOB.mjs";
-import "./chunk-4DOKJ3R3.mjs";
-import "./chunk-3ER4C7TG.mjs";
-import "./chunk-USZSHKIB.mjs";
+} from "./chunk-FT75ONSB.mjs";
+import "./chunk-IL5M7K6Z.mjs";
+import "./chunk-KGVNZR23.mjs";
+import "./chunk-KY4FI2HA.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   LINKED_HOVER_CLASS,
@@ -27,6 +28,7 @@ export {
   createControls,
   createFilter,
   createFilterScope,
+  filterScopeOf,
   fromVegaInteraction,
   noteBadges,
   notesFor,

package/dist/provinces.mjs

@@ -2,12 +2,12 @@
 import {
   geoFromCache,
   registerGeo
-} from "./chunk-5WTQN5DL.mjs";
+} from "./chunk-S564YXNE.mjs";
 import {
   Si,
   W,
   bt
-} from "./chunk-TH577JHI.mjs";
+} from "./chunk-NJWR3DFK.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/react.mjs

@@ -7,35 +7,36 @@ import {
   createControls,
   createFilter,
   createFilterScope,
+  filterScopeOf,
   fromVegaInteraction,
   noteBadges,
   notesFor,
   payloadRowReader,
   viewFromToken,
   viewToken
-} from "./chunk-QAPZIFOB.mjs";
+} from "./chunk-FT75ONSB.mjs";
 import {
   assembleD3,
   createChartGroup,
   createChartHost,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-JQ7FFCOE.mjs";
-import "./chunk-4DOKJ3R3.mjs";
-import "./chunk-GQLEU3VC.mjs";
-import "./chunk-3ER4C7TG.mjs";
-import "./chunk-TN5JRULV.mjs";
+} from "./chunk-CASW2BIB.mjs";
+import "./chunk-IL5M7K6Z.mjs";
+import "./chunk-AEO5SFEQ.mjs";
+import "./chunk-KGVNZR23.mjs";
+import "./chunk-7XT5OJ6M.mjs";
 import {
   geoFromCache,
   loadGeo
-} from "./chunk-5WTQN5DL.mjs";
-import "./chunk-TH577JHI.mjs";
+} from "./chunk-S564YXNE.mjs";
+import "./chunk-NJWR3DFK.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-USZSHKIB.mjs";
+import "./chunk-KY4FI2HA.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx
-import { createContext, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 var Ctx = createContext(null);
 function useBicSelection() {
@@ -65,7 +66,7 @@ function BicChart(props) {
   const {
     code,
     renderFn,
-    options,
+    options: pageOptions,
     d3,
     geoKind,
     viewState,
@@ -85,9 +86,29 @@ function BicChart(props) {
     className,
     style,
     selects,
+    scopedBy,
     controls,
     ariaLabel
   } = props;
+  const scopeList = scopedBy == null ? [] : Array.isArray(scopedBy) ? scopedBy : [scopedBy];
+  const scopeIds = scopeList.map((f) => f?.id).join("
");
+  const subscribeScope = useCallback((cb) => {
+    const offs = scopeList.map((f) => f?.onChange?.(() => cb()));
+    return () => {
+      for (const off of offs) off?.();
+    };
+  }, [scopeIds]);
+  const scopeSnapshot = () => scopeList.map((f) => f?.version).join(",");
+  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 scopeKey = scopeFact ? JSON.stringify(scopeFact) : "";
+  const options = useMemo(
+    () => scopeEver ? { ...pageOptions ?? {}, filterScope: scopeFact ?? pageOptions?.filterScope } : pageOptions,
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [pageOptions, scopeEver, scopeKey]
+  );
   const ref = useRef(null);
   const hostRef = useRef(null);
   const rowMapRef = useRef(null);
@@ -503,6 +524,7 @@ export {
   createControls,
   createFilter,
   createFilterScope,
+  filterScopeOf,
   fromVegaInteraction,
   noteBadges,
   notesFor,

package/dist/testing.mjs

@@ -4,7 +4,7 @@ import {
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-USZSHKIB.mjs";
+} from "./chunk-KY4FI2HA.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.22.0";
+export declare const HOST_CONTRACT_VERSION = "1.23.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[];
@@ -51,6 +51,18 @@ export interface HostSelectionFact {
     };
 }
 export declare const CONTAINER_SLOT_HOST_SELECTION = "__lchHostSelection";
+/**
+ * THE PAGE FILTER THAT NARROWED THIS CHART'S ROWS BEFORE THEY ARRIVED (1.23.0), as RenderOptions.filterScope. Untrusted
+ * on the chart side like every option: resolveOptions keeps values to non-blank text, each once.
+ */
+export interface FilterScopeFact {
+    /** The field the filter is on, as the reader knows it ("Country"); "" when the host can't name it. */
+    field: string;
+    /** The values it keeps, as the reader reads them ("United States"); never empty. */
+    values: string[];
+    /** The host's own phrase for the whole filter ("the two neighbours"), used instead of one made from the values. */
+    label?: string;
+}
 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";
@@ -149,6 +161,7 @@ export interface RenderOptions {
     rowsWithheld?: number;
     rowsFilteredOut?: number;
     hostSelection?: HostSelectionFact;
+    filterScope?: FilterScopeFact;
     openUrl?: (url: string) => void;
     copyText?: (text: string) => boolean | void | Promise<boolean | void>;
     saveFile?: SaveFileService;

package/dist/types/defaults.d.ts

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

package/dist/types/filterScope.d.ts

@@ -1,5 +1,6 @@
 import type { ChartHost } from "./host";
 import type { Controls } from "./controls";
+import type { FilterScopeFact } from "./contract";
 /** Why a filter changed. */
 export type FilterChangeReason = "click" | "clear" | "page" | "data";
 /** One selected key: a value per key column, in the filter's column order. */
@@ -118,6 +119,13 @@ export declare function viewFromToken(token: string | null | undefined): PageVie
 export declare function createFilter(columns: string | readonly string[], opts?: FilterOptions): Filter;
 /** Make a page's filter scope. */
 export declare function createFilterScope(): FilterScope;
+/**
+ * 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.
+ */
+export declare function filterScopeOf(filters: Filter | readonly Filter[] | 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/geo-world.d.ts

@@ -1 +1 @@
-export { WORLD_110M } from "./geoWorld110m.generated";
+export { WORLD_110M } from "./geoWorld110m";

package/dist/types/geoWorld110m.d.ts

@@ -0,0 +1 @@
+export declare const WORLD_110M: any;

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, CONTAINER_SLOT_HOST_SELECTION, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, MARKS_INERT_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, DIM_OPACITY_MIN, chartOwnsTimeline, periodTickSuppressesFeedback, ANIM_PLAY_SPEED_DEFAULT, ANIM_PLAY_SPEED_MIN, ANIM_PLAY_SPEED_MAX, ANIM_LOOP_DELAY_DEFAULT, ANIM_LOOP_DELAY_MIN, ANIM_MAX_IDEAL_FRAMES_DEFAULT, ANIM_MAX_IDEAL_FRAMES_MIN, ANIM_MAX_IDEAL_FRAMES_MAX, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, FLIP_INTERVAL_MIN_MS, FLIP_INTERVAL_MAX_MS, FLIP_DIRECTION_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type FlipDirection, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, type XfilterRefreshDetail, type HostSelectionFact, } from "./contract";
-export { resolveOptions, cleanHostSelection, type ResolveOptionsInput } from "./defaults";
+export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, CONTROL_CLASS, NO_ROW_MARKS_ATTR, NOTE_STYLE_ATTR, SELECTION_RULE_ATTR, SELECTION_RULE_CLICKED_MARKS, MARK_KEY_ATTR, CONTAINER_SLOT_CLICKED_MARKS, SNAPSHOT_SVG_ATTR, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, CONTAINER_SLOT_SCROLL, CONTAINER_SLOT_HOST_SELECTION, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, MARKS_INERT_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, DIM_OPACITY_MIN, chartOwnsTimeline, periodTickSuppressesFeedback, ANIM_PLAY_SPEED_DEFAULT, ANIM_PLAY_SPEED_MIN, ANIM_PLAY_SPEED_MAX, ANIM_LOOP_DELAY_DEFAULT, ANIM_LOOP_DELAY_MIN, ANIM_MAX_IDEAL_FRAMES_DEFAULT, ANIM_MAX_IDEAL_FRAMES_MIN, ANIM_MAX_IDEAL_FRAMES_MAX, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, FLIP_INTERVAL_MIN_MS, FLIP_INTERVAL_MAX_MS, FLIP_DIRECTION_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type FlipDirection, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, type XfilterRefreshDetail, type HostSelectionFact, type FilterScopeFact, } from "./contract";
+export { resolveOptions, cleanHostSelection, cleanFilterScope, 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";

package/dist/types/keyboardMarks.d.ts

@@ -37,7 +37,8 @@ export interface KeyboardHandle {
     refresh(): void;
     destroy(): void;
 }
-/** What a screen reader calls a row: its first few values, numbers in the reader's culture, internal columns left out.
- *  Shared so every host names a mark the same way. */
+/** What a screen reader calls a row: its first few values, numbers and dates in the reader's culture, internal columns
+ *  left out. A Date is read as the reader's date, never as its String() (weekday, time and time zone); one that names
+ *  no day is skipped like a blank. Text is kept as it is. Shared so every host names a mark the same way. */
 export declare function rowNameOf(columns: ReadonlyArray<unknown>, row: ReadonlyArray<unknown> | null | undefined, culture?: string): string | null;
 export declare function installKeyboard(env: KeyboardEnv): KeyboardHandle;

package/dist/types/page.d.ts

@@ -1,4 +1,4 @@
 export { viewToken, viewFromToken, LINKED_HOVER_CLASS, type PageView } from "./filterScope";
-export { createFilter, createFilterScope, bindFilter, payloadRowReader, fromVegaInteraction, 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, type Filter, type FilterScope, type FilterOptions, type FilterKey, type FilterChangeReason, type FilterBinding, type BindFilterOptions, type VegaInteractionEvent } 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

@@ -8,7 +8,7 @@ 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, type Filter, type FilterOptions, type FilterScope, type FilterChangeReason } from "./filterScope";
+export { createFilter, createFilterScope, fromVegaInteraction, filterScopeOf, type Filter, type FilterOptions, type FilterScope, type FilterChangeReason } from "./filterScope";
 export interface BicChartProps {
     /** Generated render() source (an ES module's `code` export, or the raw string). */
     code?: string;
@@ -100,6 +100,15 @@ export interface BicChartProps {
      * `selects`, the filter owns what this chart shows as selected.
      */
     selects?: Filter;
+    /**
+     * THE PAGE FILTERS THIS CHART'S QUERY ALREADY APPLIES - a KPI deck whose query takes the picked country, a table the
+     * page narrows with `filter.keep(rows)` before handing it over. The rows arrive narrowed, so the chart can't see the
+     * filter; while one of these is active the chart is told (options.filterScope: the filter's label and the values its
+     * 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.
+     */
+    scopedBy?: Filter | readonly Filter[];
     /**
      * 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

package/dist/zoom-memory.mjs

@@ -1,7 +1,7 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
 import {
   K
-} from "./chunk-TH577JHI.mjs";
+} from "./chunk-NJWR3DFK.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/zoomMemory/zoomMemory.ts

package/package.json

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