@bicharts/chart-host 0.6.1 → 0.6.2

package/README.md

@@ -2,16 +2,15 @@
 
 > **Make Generative AI for Charts *Better*.**
 
-That is what **RegiaBI** is for; this package is the part that runs the result in your page,
-so a generated chart behaves the same wherever it lands.
+Describe the chart you want, or just hand over the data, and RegiaBI gives you back a working, interactive chart that fits your data on the first try — as source code you own. It goes into your repo and runs in the framework you already use: React, a plain web page, or whatever your coding agent is scaffolding. At run time there's no key, no call to us and nothing to pay per render: `@bicharts/chart-host`, the open-source runtime, makes the chart behave in your page — clicks, cross-filtering, selection — so that's code you don't have to write. You start from something that already works and spend your time on the last ten percent, in plain language or in the code itself; reading the code is an advantage, never the price of entry. And because the engine knows what each chart type can honestly say, it'll sometimes show you a view of your data you hadn't thought to ask for.
 
-Run a D3 chart generated by
-[Business Intelligence Champions](https://bizintelligencechampions.com) (BIC) in any web page.
+**[Live demo](https://codexguy.github.io/bicharts-react-demo/)** ·
+[RegiaBI for developers](https://bizintelligencechampions.com/regiabi/developers?loc=npmhost)
 
-A BIC chart is *generated source you own* — a plain `render(container, data, options)` function
-you commit to your repo. There is no API key at run time, no per-render cost, and no network
-call. This package is the host side: the ~80 lines every integrator would otherwise write, and
-the handful they would get subtly wrong.
+This package is the runtime: it makes the chart you were handed behave in your page. A
+generated chart is a plain `render(container, data, options)` function you commit to your repo,
+and this is the host side — the ~80 lines every integrator would otherwise write, and the
+handful they would get subtly wrong.
 
 It is the same contract the BIC Power BI visual implements, minus Power BI — so a chart looks
 and behaves the same wherever it runs.

package/dist/{chunk-RO6O22YG.mjs → chunk-HC2IREJL.mjs}

@@ -435,12 +435,13 @@ var require_papaparse_min = __commonJS({
 });
 
 // src/contract.ts
-var HOST_CONTRACT_VERSION = "1.11.0";
+var HOST_CONTRACT_VERSION = "1.12.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 CONTROL_CLASS = "lch-control";
 var ROW_IDX_ATTR = "data-row-idx";
 var XFILTER_REFRESH_EVENT = "llm-xfilter-refresh";
 var CONTAINER_SLOT_ANIM_STOP = "__llmAnimStop";
@@ -1992,6 +1993,15 @@ function stripJsComments(code) {
 }
 
 // src/selection.ts
+function isInsideControl(target, container) {
+  let el = target;
+  if (el && el.nodeType !== 1) el = el.parentElement ?? el.parentNode ?? null;
+  while (el && el !== container) {
+    if (el.nodeType === 1 && el.classList?.contains?.(CONTROL_CLASS)) return true;
+    el = el.parentElement ?? el.parentNode ?? null;
+  }
+  return false;
+}
 function createMarkResolver(env) {
   const { root, doc, log } = env;
   const isElement = (t) => {
@@ -3555,6 +3565,7 @@ function createChartHost(container, config) {
   const clickSel = `.${MARK_CLASS}[${ROW_IDX_ATTR}], .${LEGEND_MARK_CLASS}[${ROW_IDX_ATTR}], .${AXIS_FILTER_CLASS}[${ROW_IDX_ATTR}]`;
   const onClick = (e) => {
     if (Date.now() - xfAt < XF_ECHO_MS) return;
+    if (isInsideControl(e?.target, container)) return;
     let el = resolver.findMark(e?.target, clickSel, e);
     if (!el) el = resolver.penetrateOverlayAt(e?.clientX, e?.clientY, clickSel);
     if (!el) el = resolver.resolveByGeometry(e?.clientX, e?.clientY, clickSel);
@@ -3812,6 +3823,7 @@ export {
   LEGEND_MARK_CLASS,
   AXIS_FILTER_CLASS,
   LIFT_SELECTED_CLASS,
+  CONTROL_CLASS,
   ROW_IDX_ATTR,
   XFILTER_REFRESH_EVENT,
   CONTAINER_SLOT_ANIM_STOP,
@@ -3872,6 +3884,7 @@ export {
   Jt,
   buildRenderPayload,
   stripJsComments,
+  isInsideControl,
   createMarkResolver,
   ensureCrossfilterHitTargets,
   censusMarks,

package/dist/index.mjs

@@ -27,6 +27,7 @@ import {
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
+  CONTROL_CLASS,
   DARK_TEXT,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
@@ -105,6 +106,7 @@ import {
   invalidSentinelReason,
   isBlankRender,
   isHorizontalLabelRow,
+  isInsideControl,
   isInvalidSentinelError,
   isPhantomBox,
   isPillBackdropAlpha,
@@ -133,7 +135,7 @@ import {
   unpinScrolledAxis,
   valuePlacementFlag,
   withoutViewOnlyKeys
-} from "./chunk-RO6O22YG.mjs";
+} from "./chunk-HC2IREJL.mjs";
 import "./chunk-A2GMXZP7.mjs";
 import "./chunk-GHODWOAL.mjs";
 
@@ -2438,6 +2440,7 @@ export {
   CONTAINER_SLOT_INITIAL_XF_MARK,
   CONTAINER_SLOT_UI_STATE,
   CONTAINER_SLOT_XF_CLEAR,
+  CONTROL_CLASS,
   DARK_TEXT,
   DIM_OPACITY_DEFAULT,
   DIM_OPACITY_VAR,
@@ -2556,6 +2559,7 @@ export {
   isBlindMarker,
   isExcelDateFormat,
   isHorizontalLabelRow,
+  isInsideControl,
   isInvalidSentinelError,
   isPhantomBox,
   isPillBackdropAlpha,

package/dist/react.mjs

@@ -4,7 +4,7 @@ import {
   createChartHost,
   geoFromCache,
   loadGeo
-} from "./chunk-RO6O22YG.mjs";
+} from "./chunk-HC2IREJL.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.11.0";
+export declare const HOST_CONTRACT_VERSION = "1.12.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[];
@@ -11,6 +11,7 @@ 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 CONTROL_CLASS = "lch-control";
 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, 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 { HOST_CONTRACT_VERSION, GEO_POINT_PRECISIONS, MARK_CLASS, LEGEND_MARK_CLASS, AXIS_FILTER_CLASS, ROW_IDX_ATTR, LIFT_SELECTED_CLASS, CONTROL_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
@@ -7,7 +7,7 @@ export declare function registerCityTable(packed: string): void;
 export { buildRenderPayload, type RenderPayload, type GeoPointBinding } from "./payload";
 export { codeReadsDatesInLocalTime, vegaSpecReadsDatesInLocalTime } from "./dateCells";
 export { createChartHost, compileRenderFn, stripEsmExports, requiredD3Plugins, explainRenderFailure, sessionViewStateProvider, noopViewStateProvider, type ChartHost, type ChartHostConfig, type RenderFn } from "./host";
-export { createMarkResolver, type MarkResolver, type MarkResolverEnv } from "./selection";
+export { createMarkResolver, isInsideControl, type MarkResolver, type MarkResolverEnv } from "./selection";
 export { planTrivialChart, compileTrivialSource, type TrivialPlan, type TrivialShapeKind } from "./trivial";
 export { captureSvgSnapshot, svgToDataUrl, svgNaturalSize, rasterizeSvgToPngDataUrl, type SnapshotOptions } from "./snapshot";
 export { shouldReview, buildReviewWire, bareBase64, actionFor, type ReviewGate, type ReviewWire, type ReviewVerdict, type ReviewAction } from "./review";

package/dist/types/selection.d.ts

@@ -1,3 +1,10 @@
+/**
+ * True when a click's target sits inside a reader-operated control the chart drew (CONTROL_CLASS
+ * on the target or an ancestor), looking no further out than `container` - a page that wraps the
+ * whole chart in the class does not make every click a control click. A text node is read through
+ * its parent. A click inside a control is neither a selection nor a click on empty canvas.
+ */
+export declare function isInsideControl(target: EventTarget | Node | null | undefined, container: Element): boolean;
 export interface MarkResolverEnv {
     root: HTMLElement;
     doc: Document;

package/package.json

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