@bicharts/chart-host 0.5.119 → 0.5.121

package/dist/{chunk-7ELYQSF5.mjs → chunk-7RLI3VOM.mjs}

@@ -435,7 +435,7 @@ var require_papaparse_min = __commonJS({
 });
 
 // src/contract.ts
-var HOST_CONTRACT_VERSION = "1.10.0";
+var HOST_CONTRACT_VERSION = "1.11.0";
 var GEO_POINT_PRECISIONS = ["latlon", "city", "zip3", "state", "country"];
 var MARK_CLASS = "d3-mark";
 var LEGEND_MARK_CLASS = "d3-legend-mark";
@@ -447,6 +447,14 @@ var CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
 var CONTAINER_SLOT_XF_CLEAR = "__llmXfClear";
 var CONTAINER_SLOT_INITIAL_XF_MARK = "__llmInitialXfMark";
 var CONTAINER_SLOT_UI_STATE = "__lchUiState";
+var VIEW_ONLY_UI_STATE_KEYS = Object.freeze(["camera", "llmZoom"]);
+function withoutViewOnlyKeys(bag) {
+  if (!bag || typeof bag !== "object") return bag;
+  if (!VIEW_ONLY_UI_STATE_KEYS.some((k3) => Object.prototype.hasOwnProperty.call(bag, k3))) return bag;
+  const out = { ...bag };
+  for (const k3 of VIEW_ONLY_UI_STATE_KEYS) delete out[k3];
+  return out;
+}
 var HOST_CONTAINER_CLASS = "bic-chart-host";
 var SELECTION_ACTIVE_CLASS = "lch-has-selection";
 var MARK_SELECTED_CLASS = "lch-mark-selected";
@@ -839,7 +847,7 @@ function resolveOptions(p2) {
     allowTooltips: p2.allowTooltips,
     noDataText: p2.noDataText,
     onSelect: p2.onSelect,
-    // Item 639. Passed straight through like onSelect: the host owns what a gesture MEANS,
+    // Control gestures (1.10.0). Passed straight through like onSelect: the host owns what a gesture MEANS,
     // and a host that supplies nothing leaves every control behaving exactly as before.
     onControlChange: p2.onControlChange,
     // ---- live-restyle knobs: `raw || undefined` / `.toString() || undefined` ----
@@ -1443,7 +1451,7 @@ function Wt(n, s) {
   return { iso: i, unmatched: M2, matchedRows: h3, totalRows: n.length };
 }
 
-// ../shape-core/dist/chunk-NY26PXWD.mjs
+// ../shape-core/dist/chunk-TDTXRIHS.mjs
 var import_papaparse = __toESM(require_papaparse_min(), 1);
 /*! @bicharts/shape-core — Apache-2.0. Bundled reference data: GeoNames (https://www.geonames.org/) CC BY 4.0; US Census/TIGER (public domain). Full text: NOTICE in this package. */
 var Se = { "north-america": "AG AI AW BB BL BM BQ BS BZ CA CR CU CW DM DO GD GL GP GT HN HT JM KN KY LC MF MQ MS MX NI PA PM PR SV SX TC TT US VC VG VI", "south-america": "AR BO BR CL CO EC FK GF GY PE PY SR UY VE", europe: "AD AL AT AX BA BE BG BY CH CY CZ DE DK EE ES FI FO FR GB GG GI GR HR HU IE IM IS IT JE LI LT LU LV MC MD ME MK MT NL NO PL PT RO RS RU SE SI SJ SK SM UA VA", africa: "AO BF BI BJ BW CD CF CG CI CM CV DJ DZ EG EH ER ET GA GH GM GN GQ GW KE KM LR LS LY MA MG ML MR MU MW MZ NA NE NG RE RW SC SD SH SL SN SO SS ST SZ TD TG TN TZ UG YT ZA ZM ZW", asia: "AE AF AM AZ BD BH BN BT CC CN CX GE HK ID IL IN IO IQ IR JO JP KG KH KP KR KW KZ LA LB LK MM MN MO MV MY NP OM PH PK PS QA SA SG SY TH TJ TL TM TR TW UZ VN YE", oceania: "AS AU CK FJ FM GU KI MH MP NC NF NR NU NZ PF PG PN PW SB TK TO TV UM VU WF WS", antarctica: "AQ BV GS HM TF" };
@@ -1537,10 +1545,10 @@ function Le(n) {
       return ["sum", "average", "median", "min", "max", "count", "distinctcount", "first"];
   }
 }
-function Xt(n) {
+function Qt(n) {
   return Le(n)[0];
 }
-function qt(n, e) {
+function Jt(n, e) {
   if (e !== "sum" && e !== "count") return false;
   if (e === "count") return true;
   let t = Oe(n);
@@ -3319,9 +3327,15 @@ var D3_PLUGIN_PACKAGES = {
 };
 function requiredD3Plugins(code) {
   const out = /* @__PURE__ */ new Set();
-  for (const m2 of stripJsComments(String(code || "")).matchAll(/\bd3\s*\.\s*(\w+)\s*[.(]/g)) {
-    const pkg = D3_PLUGIN_PACKAGES[m2[1]];
+  const body = stripJsComments(String(code || ""));
+  const add = (name) => {
+    const pkg = D3_PLUGIN_PACKAGES[name];
     if (pkg) out.add(pkg);
+  };
+  for (const m2 of body.matchAll(/\bd3\s*\.\s*(\w+)/g)) add(m2[1]);
+  for (const m2 of body.matchAll(/\bd3\s*\[\s*['"](\w+)['"]\s*\]/g)) add(m2[1]);
+  for (const m2 of body.matchAll(/\{([^{}]*)\}\s*=\s*d3\b/g)) {
+    for (const part of m2[1].split(",")) add(part.split(":")[0].trim());
   }
   return [...out].sort();
 }
@@ -3804,6 +3818,8 @@ export {
   CONTAINER_SLOT_XF_CLEAR,
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
+  VIEW_ONLY_UI_STATE_KEYS,
+  withoutViewOnlyKeys,
   HOST_CONTAINER_CLASS,
   SELECTION_ACTIVE_CLASS,
   MARK_SELECTED_CLASS,
@@ -3852,8 +3868,8 @@ export {
   a2 as a,
   Oe,
   Le,
-  Xt,
-  qt,
+  Qt,
+  Jt,
   buildRenderPayload,
   stripJsComments,
   createMarkResolver,

package/dist/index.mjs

@@ -36,6 +36,7 @@ import {
   GLYPH_SAMPLE_N,
   HOST_CONTAINER_CLASS,
   HOST_CONTRACT_VERSION,
+  Jt,
   L3,
   LABEL_CONTRAST_CAP,
   LABEL_CONTRAST_DONE_ATTR,
@@ -57,6 +58,7 @@ import {
   PILL_MIN_ALPHA,
   PILL_MIN_COVERAGE,
   PILL_OPAQUE_ALPHA,
+  Qt,
   ROW_IDX_ATTR,
   SAME_SHADE_DELTA_E,
   SCROLL_SLACK_PX,
@@ -64,9 +66,9 @@ import {
   SELECTION_ACTIVE_CLASS,
   VALUE_AXIS_BASELINE_DEFAULT,
   VALUE_AXIS_MIN_FIT,
+  VIEW_ONLY_UI_STATE_KEYS,
   WHITE_TEXT_BG_LUM,
   XFILTER_REFRESH_EVENT,
-  Xt,
   a,
   applyLabelContrast,
   autoRampCanvas,
@@ -116,7 +118,6 @@ import {
   pinScrolledAxis,
   planAxisPin,
   planFrameGrow,
-  qt,
   registerGeo,
   registerGeoAsset,
   relativeLuminance,
@@ -130,8 +131,9 @@ import {
   svgInkReach,
   toRGBA,
   unpinScrolledAxis,
-  valuePlacementFlag
-} from "./chunk-7ELYQSF5.mjs";
+  valuePlacementFlag,
+  withoutViewOnlyKeys
+} from "./chunk-7RLI3VOM.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -1392,6 +1394,11 @@ function aggLabel(agg) {
       return "Sum";
   }
 }
+function measureLineLabel(agg, name2) {
+  const col = String(name2 ?? "");
+  const prefix = aggLabel(agg) + " of ";
+  return col.trim().toLowerCase().startsWith(prefix.toLowerCase()) ? col.trim() : prefix + col;
+}
 function isSynthetic(name2) {
   return String(name2 ?? "").startsWith(SYNTHETIC_PREFIX);
 }
@@ -1423,7 +1430,7 @@ function isSuppressed(col) {
 }
 function resolveAgg(col, requested, auto) {
   const fallback = () => {
-    const d2 = Xt(col);
+    const d2 = Qt(col);
     return d2 === "first" ? "count" : d2;
   };
   if (auto) return fallback();
@@ -1530,7 +1537,7 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
     }
     const value = reduce(selVals, colAgg, selRaw);
     let sharePct = null;
-    if (qt(col, colAgg) && value != null) {
+    if (Jt(col, colAgg) && value != null) {
       const allVals = [];
       const allRaw = [];
       for (let r2 = 0; r2 < rows.length; r2++) {
@@ -1543,7 +1550,7 @@ function computeSelectionCard(payload, selectedRowIdxs, opts = {}) {
     }
     lines.push({
       column: String(col?.name ?? ""),
-      label: `${aggLabel(colAgg)} of ${col?.name ?? ""}`,
+      label: measureLineLabel(colAgg, String(col?.name ?? "")),
       value,
       valueText: value == null ? "\u2014" : fmtNumber(value, opts.cultureCode),
       sharePct,
@@ -2455,6 +2462,7 @@ export {
   TRANSPORT_LOST_CHECKING_MESSAGE,
   VALUE_AXIS_BASELINE_DEFAULT,
   VALUE_AXIS_MIN_FIT,
+  VIEW_ONLY_UI_STATE_KEYS,
   WHITE_TEXT_BG_LUM,
   XFILTER_REFRESH_EVENT,
   actionFor,
@@ -2593,5 +2601,6 @@ export {
   transportFailureShouldRecover,
   unpinScrolledAxis,
   valuePlacementFlag,
-  vegaSpecReadsDatesInLocalTime
+  vegaSpecReadsDatesInLocalTime,
+  withoutViewOnlyKeys
 };

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-7ELYQSF5.mjs";
+} from "./chunk-7RLI3VOM.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/types/contract.d.ts

@@ -1,4 +1,4 @@
-export declare const HOST_CONTRACT_VERSION = "1.10.0";
+export declare const HOST_CONTRACT_VERSION = "1.11.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[];
@@ -17,6 +17,10 @@ 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";
 export declare const CONTAINER_SLOT_UI_STATE = "__lchUiState";
+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
+ *  for their view to be remembered. Returns the SAME object when there was nothing to remove. */
+export declare function withoutViewOnlyKeys<T extends Record<string, unknown>>(bag: T): T;
 /**
  * WHERE A CHART'S RESTING VIEW-STATE LIVES between draws (contract 1.6.0).
  *

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, 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, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, } 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, VIEW_ONLY_UI_STATE_KEYS, withoutViewOnlyKeys, 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, ANIMATION_OPTION_KEYS, COLOR_SCALE_SELF_CLAMP_PCT_DEFAULT, COLOR_SCALE_SELF_CLAMP_PCT_MIN, COLOR_SCALE_SELF_CLAMP_PCT_MAX, FLIP_MODE_DEFAULT, APPROXIMATE_POSITIONS_DEFAULT, VALUE_AXIS_BASELINE_DEFAULT, SEASONAL_MARKERS_DEFAULT, MAX_MAP_POINTS_DEFAULT, type GeoPointPrecision, type GeoMapKind, type TimelineStyle, type FlipMode, type ApproximatePositions, type ValueAxisBaseline, type SeasonalMarkers, type ColorScaleScope, type RenderOptions, type ViewStateProvider, type ChartControlChange, } 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/dist/types/selectionCard.d.ts

@@ -84,6 +84,13 @@ type Agg = "sum" | "average" | "min" | "max" | "count" | "median" | "distinctcou
  *  spellings fall back to sum rather than throwing: a card is a courtesy, and refusing to draw
  *  one because a host wrote "Total" is a worse outcome than summing. */
 export declare function normaliseAggregation(raw: string | undefined | null): Agg;
+/** THE LINE'S LABEL: "<aggregation> of <column>", unless the column's name already says it.
+ *  An Excel table copied from a pivot, or a Power BI implicit measure, arrives with a column
+ *  named "Sum of Orders"; composing onto that printed "Sum of Sum of Orders" (dev, Excel add-in
+ *  1.0.0.47, a click on the order-fulfilment chart). Only the SAME aggregation's words are
+ *  dropped: "Average of Sum of Orders" is a true statement - it averages per-row sums - and
+ *  stays composed. */
+export declare function measureLineLabel(agg: Agg, name: string): string;
 /**
  * The card for a selection, or NULL when there is nothing to say.
  *

package/package.json

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