@bicharts/chart-host 0.6.108 → 0.6.110

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

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

@@ -6,7 +6,7 @@ import {
   Ti,
   j,
   u
-} from "./chunk-SYUJ4TPX.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-MU4BWWO6.mjs";
+} from "./chunk-Q43WOKSV.mjs";
 import {
   captureSvgSnapshot,
   chartSvgOf,
@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-FCLPMC6Q.mjs";
+} from "./chunk-PELRAFYZ.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -29,6 +29,8 @@ import {
   DARK_TEXT,
   EXPORT_FORMATS,
   GLYPH_SAMPLE_N,
+  KEYBOARD_CLASS,
+  KEYBOARD_STAMP,
   LABEL_CONTRAST_CAP,
   LABEL_CONTRAST_DONE_ATTR,
   LABEL_PILL_CLASS,
@@ -47,6 +49,7 @@ import {
   STRADDLE_TARGET_CONTRAST,
   VALUE_AXIS_MIN_FIT,
   WHITE_TEXT_BG_LUM,
+  WIRED_ATTR,
   XLSX_MIME,
   applyLabelContrast,
   assembleD3,
@@ -63,8 +66,10 @@ import {
   censusColourSpread,
   censusMarks,
   censusValuePlacement,
+  cleanFilterScope,
   cleanHostSelection,
   clippedTextFlag,
+  codeHasKeyboardStamp,
   colourSpreadFlag,
   compileRenderFn,
   compositeOver,
@@ -80,6 +85,7 @@ import {
   exportFormatsFor,
   exportTableService,
   glyphSampleGrid,
+  installKeyboard,
   invalidSentinelReason,
   isBlankRender,
   isInvalidSentinelError,
@@ -90,9 +96,12 @@ import {
   pickColorOver,
   pillBacksGlyph,
   relativeLuminance,
+  rememberFocus,
   requiredD3Plugins,
   resolveAutoColorScale,
   resolveOptions,
+  restoreFocus,
+  rowNameOf,
   scopeChartIds,
   sessionViewStateProvider,
   sheetName,
@@ -106,7 +115,7 @@ import {
   toRGBA,
   toSourceRows,
   valuePlacementFlag
-} from "./chunk-MO2GR56D.mjs";
+} from "./chunk-5VQ3IQF7.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -133,13 +142,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-ESBH2L6E.mjs";
+} from "./chunk-IL5M7K6Z.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-UKXGOQMS.mjs";
+} from "./chunk-AEO5SFEQ.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -164,7 +173,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-LGWTV5PB.mjs";
+} from "./chunk-KGVNZR23.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -193,7 +202,7 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-OSREEGBN.mjs";
+} from "./chunk-7XT5OJ6M.mjs";
 import {
   clearGeoCache,
   geoAssetFor,
@@ -201,12 +210,12 @@ import {
   loadGeo,
   registerGeo,
   registerGeoAsset
-} from "./chunk-5WTQN5DL.mjs";
+} from "./chunk-S564YXNE.mjs";
 import {
-  Kt,
+  Ot,
   l,
   o
-} from "./chunk-SYUJ4TPX.mjs";
+} from "./chunk-NJWR3DFK.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -244,6 +253,7 @@ import {
   HOST_CONTRACT_VERSION,
   LEGEND_MARK_CLASS,
   LIFT_SELECTED_CLASS,
+  MARKS_INERT_CLASS,
   MARK_CLASS,
   MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
@@ -262,7 +272,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-PHUUFCJY.mjs";
+} from "./chunk-KY4FI2HA.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/hostLinks.ts
@@ -2299,7 +2309,7 @@ function fingerprintComponentDigest(components) {
 
 // src/index.ts
 function registerCityTable(packed) {
-  Kt(packed);
+  Ot(packed);
 }
 export {
   ACTIVE_TICK_CLASS,
@@ -2368,6 +2378,9 @@ export {
   HOST_CONTAINER_CLASS,
   HOST_CONTRACT_VERSION,
   INLINE_FILTER_MIN_ROWS,
+  KEYBOARD_CLASS,
+  KEYBOARD_STAMP,
+  WIRED_ATTR as KEYBOARD_WIRED_ATTR,
   LABEL_CONTRAST_CAP,
   LABEL_CONTRAST_DONE_ATTR,
   LABEL_PILL_CLASS,
@@ -2394,6 +2407,7 @@ export {
   LIGHT_TEXT,
   LIMIT_COUNT_MAX,
   LIVE_OPTION_KEYS,
+  MARKS_INERT_CLASS,
   MARK_CLASS,
   MARK_KEY_ATTR,
   MARK_SELECTED_CLASS,
@@ -2480,6 +2494,7 @@ export {
   chartOwnsTimeline,
   chartSvgOf,
   chooserFitsViewport,
+  cleanFilterScope,
   cleanHostSelection,
   clearGeoCache,
   clearLasso,
@@ -2487,6 +2502,7 @@ export {
   clearSelectionGlyphs,
   clickWasDrag,
   clippedTextFlag,
+  codeHasKeyboardStamp,
   codeReadsDatesInLocalTime,
   codeReadsOption,
   collectD3GlyphCenters,
@@ -2537,6 +2553,7 @@ export {
   htmlNaturalSize,
   htmlToSvgDataUrl,
   inlineFilterGate,
+  installKeyboard,
   installLasso,
   invalidSentinelReason,
   isBlankRender,
@@ -2630,11 +2647,14 @@ export {
   registerGeoAsset,
   registerLassoAction,
   relativeLuminance,
+  rememberFocus,
   rememberScroll,
   requiredD3Plugins,
   resolveAutoColorScale,
   resolveOptions,
+  restoreFocus,
   rowIdxsFromMark,
+  rowNameOf,
   sameMarker,
   sameRowSet,
   scopeChartIds,

package/dist/legend-fit.mjs

@@ -2,13 +2,13 @@
 import {
   chartSvgOf,
   tableHostOf
-} from "./chunk-FCLPMC6Q.mjs";
+} from "./chunk-PELRAFYZ.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-OSREEGBN.mjs";
-import "./chunk-PHUUFCJY.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-JU2PQ22J.mjs";
-import "./chunk-ESBH2L6E.mjs";
-import "./chunk-LGWTV5PB.mjs";
-import "./chunk-PHUUFCJY.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-SYUJ4TPX.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-JU2PQ22J.mjs";
+} from "./chunk-FT75ONSB.mjs";
 import {
   assembleD3,
   createChartGroup,
   createChartHost,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-MO2GR56D.mjs";
-import "./chunk-ESBH2L6E.mjs";
-import "./chunk-UKXGOQMS.mjs";
-import "./chunk-LGWTV5PB.mjs";
-import "./chunk-OSREEGBN.mjs";
+} from "./chunk-5VQ3IQF7.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-SYUJ4TPX.mjs";
+} from "./chunk-S564YXNE.mjs";
+import "./chunk-NJWR3DFK.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-PHUUFCJY.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);
@@ -185,7 +206,11 @@ function BicChart(props) {
       // siblings of a chart that has an id in a group. This binding always
       // subscribes to the selection (for onSelect), so the host cannot count
       // subscribers here; an onSelect callback alone is not the page's filter.
-      selectionReachesPage: () => !!reachRef.current.selects || !!(reachRef.current.group && reachRef.current.id)
+      selectionReachesPage: () => !!reachRef.current.selects || !!(reachRef.current.group && reachRef.current.id),
+      // Whether a click on a mark does anything at all: the same two,
+      // or an onSelect the page passed. A chart with none of them draws its marks
+      // inert rather than dimming the others for a click that filters nothing.
+      marksSelect: () => !!reachRef.current.selects || !!(reachRef.current.group && reachRef.current.id) || typeof onSelectRef.current === "function"
     });
     hostRef.current = host;
     builtAnnKeyRef.current = annKey;
@@ -499,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-PHUUFCJY.mjs";
+} from "./chunk-KY4FI2HA.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/testing/interact.ts

package/dist/types/annotations.d.ts

@@ -40,4 +40,6 @@ export interface AnnotationLayer {
     readonly report: AnnotationReport;
     destroy(): void;
 }
-export declare function createAnnotationLayer(container: HTMLElement, onClick?: (a: MarkAnnotation) => void): AnnotationLayer;
+export declare function createAnnotationLayer(container: HTMLElement, onClick?: (a: MarkAnnotation) => void, opts?: {
+    keyboard?: () => boolean;
+}): AnnotationLayer;

package/dist/types/contract.d.ts

@@ -1,5 +1,5 @@
 import type { ExportFormat, ExportTableService, SaveFileService } from "./exportTable";
-export declare const HOST_CONTRACT_VERSION = "1.21.0";
+export declare const HOST_CONTRACT_VERSION = "1.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";
@@ -90,6 +102,7 @@ export interface ViewStateProvider {
 export declare const HOST_CONTAINER_CLASS = "bic-chart-host";
 export declare const SELECTION_ACTIVE_CLASS = "lch-has-selection";
 export declare const MARK_SELECTED_CLASS = "lch-mark-selected";
+export declare const MARKS_INERT_CLASS = "lch-marks-inert";
 export declare const ACTIVE_TICK_CLASS = "lch-tick-active";
 export declare const DIM_OPACITY_VAR = "--lch-dim-opacity";
 export declare const DIM_OPACITY_DEFAULT = 0.25;
@@ -148,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;
@@ -196,6 +210,10 @@ export interface RenderOptions {
     selectionGlyph?: "none" | "dot" | "check";
     /** A host FACT from the generate answer: this chart's family never takes a selection glyph. */
     suppressSelectionGlyph?: boolean;
+    /** A host FACT: this chart works from the keyboard (its code carries the keyboard stamp), so the host has made its
+     *  selectable marks focusable. A chart or helper drawing its own controls (a flip arrow, a sort header) gives them
+     *  a tabindex, a role and an Enter / Space press when this is true. */
+    keyboardMarks?: boolean;
     animAutoPlay?: boolean;
     animPlaySpeedMs?: number;
     animLoopDelaySec?: number;

package/dist/types/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/focusKeep.d.ts

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

package/dist/types/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/host.d.ts

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

package/dist/types/index.d.ts

@@ -1,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, 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";
@@ -11,6 +11,8 @@ export { buildRenderPayload, type RenderPayload, type GeoPointBinding, type GeoB
 export { codeReadsDatesInLocalTime, vegaSpecReadsDatesInLocalTime } from "./dateCells";
 export { createChartHost, compileRenderFn, stripEsmExports, requiredD3Plugins, explainRenderFailure, sessionViewStateProvider, noopViewStateProvider, assembleD3, D3_PLUGIN_PACKAGES, type ChartHost, type ChartHostConfig, type RenderFn, type SelectionPaintReport, type SelectionChangeMeta } from "./host";
 export { ANNOTATION_CLASS, ANNOTATION_LAYER_CLASS, type MarkAnnotation, type AnnotationReport } from "./annotations";
+export { KEYBOARD_STAMP, KEYBOARD_CLASS, WIRED_ATTR as KEYBOARD_WIRED_ATTR, codeHasKeyboardStamp, installKeyboard, rowNameOf, type KeyboardEnv, type KeyboardHandle } from "./keyboardMarks";
+export { rememberFocus, restoreFocus, type FocusMemory } from "./focusKeep";
 export type { MarkNoteLike, NoteBadgeOptions } from "./markNotes";
 export type { Controls, ControlInfo, ControlsAttachment } from "./controls";
 export { createChartGroup, toSourceRows, syncMemberSelection, type ChartGroup, type ChartGroupMember, type ChartGroupSelection, type ChartGroupChange, type ChartGroupMemberOptions, type ChartGroupSourceOptions, type ChartGroupPayload } from "./group";

package/dist/types/keyboardMarks.d.ts

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