@bicharts/chart-host 0.5.114 → 0.5.116

package/dist/{chunk-IXJYGTAY.mjs → chunk-W5XDW6OK.mjs}

@@ -435,7 +435,7 @@ var require_papaparse_min = __commonJS({
 });
 
 // src/contract.ts
-var HOST_CONTRACT_VERSION = "1.9.0";
+var HOST_CONTRACT_VERSION = "1.10.0";
 var GEO_POINT_PRECISIONS = ["latlon", "city", "zip3", "state", "country"];
 var MARK_CLASS = "d3-mark";
 var LEGEND_MARK_CLASS = "d3-legend-mark";
@@ -839,6 +839,9 @@ 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,
+    // and a host that supplies nothing leaves every control behaving exactly as before.
+    onControlChange: p2.onControlChange,
     // ---- live-restyle knobs: `raw || undefined` / `.toString() || undefined` ----
     colorScaleLow: p2.colorScaleLow || void 0,
     colorScaleHigh: p2.colorScaleHigh || void 0,

package/dist/index.mjs

@@ -130,7 +130,7 @@ import {
   toRGBA,
   unpinScrolledAxis,
   valuePlacementFlag
-} from "./chunk-IXJYGTAY.mjs";
+} from "./chunk-W5XDW6OK.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-IXJYGTAY.mjs";
+} from "./chunk-W5XDW6OK.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.9.0";
+export declare const HOST_CONTRACT_VERSION = "1.10.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[];
@@ -141,4 +141,33 @@ export interface RenderOptions {
     flipMode?: FlipMode;
     cardBackgroundColor?: string;
     onSelect?: (rowIdxs: number[]) => void;
+    /**
+     * A reader WORKED one of the chart's own controls — the segmented row today, the slider and
+     * the scrubber when they follow. ADVISORY TELEMETRY: the host logs it, and nothing about the
+     * chart depends on a host supplying it.
+     *
+     * Until now no host could tell a control that fired from a control that does nothing. One
+     * host left an INDIRECT trace, because working a control persists view-state and that write
+     * is logged there; another host's write was silent, so a reader reporting "the buttons do
+     * nothing" left no record anywhere. Establishing that a control had in fact fired meant
+     * pulling the generated source out of storage and reading it by hand.
+     *
+     * CLICKS ONLY, and there is deliberately no `phase`. A control also settles on a value at
+     * first paint, on every resize and on every re-render; reporting those would bury the
+     * gestures under repaints, and the restored value is already in the persisted view-state, so
+     * nothing is lost by leaving it out. This field reports what a PERSON did.
+     *
+     * NEVER FATAL. It is called from inside a click handler, so a host that throws here must not
+     * take the reader's gesture with it: the helper swallows anything this raises.
+     */
+    onControlChange?: (e: ChartControlChange) => void;
+}
+/** One reader gesture on a chart's own control. */
+export interface ChartControlChange {
+    /** The helper family that owns the control — "segmented" today. */
+    control: string;
+    /** The control's name inside the chart: "sort", "form", "measure". */
+    key: string;
+    /** The value the reader chose. */
+    value: string;
 }

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, } 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, 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/package.json

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