@bicharts/chart-host 0.6.113 → 0.6.116

package/dist/index.mjs

@@ -5,7 +5,7 @@ import {
   formatSourceDateFor,
   isExcelDateFormat,
   normaliseAggregation
-} from "./chunk-OLCUKXKL.mjs";
+} from "./chunk-JMLSNV5Q.mjs";
 import {
   captureSvgSnapshot,
   chartSvgOf,
@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-PELRAFYZ.mjs";
+} from "./chunk-IW6BKFF5.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -35,15 +35,19 @@ 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,
@@ -65,38 +69,45 @@ import {
   bytesToBase64,
   cellSuppressesNormalize,
   censusClippedText,
-  censusColourSpread,
   censusMarks,
   censusValuePlacement,
   cleanFilterScope,
   cleanHostSelection,
   clippedTextFlag,
   codeHasKeyboardStamp,
-  colourSpreadFlag,
+  collectOutlineMarks,
   compileRenderFn,
   compositeOver,
   contrastRatio,
+  controlBoxesIn,
   createChartGroup,
   createChartHost,
   decideLabelColor,
-  deltaEHex,
   excelNumberFormat,
   excelSerial,
   explainRenderFailure,
   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 +117,7 @@ import {
   rowGrowthNotice,
   rowNameOf,
   scopeChartIds,
+  selectionMarkerFor,
   sessionViewStateProvider,
   sheetName,
   straddleSampleGrid,
@@ -119,7 +131,7 @@ import {
   toSourceRows,
   trackFocus,
   valuePlacementFlag
-} from "./chunk-TE54AFRN.mjs";
+} from "./chunk-GZSYTDFN.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -146,13 +158,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-IL5M7K6Z.mjs";
+} from "./chunk-TUZCM7SX.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-AEO5SFEQ.mjs";
+} from "./chunk-EFKGSDFF.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -177,7 +189,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-KGVNZR23.mjs";
+} from "./chunk-RLOIA7QK.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -202,11 +214,12 @@ import {
   planFrameGrow,
   planScrollRestore,
   rememberScroll,
+  restoreInnerScroll,
   scrollFitFor,
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-7XT5OJ6M.mjs";
+} from "./chunk-63IUMWY2.mjs";
 import {
   clearGeoCache,
   geoAssetFor,
@@ -214,12 +227,19 @@ import {
   loadGeo,
   registerGeo,
   registerGeoAsset
-} from "./chunk-5YSZABCS.mjs";
+} from "./chunk-LXTW6YII.mjs";
 import {
   Ot,
   l,
   o
-} from "./chunk-FIG5DIW7.mjs";
+} from "./chunk-K2TH7D5V.mjs";
+import {
+  MIN_RAMP_FILLS,
+  SAME_SHADE_DELTA_E,
+  censusColourSpread,
+  colourSpreadFlag,
+  deltaEHex
+} from "./chunk-JTZTTJJK.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import {
   ACTIVE_TICK_CLASS,
@@ -234,6 +254,7 @@ import {
   ANIM_PLAY_SPEED_MIN,
   APPROXIMATE_POSITIONS_DEFAULT,
   AXIS_FILTER_CLASS,
+  CATEGORY_DELTA_E_FLOOR,
   COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT,
   COLOR_SCALE_SELF_CLAMP_PCT_MAX,
   COLOR_SCALE_SELF_CLAMP_PCT_MIN,
@@ -270,13 +291,14 @@ import {
   SELECTION_RULE_ATTR,
   SELECTION_RULE_CLICKED_MARKS,
   SNAPSHOT_SVG_ATTR,
+  TABLE_SCROLLER_CLASS,
   VALUE_AXIS_BASELINE_DEFAULT,
   VIEW_ONLY_UI_STATE_KEYS,
   XFILTER_REFRESH_EVENT,
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-KY4FI2HA.mjs";
+} from "./chunk-QG5TENI3.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/hostLinks.ts
@@ -1372,6 +1394,42 @@ function inlineFilterGate(rowCount) {
 var INLINE_FILTER_MIN_ROWS = 8;
 
 // src/qualifyTable.ts
+var QUALIFY_KIND_BADGES = Object.freeze({
+  app: Object.freeze({
+    label: "App",
+    light: Object.freeze({ background: "#FCE7E3", text: "#923121" }),
+    dark: Object.freeze({ background: "#612116", text: "#FCE7E3" })
+  }),
+  table: Object.freeze({
+    label: "Table",
+    light: Object.freeze({ background: "#E6EBF2", text: "#35445A" }),
+    dark: Object.freeze({ background: "#232D3C", text: "#E6EBF2" })
+  }),
+  map: Object.freeze({
+    label: "Map",
+    light: Object.freeze({ background: "#E1F3EF", text: "#175C52" }),
+    dark: Object.freeze({ background: "#103D37", text: "#E1F3EF" })
+  }),
+  kpi: Object.freeze({
+    label: "KPI",
+    light: Object.freeze({ background: "#FBF0D6", text: "#7E560C" }),
+    dark: Object.freeze({ background: "#543A08", text: "#FBF0D6" })
+  })
+});
+function qualifyKindBadgeStyle(kind, pane) {
+  const k2 = knownKind(kind);
+  if (!k2) return null;
+  const badge = QUALIFY_KIND_BADGES[k2];
+  if (typeof pane === "object") {
+    const fg = pane.highContrastForeground;
+    return { label: badge.label, background: "transparent", color: fg, border: `1px solid ${fg}` };
+  }
+  const c2 = pane === "dark" ? badge.dark : badge.light;
+  return { label: badge.label, background: c2.background, color: c2.text, border: "none" };
+}
+function knownKind(v2) {
+  return typeof v2 === "string" && Object.prototype.hasOwnProperty.call(QUALIFY_KIND_BADGES, v2) ? v2 : null;
+}
 function qualifyTableRows(rows) {
   return rows.map((r2) => ({
     rank: typeof r2.rank === "number" && Number.isFinite(r2.rank) ? r2.rank : null,
@@ -1381,7 +1439,8 @@ function qualifyTableRows(rows) {
     description: r2.description ?? "",
     language: r2.language ? r2.language : null,
     renderer: r2.renderer ? r2.renderer : null,
-    alsoWorthALook: r2.alsoWorthALook === true
+    alsoWorthALook: r2.alsoWorthALook === true,
+    kind: knownKind(r2.kind)
   }));
 }
 
@@ -2338,6 +2397,7 @@ export {
   AXIS_PIN_MIN_LABELS,
   AXIS_PIN_TRACK_REACH_PX,
   BACKING_MAJORITY,
+  CATEGORY_DELTA_E_FLOOR,
   CHOOSER_MIN_HEIGHT_PX,
   CHOOSER_MIN_WIDTH_PX,
   CLIP_TOLERANCE_PX,
@@ -2411,9 +2471,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 +2485,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,
@@ -2441,10 +2504,12 @@ export {
   PILL_OPAQUE_ALPHA,
   PRODUCT_FEEDBACK_MAX_CHARS,
   PRODUCT_FEEDBACK_MIN_CHARS,
+  QUALIFY_KIND_BADGES,
   QUALIFY_REFUSAL_UNSPECIFIED,
   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 +2519,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,
@@ -2462,6 +2529,7 @@ export {
   STRADDLE_PILL_ALPHA,
   STRADDLE_ROWS,
   STRADDLE_TARGET_CONTRAST,
+  TABLE_SCROLLER_CLASS,
   TRANSPORT_LOST_CHECKING_MESSAGE,
   VALUE_AXIS_BASELINE_DEFAULT,
   VALUE_AXIS_MIN_FIT,
@@ -2512,6 +2580,7 @@ export {
   codeReadsDatesInLocalTime,
   codeReadsOption,
   collectD3GlyphCenters,
+  collectOutlineMarks,
   colourSpreadFlag,
   compileRenderFn,
   compileTrivialSource,
@@ -2522,6 +2591,7 @@ export {
   confirmLaunch,
   contentExtentOf,
   contrastRatio,
+  controlBoxesIn,
   createChartGroup,
   createChartHost,
   createMarkResolver,
@@ -2546,6 +2616,7 @@ export {
   fingerprintComponentDigest,
   fitReadingFor,
   fitRenderedChart,
+  followMarks,
   formatSourceDate,
   formatSourceDateFor,
   generationCancelledMessage,
@@ -2553,6 +2624,7 @@ export {
   geoFromCache,
   gestureWasDrag,
   glyphSampleGrid,
+  hasNeutralCentreRamp,
   hasRefusalsToShow,
   hitBandFlag,
   hostLinkServices,
@@ -2562,6 +2634,7 @@ export {
   installKeyboard,
   installLasso,
   invalidSentinelReason,
+  isAreaMark,
   isBlankRender,
   isBlindMarker,
   isDuplicateGenerate,
@@ -2574,6 +2647,7 @@ export {
   isPhantomBox,
   isPickableModelCode,
   isPillBackdropAlpha,
+  isRegionMapData,
   labelBand,
   lassoActions,
   lassoEffect,
@@ -2605,7 +2679,9 @@ export {
   normalizeFilterTerm,
   orderMostDistinct,
   orderRefusalsForDisplay,
+  outlineWindowOf,
   paintSelectionGlyphs,
+  paintSelectionOutlines,
   parsePendingGenerate,
   pendingRecoveryNextDelayMs,
   pendingRecoveryRemainingMs,
@@ -2629,13 +2705,16 @@ export {
   qualifyFilterCountText,
   qualifyFilterGate,
   qualifyGroupHeadingFor,
+  qualifyKindBadgeStyle,
   qualifyPick,
   qualifyRefusalHeadingFor,
   qualifyRefusalReason,
   qualifyTableRows,
   rasterizeSvgToPngDataUrl,
+  readMapSelectionMarker,
   readQualifyChartRow,
   readQualifyRefusalRow,
+  readSelectionMarker,
   reconcileChartPick,
   reconcileModelPick,
   recoveryAnswerIsCancelled,
@@ -2659,6 +2738,7 @@ export {
   resolveAutoColorScale,
   resolveOptions,
   restoreFocus,
+  restoreInnerScroll,
   rowGrowthNotice,
   rowIdxsFromMark,
   rowNameOf,
@@ -2666,6 +2746,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-IW6BKFF5.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-7XT5OJ6M.mjs";
-import "./chunk-KY4FI2HA.mjs";
+} from "./chunk-63IUMWY2.mjs";
+import "./chunk-QG5TENI3.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-VGJH63LZ.mjs";
+import "./chunk-TUZCM7SX.mjs";
+import "./chunk-RLOIA7QK.mjs";
+import "./chunk-QG5TENI3.mjs";
 import {
   ANY_VALUE,
   LINKED_HOVER_CLASS,
@@ -20,9 +20,10 @@ import {
   fromVegaInteraction,
   isAnyValue,
   payloadRowReader,
+  scopeFilterOf,
   viewFromToken,
   viewToken
-} from "./chunk-2KLFIGTQ.mjs";
+} from "./chunk-ZZBX5ZJ6.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   ANY_VALUE,
@@ -40,6 +41,7 @@ export {
   notesFor,
   payloadRowReader,
   readControls,
+  scopeFilterOf,
   viewFromToken,
   viewToken
 };

package/dist/provinces.mjs

@@ -2,13 +2,13 @@
 import {
   geoFromCache,
   registerGeo
-} from "./chunk-5YSZABCS.mjs";
+} from "./chunk-LXTW6YII.mjs";
 import {
   Mi,
-  Rt,
+  Nt,
   W,
   bt
-} from "./chunk-FIG5DIW7.mjs";
+} from "./chunk-K2TH7D5V.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -199,7 +199,7 @@ function provinceBinding(res, cols, opts) {
   const words = (n) => n.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase().split(/[^a-z]+/);
   const named = (re) => cols.find((c) => words(c.name).some((w) => re.test(w)))?.name ?? null;
   const accentWords = (n) => n.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase().split(/[^a-zÀ-ɏ]+/);
-  const localized = (axis) => cols.find((c) => Rt(accentWords(c.name)) === axis)?.name ?? null;
+  const localized = (axis) => cols.find((c) => Nt(accentWords(c.name)) === axis)?.name ?? null;
   const lat = named(/^(lat|latitude)$/), lon = named(/^(lon|lng|long|longitude)$/);
   const localLat = localized("lat"), localLon = localized("lon");
   const usePair = localLat !== null && localLon !== null;

package/dist/react.mjs

@@ -5,25 +5,26 @@ import {
   createControls,
   noteBadges,
   notesFor
-} from "./chunk-GTJG3SMD.mjs";
+} from "./chunk-VGJH63LZ.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-GZSYTDFN.mjs";
+import "./chunk-TUZCM7SX.mjs";
+import "./chunk-EFKGSDFF.mjs";
+import "./chunk-RLOIA7QK.mjs";
+import "./chunk-63IUMWY2.mjs";
 import {
   geoFromCache,
   loadGeo
-} from "./chunk-5YSZABCS.mjs";
-import "./chunk-FIG5DIW7.mjs";
+} from "./chunk-LXTW6YII.mjs";
+import "./chunk-K2TH7D5V.mjs";
+import "./chunk-JTZTTJJK.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-KY4FI2HA.mjs";
+import "./chunk-QG5TENI3.mjs";
 import {
   ANY_VALUE,
   LINKED_HOVER_CLASS,
@@ -34,9 +35,10 @@ import {
   fromVegaInteraction,
   isAnyValue,
   payloadRowReader,
+  scopeFilterOf,
   viewFromToken,
   viewToken
-} from "./chunk-2KLFIGTQ.mjs";
+} from "./chunk-ZZBX5ZJ6.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx
@@ -96,7 +98,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 +111,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 +341,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) {
@@ -410,7 +414,7 @@ function BicDevtools({ max = 20 }) {
     scope.filters.map((f) => /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx("b", { children: f.label }),
       " [",
-      f.key,
+      scope.keyOf?.(f) ?? f.key,
       "] ",
       f.active ? JSON.stringify(f.keys) : "(none)",
       " ",

package/dist/testing.mjs

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

package/dist/types/categoryColours.d.ts

@@ -0,0 +1,71 @@
+/** More distinct colours than this is a continuous colour channel, not categories: the census declines. */
+export declare const MAX_CATEGORY_SLOTS = 24;
+/**
+ * From this many colours a set lying on one path, its lightness rising or falling along it (turning at most once, as
+ * a diverging ramp's does at its centre), is declined as a ramp. Below it the shape is reported
+ * (`rampLike`) but not declined: four or five categorical colours can sit on one path by chance, and a set of
+ * categories that does is exactly the too-close case this census exists to see (two greens and two blue-greys read
+ * as a ramp, yet were drawn as four categories).
+ */
+export declare const RAMP_DECLINE_MIN_SLOTS = 6;
+/** At most this many pairs under the floor are listed (the closest first); `pairsBelowFloorCount` counts them all. */
+export declare const MAX_LISTED_PAIRS = 10;
+export interface CategoryColourCensusOptions {
+    /** The page background the chart is painted on; white when absent or unreadable. */
+    pageBg?: string;
+    /** The opacity a selection leaves on the other categories (0..1); chart-host's default when absent. */
+    dimOpacity?: number;
+}
+export interface CategoryColourCensus {
+    /** Where the colours came from: "legend" (one per swatch), "marks" (the distinct mark colours), or "" for none. */
+    source: string;
+    /** Why nothing is reported: "" when reported, else "none" (fewer than two colours), "ramp" or "too-many". */
+    declined: string;
+    /** Distinct category colours found (0 when declined for having none). */
+    slots: number;
+    /** The closest two colours, as painted hex at full strength; empty when not reported. */
+    closestPair: string[];
+    /** CIEDE2000 of the closest pair at full strength (one decimal); null when not reported. */
+    closestDeltaE: number | null;
+    /** The same, after each colour is blended at its element's own opacity over the page; null when not reported. */
+    closestDeltaEPainted: number | null;
+    /** The same at the dim level (own opacity times the dim level, over the page); null when not reported. */
+    closestDeltaEDimmed: number | null;
+    /** The dim level used. */
+    dimOpacity: number;
+    /** True when the colours lie on one path, as a sequential ramp's do (reported below RAMP_DECLINE_MIN_SLOTS). */
+    rampLike: boolean;
+    /** With a legend: true when every legend colour is painted on some mark; null without a legend or marks. */
+    legendMatchesMarks: boolean | null;
+    /** The floor the painted colours are held to (CATEGORY_DELTA_E_FLOOR). */
+    floor: number;
+    /** True when the closest pair AS PAINTED is under the floor; false when it clears it; null when not reported. */
+    belowFloor: boolean | null;
+    /** How many pairs, as painted, are under the floor (0 when not reported). */
+    pairsBelowFloorCount: number;
+    /** Those pairs, closest first (at most MAX_LISTED_PAIRS): each colour at full strength and the painted distance. */
+    pairsBelowFloor: CategoryColourPair[];
+    /** The closest pair as painted (the colours at full strength); empty when not reported. */
+    closestPairPainted: string[];
+    /** The closest painted distance under simulated deuteranopia (Machado 2009, severity 1); null when not reported. */
+    closestDeltaEDeutan: number | null;
+    /** The same under simulated protanopia; null when not reported. */
+    closestDeltaEProtan: number | null;
+}
+/** Two category colours (at full strength) and their CIEDE2000 distance as painted. */
+export interface CategoryColourPair {
+    colours: [string, string];
+    deltaE: number;
+}
+/**
+ * How close are the two closest category colours, as painted? Prefers the legend (one colour per swatch) and falls
+ * back to the distinct colours of the marks. Never throws and never changes the chart: an environment that cannot
+ * report a colour reports nothing.
+ *
+ * KNOWN LIMITS, stated rather than hidden: a selection's dimming is applied by a stylesheet rule, so "painted" is the
+ * resting chart and the dimmed figure is computed from the dim level; colours set only by a stylesheet class are
+ * read through computed style, which a headless DOM without layout may not resolve; six or more categorical colours
+ * on one path (shades of one hue) are declined as a ramp; a binned diverging ramp, whose two arms do not lie on one
+ * path, is measured as categories, so its neighbouring bins are reported under the floor.
+ */
+export declare function censusCategoryColours(container: any, doc?: any, options?: CategoryColourCensusOptions): CategoryColourCensus;

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[];
@@ -68,6 +68,7 @@ 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 TABLE_SCROLLER_CLASS = "lch-table-body";
 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
@@ -107,6 +108,7 @@ 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;
 export declare const DIM_OPACITY_MIN = 0.01;
+export declare const CATEGORY_DELTA_E_FLOOR = 25;
 export declare function chartOwnsTimeline(container: any): boolean;
 export declare function periodTickSuppressesFeedback(isAxisTick: boolean, ownsTimeline: boolean): boolean;
 export declare const ANIM_PLAY_SPEED_DEFAULT = 1000;
@@ -206,8 +208,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