@bicharts/chart-host 0.6.115 → 0.6.116

package/dist/{chunk-GXR7T6G5.mjs → chunk-QG5TENI3.mjs}

@@ -22,6 +22,7 @@ var CONTAINER_SLOT_XF_CLEAR = "__llmXfClear";
 var CONTAINER_SLOT_INITIAL_XF_MARK = "__llmInitialXfMark";
 var CONTAINER_SLOT_UI_STATE = "__lchUiState";
 var CONTAINER_SLOT_SCROLL = "__lchScroll";
+var TABLE_SCROLLER_CLASS = "lch-table-body";
 var CONTAINER_SLOT_CLICKED_MARKS = "__lchClickedMarks";
 var VIEW_ONLY_UI_STATE_KEYS = Object.freeze(["camera", "llmZoom"]);
 function withoutViewOnlyKeys(bag) {
@@ -39,6 +40,7 @@ var ACTIVE_TICK_CLASS = "lch-tick-active";
 var DIM_OPACITY_VAR = "--lch-dim-opacity";
 var DIM_OPACITY_DEFAULT = 0.25;
 var DIM_OPACITY_MIN = 0.01;
+var CATEGORY_DELTA_E_FLOOR = 25;
 function chartOwnsTimeline(container) {
   return !!container && (!!container[CONTAINER_SLOT_XF_CLEAR] || !!container[CONTAINER_SLOT_ANIM_STOP]);
 }
@@ -96,6 +98,7 @@ export {
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_SCROLL,
+  TABLE_SCROLLER_CLASS,
   CONTAINER_SLOT_CLICKED_MARKS,
   VIEW_ONLY_UI_STATE_KEYS,
   withoutViewOnlyKeys,
@@ -107,6 +110,7 @@ export {
   DIM_OPACITY_VAR,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_MIN,
+  CATEGORY_DELTA_E_FLOOR,
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   ANIM_PLAY_SPEED_DEFAULT,

package/dist/{chunk-PQKLWYKK.mjs → chunk-RLOIA7QK.mjs}

@@ -8,7 +8,7 @@ import {
   SELECTION_RULE_ATTR,
   SELECTION_RULE_CLICKED_MARKS,
   XFILTER_REFRESH_EVENT
-} from "./chunk-GXR7T6G5.mjs";
+} from "./chunk-QG5TENI3.mjs";
 
 // src/selection.ts
 function rowIdxsFromMark(el) {

package/dist/{chunk-CVTCR7HQ.mjs → chunk-TUZCM7SX.mjs}

@@ -4,7 +4,7 @@ import {
   gestureWasDrag,
   isInsideControl,
   rowIdxsFromMark
-} from "./chunk-PQKLWYKK.mjs";
+} from "./chunk-RLOIA7QK.mjs";
 import {
   AXIS_FILTER_CLASS,
   CONTROL_CLASS,
@@ -12,7 +12,7 @@ import {
   MARK_CLASS,
   ROW_IDX_ATTR,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-GXR7T6G5.mjs";
+} from "./chunk-QG5TENI3.mjs";
 
 // src/lasso.ts
 var LASSO_ROW_CAP = 5e3;

package/dist/{chunk-DILJDN6C.mjs → chunk-VGJH63LZ.mjs}

@@ -1,7 +1,7 @@
 /*! @bicharts/chart-host — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; Natural Earth and US Census/TIGER (public domain). Full text: NOTICE in this package. */
 import {
   LASSO_KNOB_KEY
-} from "./chunk-CVTCR7HQ.mjs";
+} from "./chunk-TUZCM7SX.mjs";
 
 // src/controls.ts
 var isKnob = (key) => key !== LASSO_KNOB_KEY;

package/dist/{chunk-2GW3S5VD.mjs → chunk-ZZBX5ZJ6.mjs}

@@ -245,6 +245,14 @@ function createFilterScope() {
     for (const cb of Array.from(subs)) cb(scope);
   };
   const groups = /* @__PURE__ */ new Map();
+  const names = /* @__PURE__ */ new Map();
+  const nameFor = (f) => {
+    const taken = new Set(names.values());
+    let k = f.key, n = 1;
+    while (taken.has(k)) k = `${f.key}-${++n}`;
+    names.set(f, k);
+  };
+  const nameOf = (f) => names.get(f) ?? f.key;
   const join = (f) => {
     const name = f.group;
     if (!name) return;
@@ -288,6 +296,7 @@ function createFilterScope() {
     add(f) {
       if (!offs.has(f)) {
         list.push(f);
+        nameFor(f);
         offs.set(f, f.onChange(() => notify()));
         join(f);
         notify();
@@ -299,6 +308,7 @@ function createFilterScope() {
         offs.delete(f);
         const i = list.indexOf(f);
         if (i >= 0) list.splice(i, 1);
+        names.delete(f);
         leave(f);
         notify();
       };
@@ -312,6 +322,9 @@ function createFilterScope() {
         subs.delete(cb);
       };
     },
+    keyOf(f) {
+      return offs.has(f) ? nameOf(f) : null;
+    },
     get controls() {
       return ctl;
     },
@@ -333,7 +346,7 @@ function createFilterScope() {
     },
     save() {
       const view = { v: 1 };
-      for (const f of list) if (f.active) (view.filters ??= {})[f.key] = f.keys.map((k) => k.slice());
+      for (const f of list) if (f.active) (view.filters ??= {})[nameOf(f)] = f.keys.map((k) => k.slice());
       for (const [k, c] of ctl) {
         const values = c.values;
         if (Object.keys(values).length) (view.controls ??= {})[k] = { ...values };
@@ -344,7 +357,7 @@ function createFilterScope() {
       if (!view || view.v !== 1) return;
       const restored = /* @__PURE__ */ new Set();
       for (const f of list) {
-        const keys = view.filters?.[f.key];
+        const keys = view.filters?.[nameOf(f)];
         const g = f.group && peersOf.get(f) ? f.group : null;
         if (g && restored.has(g)) continue;
         if (keys && keys.length) {

package/dist/dax.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 {
   isAnyValue
-} from "./chunk-2GW3S5VD.mjs";
+} from "./chunk-ZZBX5ZJ6.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/dax.ts
@@ -64,9 +64,31 @@ ${tail}`.replace(/\n$/, "");
 function isFilter(x) {
   return !!x && typeof x === "object" && Array.isArray(x.keys) && typeof x.has === "function";
 }
+var HEADER = /^(?:'(?:[^']|'')*'|[^[\]']*)\[((?:[^\]]|\]\])+)\]$/;
+function columnName(header) {
+  const m = HEADER.exec(String(header ?? "").trim());
+  return m ? m[1].replace(/\]\]/g, "]") : String(header ?? "");
+}
+function queryRows(result) {
+  const table = result && "columns" in result ? result : result && "table" in result ? result.table : void 0;
+  if (!table || !Array.isArray(table.columns) || !Array.isArray(table.rows)) return [];
+  const bare = table.columns.map((c) => columnName(c?.name ?? ""));
+  const count = /* @__PURE__ */ new Map();
+  for (const b of bare) count.set(b, (count.get(b) ?? 0) + 1);
+  const names = bare.map((b, i) => (count.get(b) ?? 0) > 1 ? String(table.columns[i]?.name ?? b) : b);
+  return table.rows.map((r) => {
+    const o = {};
+    names.forEach((n, k) => {
+      o[n] = r?.[k];
+    });
+    return o;
+  });
+}
 export {
   calculateTable,
+  columnName,
   daxLiteral,
   filterQuery,
+  queryRows,
   treatAs
 };

package/dist/index.mjs

@@ -5,7 +5,7 @@ import {
   formatSourceDateFor,
   isExcelDateFormat,
   normaliseAggregation
-} from "./chunk-YSRMSDRP.mjs";
+} from "./chunk-JMLSNV5Q.mjs";
 import {
   captureSvgSnapshot,
   chartSvgOf,
@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-QLIRQJ6B.mjs";
+} from "./chunk-IW6BKFF5.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -38,7 +38,6 @@ import {
   MAP_SELECTION_MARKER_DEFAULT,
   MARK_MOVE_ATTRIBUTES,
   MIN_CONTRAST,
-  MIN_RAMP_FILLS,
   NEUTRAL_CENTRE_RAMP_SELECTOR,
   PAGE_MATCH_TOLERANCE,
   PILL_MIN_ALPHA,
@@ -47,7 +46,6 @@ import {
   REGION_JOIN_COLUMN,
   ROW_GROWTH_MIN_EXTRA,
   ROW_GROWTH_MIN_RATIO,
-  SAME_SHADE_DELTA_E,
   SELECTION_MARKER_DEFAULT,
   SELECTION_OUTLINE_CLASS,
   STRADDLE_COLS,
@@ -71,7 +69,6 @@ import {
   bytesToBase64,
   cellSuppressesNormalize,
   censusClippedText,
-  censusColourSpread,
   censusMarks,
   censusValuePlacement,
   cleanFilterScope,
@@ -79,7 +76,6 @@ import {
   clippedTextFlag,
   codeHasKeyboardStamp,
   collectOutlineMarks,
-  colourSpreadFlag,
   compileRenderFn,
   compositeOver,
   contrastRatio,
@@ -87,7 +83,6 @@ import {
   createChartGroup,
   createChartHost,
   decideLabelColor,
-  deltaEHex,
   excelNumberFormat,
   excelSerial,
   explainRenderFailure,
@@ -136,7 +131,7 @@ import {
   toSourceRows,
   trackFocus,
   valuePlacementFlag
-} from "./chunk-7K3F3RZ6.mjs";
+} from "./chunk-GZSYTDFN.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
@@ -163,13 +158,13 @@ import {
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-CVTCR7HQ.mjs";
+} from "./chunk-TUZCM7SX.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-YOCYWON4.mjs";
+} from "./chunk-EFKGSDFF.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -194,7 +189,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-PQKLWYKK.mjs";
+} from "./chunk-RLOIA7QK.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -219,11 +214,12 @@ import {
   planFrameGrow,
   planScrollRestore,
   rememberScroll,
+  restoreInnerScroll,
   scrollFitFor,
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-AQO4ROMU.mjs";
+} from "./chunk-63IUMWY2.mjs";
 import {
   clearGeoCache,
   geoAssetFor,
@@ -231,12 +227,19 @@ import {
   loadGeo,
   registerGeo,
   registerGeoAsset
-} from "./chunk-5YSZABCS.mjs";
+} from "./chunk-LXTW6YII.mjs";
 import {
   Ot,
   l,
   o
-} from "./chunk-VPFP35XI.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,
@@ -251,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,
@@ -287,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-GXR7T6G5.mjs";
+} from "./chunk-QG5TENI3.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/hostLinks.ts
@@ -1389,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,
@@ -1398,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)
   }));
 }
 
@@ -2355,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,
@@ -2461,6 +2504,7 @@ 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,
@@ -2485,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,
@@ -2660,6 +2705,7 @@ export {
   qualifyFilterCountText,
   qualifyFilterGate,
   qualifyGroupHeadingFor,
+  qualifyKindBadgeStyle,
   qualifyPick,
   qualifyRefusalHeadingFor,
   qualifyRefusalReason,
@@ -2692,6 +2738,7 @@ export {
   resolveAutoColorScale,
   resolveOptions,
   restoreFocus,
+  restoreInnerScroll,
   rowGrowthNotice,
   rowIdxsFromMark,
   rowNameOf,

package/dist/legend-fit.mjs

@@ -2,13 +2,13 @@
 import {
   chartSvgOf,
   tableHostOf
-} from "./chunk-QLIRQJ6B.mjs";
+} from "./chunk-IW6BKFF5.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-AQO4ROMU.mjs";
-import "./chunk-GXR7T6G5.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-DILJDN6C.mjs";
-import "./chunk-CVTCR7HQ.mjs";
-import "./chunk-PQKLWYKK.mjs";
-import "./chunk-GXR7T6G5.mjs";
+} from "./chunk-VGJH63LZ.mjs";
+import "./chunk-TUZCM7SX.mjs";
+import "./chunk-RLOIA7QK.mjs";
+import "./chunk-QG5TENI3.mjs";
 import {
   ANY_VALUE,
   LINKED_HOVER_CLASS,
@@ -23,7 +23,7 @@ import {
   scopeFilterOf,
   viewFromToken,
   viewToken
-} from "./chunk-2GW3S5VD.mjs";
+} from "./chunk-ZZBX5ZJ6.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   ANY_VALUE,

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-VPFP35XI.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-DILJDN6C.mjs";
+} from "./chunk-VGJH63LZ.mjs";
 import {
   assembleD3,
   createChartGroup,
   createChartHost,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-7K3F3RZ6.mjs";
-import "./chunk-CVTCR7HQ.mjs";
-import "./chunk-YOCYWON4.mjs";
-import "./chunk-PQKLWYKK.mjs";
-import "./chunk-AQO4ROMU.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-VPFP35XI.mjs";
+} from "./chunk-LXTW6YII.mjs";
+import "./chunk-K2TH7D5V.mjs";
+import "./chunk-JTZTTJJK.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-GXR7T6G5.mjs";
+import "./chunk-QG5TENI3.mjs";
 import {
   ANY_VALUE,
   LINKED_HOVER_CLASS,
@@ -37,7 +38,7 @@ import {
   scopeFilterOf,
   viewFromToken,
   viewToken
-} from "./chunk-2GW3S5VD.mjs";
+} from "./chunk-ZZBX5ZJ6.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx
@@ -413,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-GXR7T6G5.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

@@ -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;

package/dist/types/dax.d.ts

@@ -20,3 +20,29 @@ export declare function calculateTable(table: string, ...filters: Array<string |
  *   filterQuery(FORECAST_DAX, treatAs(region, "Geography[RegionCode]"))
  */
 export declare function filterQuery(query: string, ...filters: Array<string | null | undefined | false>): string;
+/** A DAX query's result as the semantic-model query hooks return it: headers, then rows of values in header order. */
+export interface QueryTable {
+    columns: readonly {
+        name: string;
+    }[];
+    rows: readonly (readonly unknown[])[];
+}
+/**
+ * A result header's bare name: "Accounts[Account Number]" and "'Sales Owners'[Owner]" give the column's name,
+ * "[Total Revenue]" the measure's; a header that isn't a reference comes back as it is.
+ */
+export declare function columnName(header: string): string;
+/**
+ * A QUERY'S ROWS BY COLUMN NAME, for a query that feeds no chart: a form's choice list, a lookup, a count beside a
+ * chart. A DAX result names its columns "Table[Column]" and its measures "[Measure]"; each row comes back as an object
+ * keyed by the bare name, so `row["Account Number"]` reads Accounts[Account Number]. Two headers with one bare name
+ * (Accounts[Name] beside Owners[Name]) keep their whole headers, so neither hides the other. Takes the table or the
+ * query hook's `data` (a failed or pending result gives no rows):
+ *
+ *   const owners = queryRows(useSemanticModelQuery({ connection, query: OWNERS_DAX }).data);
+ *   owners.map(r => r["Sales owner"])
+ */
+export declare function queryRows(result: QueryTable | {
+    status?: string;
+    table?: QueryTable;
+} | null | undefined): Record<string, unknown>[];