@bicharts/chart-host 0.5.51 → 0.5.53

package/README.md

@@ -185,8 +185,17 @@ visual — override them if you want a different look:
 ```css
 .bic-chart-host { --lch-dim-opacity: 0.25; }
 .bic-chart-host.lch-has-selection .d3-mark:not(.lch-mark-selected) { opacity: var(--lch-dim-opacity); }
+.bic-chart-host.lch-has-selection .d3-lift-selected .d3-mark.lch-mark-selected { opacity: 1; stroke-opacity: 1; fill-opacity: 1; }
 ```
 
+The second rule is opt-in. The affordance is dim-only — a selected mark is merely *exempt* from
+the dim and keeps whatever paint the chart gave it — so a chart that rests its marks below full
+opacity by design (a parallel-coordinates plot drawing every line at 0.38 so overplotting reads)
+would show its selected lines at 38%, which the eye reads as dimmed. Such a chart stamps
+`d3-lift-selected` on the group holding those marks, and inside that group a selected mark is
+painted at full opacity. Undeclared charts are unchanged, so alpha used as an encoding (a depth
+cue, a hierarchy level) is never flattened by a fix meant for another chart.
+
 ## Architecture — three layers, and why it matters if you contribute
 
 Read this before adding code. The package has **three** concerns, and they are independent.

package/dist/{chunk-B4RZSFAC.mjs → chunk-COSG4M73.mjs}

@@ -6,11 +6,12 @@ import {
 } from "./chunk-A2GMXZP7.mjs";
 
 // src/contract.ts
-var HOST_CONTRACT_VERSION = "1.6.0";
+var HOST_CONTRACT_VERSION = "1.7.0";
 var GEO_POINT_PRECISIONS = ["latlon", "city", "zip3", "state", "country"];
 var MARK_CLASS = "d3-mark";
 var LEGEND_MARK_CLASS = "d3-legend-mark";
 var AXIS_FILTER_CLASS = "d3-axis-filter";
+var LIFT_SELECTED_CLASS = "d3-lift-selected";
 var ROW_IDX_ATTR = "data-row-idx";
 var XFILTER_REFRESH_EVENT = "llm-xfilter-refresh";
 var CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
@@ -593,38 +594,38 @@ var Y2 = ["pct", "percent", "percentage", "rate", "ratio", "rating", "share", "s
 var J2 = ["latitude", "longitude"];
 var Q2 = ["latitude", "longitude"];
 var tt = /^\s*(sum|count|count\s+distinct|distinct\s+count)\s+of\s+/i;
-var qt = /(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Za-z])(?=[0-9])|(?<=[0-9])(?=[A-Za-z])/g;
-var jt = new RegExp("\\b(" + X2.join("|") + ")\\b|(" + Y2.join("|") + ")$", "i");
-var Wt = new RegExp("\\b(" + J2.join("|") + ")\\b|(" + Q2.join("|") + ")$", "i");
+var jt = /(?<=[a-z0-9])(?=[A-Z])|(?<=[A-Za-z])(?=[0-9])|(?<=[0-9])(?=[A-Za-z])/g;
+var Wt = new RegExp("\\b(" + X2.join("|") + ")\\b|(" + Y2.join("|") + ")$", "i");
+var Xt = new RegExp("\\b(" + J2.join("|") + ")\\b|(" + Q2.join("|") + ")$", "i");
 function L2(e) {
   return e ? String(e).replace(tt, "").trim() : "";
 }
 function et(e) {
   return !!e && tt.test(String(e));
 }
-function Xt(e) {
+function Yt(e) {
   let t = L2(e);
-  return t.length === 0 ? "" : t.replace(qt, " ");
+  return t.length === 0 ? "" : t.replace(jt, " ");
 }
 function nt(e, t) {
-  return t ? e.test(Xt(t)) || e.test(L2(t)) : false;
+  return t ? e.test(Yt(t)) || e.test(L2(t)) : false;
 }
 function z2(e) {
-  return nt(Wt, e);
+  return nt(Xt, e);
 }
 function it(e) {
-  return nt(jt, e) || z2(e);
+  return nt(Wt, e) || z2(e);
 }
 var ot = /int|double|decimal|single|float|number|currency|money/i;
-function Yt(e) {
+function Jt(e) {
   let t = String(e?.valueNature ?? "").trim().toLowerCase();
   return t === "categorical" ? "Categorical" : t === "ordinal" ? "Ordinal" : t === "continuous" || e?.isMeasure === true || ot.test(String(e?.dataType ?? "")) ? "Continuous" : "Categorical";
 }
-function Jt(e) {
+function Qt(e) {
   return e?.isMeasure === true || ot.test(String(e?.dataType ?? ""));
 }
 function G2(e) {
-  let t = e ?? {}, i = Yt(t);
+  let t = e ?? {}, i = Jt(t);
   if (i !== "Continuous") return { nature: i, additivity: "unknown", basis: "role", suppressed: false };
   if (z2(t.name)) return { nature: i, additivity: "positional", basis: "name", suppressed: true };
   let s = String(t.additivity ?? "").trim().toLowerCase();
@@ -635,10 +636,10 @@ function G2(e) {
   }
   return t.discourageAggregationAcrossGroups === true ? { nature: i, additivity: "intensive_rate", basis: "host-flag", suppressed: false } : it(t.name) ? { nature: i, additivity: "intensive_rate", basis: "name", suppressed: false } : { nature: i, additivity: "additive", basis: "default", suppressed: false };
 }
-function F2(e) {
+function D2(e) {
   let t = G2(e), i = e ?? {};
   if (t.nature === "Categorical") return ["first", "distinctcount", "count"];
-  if (t.nature === "Ordinal") return Jt(i) ? ["median", "average", "min", "max", "first", "distinctcount", "count"] : ["first", "distinctcount", "count"];
+  if (t.nature === "Ordinal") return Qt(i) ? ["median", "average", "min", "max", "first", "distinctcount", "count"] : ["first", "distinctcount", "count"];
   switch (t.additivity) {
     case "positional":
       return ["min", "max", "count", "distinctcount", "first"];
@@ -648,16 +649,16 @@ function F2(e) {
       return ["sum", "average", "median", "min", "max", "count", "distinctcount", "first"];
   }
 }
-function Qt(e) {
-  return F2(e)[0];
+function te(e) {
+  return D2(e)[0];
 }
-function ee(e, t) {
+function ne(e, t) {
   if (t !== "sum" && t !== "count") return false;
   if (t === "count") return true;
   let i = G2(e);
   return i.additivity === "additive" || i.additivity === "part_of_whole" || i.additivity === "unknown";
 }
-var $2 = 2;
+var F2 = 2;
 var at = 400;
 function K2(e) {
   return !!E(e);
@@ -715,24 +716,24 @@ function H2(e) {
 function st(e, t) {
   return p(t, en) ? true : V2(e).some((i) => /^\d{5}(-\d{4})?$/.test(i.replace(/\.0+$/, "")));
 }
-function ne(e, t) {
+function ie(e, t) {
   let i = v2(e);
   if (i.length === 0) return 0;
   let s = 0;
   for (let u2 of i) p3(u2, t) && s++;
   return Math.round(s / i.length * 1e3) / 10;
 }
-function D2(e, t) {
+function $2(e, t) {
   let i = 0;
   for (let s of v2(e)) t(s) && i++;
   return i;
 }
-function ie(e, t) {
+function oe(e, t) {
   let i = 0;
   for (let s of V2(e)) t(s) && i++;
   return i;
 }
-function oe(e, t, i, s, u2) {
+function re(e, t, i, s, u2) {
   let x2 = [], c = [], o = {}, R = {}, N2 = new Set(e), l = (n) => t.map((r) => r[n]);
   for (let n of ["city", "country"]) {
     let r = i?.[n];
@@ -761,15 +762,15 @@ function oe(e, t, i, s, u2) {
       if (h2(a2)) continue;
       let d = I2(a2);
       if (d < 95) continue;
-      let E2 = D2(a2, (b2) => !!Y(b2)), ct = D2(a2, (b2) => !!Y(b2) && !rt(b2, s));
-      E2 < $2 && ct < 1 || (!n || d > n.pct) && (n = { name: r, pct: d });
+      let E2 = $2(a2, (b2) => !!Y(b2)), ct = $2(a2, (b2) => !!Y(b2) && !rt(b2, s));
+      E2 < F2 && ct < 1 || (!n || d > n.pct) && (n = { name: r, pct: d });
     }
     n && (o.state = n.name, m2.add(n.name), x2.push(`state=${n.name} (${n.pct}% states/provinces)`));
   }
   if (!o.zip) for (let n of C) {
     if (m2.has(n)) continue;
     let r = l(n), a2 = H2(r);
-    if (!(a2 < 95) && st(r, n) && !(ie(r, (d) => Z(d).length > 0) < $2)) {
+    if (!(a2 < 95) && st(r, n) && !(oe(r, (d) => Z(d).length > 0) < F2)) {
       o.zip = n, m2.add(n), x2.push(`zip=${n} (${a2}% ZIP codes)`);
       break;
     }
@@ -788,8 +789,8 @@ function oe(e, t, i, s, u2) {
     let n = null;
     for (let r of C) {
       if (m2.has(r)) continue;
-      let a2 = l(r), d = ne(a2, s);
-      d < m3 || D2(a2, (E2) => p3(E2, s)) < $2 || (!n || d > n.pct) && (n = { name: r, pct: d });
+      let a2 = l(r), d = ie(a2, s);
+      d < m3 || $2(a2, (E2) => p3(E2, s)) < F2 || (!n || d > n.pct) && (n = { name: r, pct: d });
     }
     n && (o.city = n.name, x2.push(`city=${n.name} (${n.pct}% known cities)`));
   }
@@ -812,7 +813,7 @@ function resolvePointChannel(cols, rowObjs, point) {
   let labelCol;
   if (bind) {
     const dims = cols.filter((c) => !c.isMeasure).map((c) => c.name);
-    const res = oe(dims, rowObjs, bind, point?.mapKind, cols.map((c) => c.name));
+    const res = re(dims, rowObjs, bind, point?.mapKind, cols.map((c) => c.name));
     bind = res.bind;
     rolesBackfilled = res.backfilled;
     rolesRefused = res.refused;
@@ -1353,6 +1354,17 @@ function createChartHost(container, config) {
 .${HOST_CONTAINER_CLASS}.${SELECTION_ACTIVE_CLASS} .${MARK_CLASS}:not(.${MARK_SELECTED_CLASS}):not([${ROW_IDX_ATTR}=""]) {
     opacity: var(${DIM_OPACITY_VAR}, ${DIM_OPACITY_DEFAULT}) !important;
 }
+/* THE LIFT, BY DECLARATION ONLY. Dimming the others is all the rule above does; a selected
+   mark keeps whatever paint its chart gave it. A chart that draws every mark pale on purpose
+   (a parallel-coordinates plot at 0.38 so overplotting reads) therefore shows its SELECTED
+   lines at 38% - the same eye-reading as dimmed. Inside a group the chart stamps
+   ${LIFT_SELECTED_CLASS} on, a selected mark is painted at full opacity. Opacity only, never
+   stroke geometry. Undeclared charts are byte-identical, which is what keeps an alpha
+   ENCODING (a depth cue, a hierarchy level) from being flattened by a fix meant for one. */
+.${HOST_CONTAINER_CLASS}.${SELECTION_ACTIVE_CLASS} .${LIFT_SELECTED_CLASS} .${MARK_CLASS}.${MARK_SELECTED_CLASS},
+.${HOST_CONTAINER_CLASS}.${SELECTION_ACTIVE_CLASS} .${MARK_CLASS}.${LIFT_SELECTED_CLASS}.${MARK_SELECTED_CLASS} {
+    opacity: 1 !important; stroke-opacity: 1 !important; fill-opacity: 1 !important;
+}
 .${HOST_CONTAINER_CLASS} .${LEGEND_MARK_CLASS} { cursor: pointer; }
 /* An axis/group header that filters when clicked LOOKS like inert text, and until it is
    marked there is no way to tell a landed filter from a dead label \u2014 the report reads
@@ -1566,6 +1578,7 @@ export {
   MARK_CLASS,
   LEGEND_MARK_CLASS,
   AXIS_FILTER_CLASS,
+  LIFT_SELECTED_CLASS,
   ROW_IDX_ATTR,
   XFILTER_REFRESH_EVENT,
   CONTAINER_SLOT_ANIM_STOP,
@@ -1601,9 +1614,9 @@ export {
   clearGeoCache,
   L3,
   G2 as G,
-  F2 as F,
-  Qt,
-  ee,
+  D2 as D,
+  te,
+  ne,
   buildRenderPayload,
   createMarkResolver,
   ensureCrossfilterHitTargets,

package/dist/index.mjs

@@ -17,9 +17,9 @@ import {
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
+  D,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
-  F,
   FLIP_MODE_DEFAULT,
   G,
   GEO_POINT_PRECISIONS,
@@ -27,9 +27,9 @@ import {
   HOST_CONTRACT_VERSION,
   L3,
   LEGEND_MARK_CLASS,
+  LIFT_SELECTED_CLASS,
   MARK_CLASS,
   MARK_SELECTED_CLASS,
-  Qt,
   ROW_IDX_ATTR,
   SELECTION_ACTIVE_CLASS,
   XFILTER_REFRESH_EVENT,
@@ -41,13 +41,13 @@ import {
   compileRenderFn,
   createChartHost,
   createMarkResolver,
-  ee,
   ensureCrossfilterHitTargets,
   explainRenderFailure,
   geoAssetFor,
   geoFromCache,
   isBlankRender,
   loadGeo,
+  ne,
   noopViewStateProvider,
   periodTickSuppressesFeedback,
   registerGeo,
@@ -55,8 +55,9 @@ import {
   requiredD3Plugins,
   resolveOptions,
   sessionViewStateProvider,
-  stripEsmExports
-} from "./chunk-B4RZSFAC.mjs";
+  stripEsmExports,
+  te
+} from "./chunk-COSG4M73.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/trivial.ts
@@ -693,11 +694,11 @@ function isSuppressed(col) {
 }
 function resolveAgg(col, requested, auto) {
   const fallback = () => {
-    const d = Qt(col);
+    const d = te(col);
     return d === "first" ? "count" : d;
   };
   if (auto) return fallback();
-  return F(col).indexOf(requested) >= 0 ? requested : fallback();
+  return D(col).indexOf(requested) >= 0 ? requested : fallback();
 }
 function toNumber(v) {
   if (v == null || v === "") return null;
@@ -801,7 +802,7 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
     }
     const value = reduce(selVals, colAgg, selRaw);
     let sharePct = null;
-    if (ee(col, colAgg) && value != null) {
+    if (ne(col, colAgg) && value != null) {
       const allVals = [];
       const allRaw = [];
       for (let r = 0; r < rows.length; r++) {
@@ -891,6 +892,7 @@ export {
   HOST_CONTAINER_CLASS,
   HOST_CONTRACT_VERSION,
   LEGEND_MARK_CLASS,
+  LIFT_SELECTED_CLASS,
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   ROW_IDX_ATTR,

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-B4RZSFAC.mjs";
+} from "./chunk-COSG4M73.mjs";
 import "./chunk-A2GMXZP7.mjs";
 
 // src/react.tsx

package/dist/types/contract.d.ts

@@ -1,4 +1,4 @@
-export declare const HOST_CONTRACT_VERSION = "1.6.0";
+export declare const HOST_CONTRACT_VERSION = "1.7.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[];
@@ -10,6 +10,7 @@ export type GeoMapKind = "north-america" | "world";
 export declare const MARK_CLASS = "d3-mark";
 export declare const LEGEND_MARK_CLASS = "d3-legend-mark";
 export declare const AXIS_FILTER_CLASS = "d3-axis-filter";
+export declare const LIFT_SELECTED_CLASS = "d3-lift-selected";
 export declare const ROW_IDX_ATTR = "data-row-idx";
 export declare const XFILTER_REFRESH_EVENT = "llm-xfilter-refresh";
 export declare const CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, 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, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type ColorScaleScope, type RenderOptions, type ViewStateProvider, } from "./contract";
+export { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, XFILTER_REFRESH_EVENT, CONTAINER_SLOT_ANIM_STOP, CONTAINER_SLOT_XF_CLEAR, CONTAINER_SLOT_INITIAL_XF_MARK, CONTAINER_SLOT_UI_STATE, HOST_CONTAINER_CLASS, SELECTION_ACTIVE_CLASS, MARK_SELECTED_CLASS, ACTIVE_TICK_CLASS, DIM_OPACITY_VAR, DIM_OPACITY_DEFAULT, 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, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type ColorScaleScope, type RenderOptions, type ViewStateProvider, } from "./contract";
 export { resolveOptions, type ResolveOptionsInput } from "./defaults";
 export { loadGeo, geoFromCache, registerGeo, registerGeoAsset, geoAssetFor, clearGeoCache, type GeoAssetName, } from "./geoLazy";
 /** REPLACE the bundled city gazetteer with another packed table. Rarely needed — see the

package/package.json

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