@bicharts/chart-host 0.6.95 → 0.6.96

package/README.md

@@ -1,6 +1,11 @@
 # @bicharts/chart-host
 
-> **Make Generative AI for Charts *Better*.**
+> **Make Generative AI for Charts and Maps *Better*.**
+
+**AI Data Components, running in your page:** a bivariate map with its two-way key, a what-if projection with its
+controls inside the chart, a flow map, and about 90 everyday chart types, with selection, cross-filtering and the legend
+already wired. This package is the open-source runtime that makes them behave the same way in Power BI, Excel, Fabric
+Apps and any web page.
 
 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.
 

package/dist/adapters.mjs

@@ -3,7 +3,7 @@ import {
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-PDVEIW42.mjs";
+} from "./chunk-ASLRGGLV.mjs";
 import {
   clickWasDrag,
   collectD3GlyphCenters,
@@ -12,13 +12,13 @@ import {
   markKeyOf,
   rowIdxsFromMark,
   selectionRuleOf
-} from "./chunk-VEVBXK44.mjs";
+} from "./chunk-5OCL4EFM.mjs";
 import {
   AXIS_FILTER_CLASS,
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-45VILLJT.mjs";
+} from "./chunk-M7MBTLDP.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/adapters/types.ts

package/dist/{chunk-NNLBFIWU.mjs → chunk-3JBJ2SIF.mjs}

@@ -2,7 +2,7 @@
 import {
   CONTAINER_SLOT_SCROLL,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-45VILLJT.mjs";
+} from "./chunk-M7MBTLDP.mjs";
 
 // src/fit.ts
 var SCROLL_SLACK_PX = 8;

package/dist/{chunk-VEVBXK44.mjs → chunk-5OCL4EFM.mjs}

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

package/dist/{chunk-QHMLMF4L.mjs → chunk-6KACC7XH.mjs}

@@ -4,7 +4,7 @@ import {
   gestureWasDrag,
   isInsideControl,
   rowIdxsFromMark
-} from "./chunk-VEVBXK44.mjs";
+} from "./chunk-5OCL4EFM.mjs";
 import {
   AXIS_FILTER_CLASS,
   CONTROL_CLASS,
@@ -12,7 +12,7 @@ import {
   MARK_CLASS,
   ROW_IDX_ATTR,
   SNAPSHOT_SVG_ATTR
-} from "./chunk-45VILLJT.mjs";
+} from "./chunk-M7MBTLDP.mjs";
 
 // src/lasso.ts
 var LASSO_ROW_CAP = 5e3;
@@ -46,6 +46,10 @@ function lassoActions(setting) {
   for (const n of a) if (typeof n === "string" && n.trim() && !out.includes(n.trim())) out.push(n.trim());
   return out;
 }
+var LASSO_DEFAULT_EFFECT = "filter";
+function lassoEffect(setting) {
+  return setting?.effect === "highlight" ? "highlight" : LASSO_DEFAULT_EFFECT;
+}
 function lassoVerdict(setting, rows) {
   if (!setting || setting.capable !== true) return "not-capable";
   if (setting.enabled === false) return "disabled";
@@ -657,6 +661,8 @@ export {
   LASSO_DEFAULT_ACTIONS,
   lassoRowCap,
   lassoActions,
+  LASSO_DEFAULT_EFFECT,
+  lassoEffect,
   lassoVerdict,
   pointInShape,
   registerLassoAction,

package/dist/{chunk-PDVEIW42.mjs → chunk-ASLRGGLV.mjs}

@@ -4,7 +4,7 @@ import {
   LEGEND_MARK_CLASS,
   MARK_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-45VILLJT.mjs";
+} from "./chunk-M7MBTLDP.mjs";
 
 // src/hitTargets.ts
 var SVG_NS = "http://www.w3.org/2000/svg";

package/dist/{chunk-4ICQEVZX.mjs → chunk-JPJSWL2H.mjs}

@@ -1,12 +1,13 @@
 /*! @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_OUTLINE_CLASS,
-  installLasso
-} from "./chunk-QHMLMF4L.mjs";
+  installLasso,
+  lassoEffect
+} from "./chunk-6KACC7XH.mjs";
 import {
   censusHitBands,
   ensureCrossfilterHitTargets
-} from "./chunk-PDVEIW42.mjs";
+} from "./chunk-ASLRGGLV.mjs";
 import {
   clearPress,
   clearSelectionGlyphs,
@@ -23,14 +24,14 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-VEVBXK44.mjs";
+} from "./chunk-5OCL4EFM.mjs";
 import {
   clipWindowOf,
   fitRenderedChart,
   rememberScroll,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-NNLBFIWU.mjs";
+} from "./chunk-3JBJ2SIF.mjs";
 import {
   Fn,
   J3,
@@ -84,7 +85,7 @@ import {
   XFILTER_REFRESH_EVENT,
   chartOwnsTimeline,
   periodTickSuppressesFeedback
-} from "./chunk-45VILLJT.mjs";
+} from "./chunk-M7MBTLDP.mjs";
 
 // src/labelContrast.ts
 function parseRGBA(c) {
@@ -2084,6 +2085,7 @@ function createChartHost(container, config) {
   let warnedGeo = false;
   let warnedBlank = false;
   let warnedIds = false;
+  let warnedLassoNoFilter = false;
   const idScope = newIdScope();
   let renderSeq = 0;
   const annotationLayer = createAnnotationLayer(container, (a) => config.onAnnotationClick?.(a));
@@ -2120,6 +2122,7 @@ function createChartHost(container, config) {
   let activeTickEl = null;
   let selectionIsPeriod = false;
   let selectionFromChart = false;
+  let selectionPublished = true;
   const clickedMarks = () => container[CONTAINER_SLOT_CLICKED_MARKS] ?? null;
   const setClickedMarks = (c) => {
     try {
@@ -2444,14 +2447,16 @@ function createChartHost(container, config) {
       }
     }
   };
-  const notify = (rowIdxs, source, tick, fromChart = false) => {
+  const notify = (rowIdxs, source, tick, fromChart = false, publish = true) => {
     if (destroyed) return;
     current = rowIdxs;
     selectionFromChart = rowIdxs.length > 0 && fromChart;
+    selectionPublished = publish;
     activeTickEl = rowIdxs.length ? tick ?? null : null;
     selectionIsPeriod = rowIdxs.length > 0 && periodTickSuppressesFeedback(!!tick, chartOwnsTimeline(container));
     paintSelection();
     paintGlyphLayer();
+    if (!publish) return;
     for (const cb of subs) {
       try {
         cb(rowIdxs, source);
@@ -2459,12 +2464,33 @@ function createChartHost(container, config) {
       }
     }
   };
+  const selectFromLasso = (rows) => {
+    if (lassoEffect(resolved.lasso) === "highlight") {
+      notify(rows, "user", null, true, false);
+      return;
+    }
+    notify(rows, "user", null, true);
+    if (warnedLassoNoFilter || !rows.length) return;
+    let reaches = true;
+    try {
+      reaches = config.selectionReachesPage ? config.selectionReachesPage() !== false : subs.size > 0;
+    } catch {
+    }
+    if (reaches) return;
+    warnedLassoNoFilter = true;
+    try {
+      (win?.console ?? console)?.warn(
+        `[@bicharts/chart-host] a lasso circled ${rows.length} ${rows.length === 1 ? "row" : "rows"}, but the page gave this chart no filter to set (no \`selects\` or bindFilter, no chart group), so the lasso only highlights inside the chart and the rest of the page does not follow. To filter the page, pass selects={useBicFilter("<key column>")} to this chart and filter the other charts by that filter; for a highlight on purpose, set lasso.effect to "highlight".`
+      );
+    } catch {
+    }
+  };
   let xfAt = 0;
   const XF_ECHO_MS = 150;
   const onXf = (e) => {
     const d = e?.detail || {};
     xfAt = Date.now();
-    if (d.clear) notify([], d.source || "chart");
+    if (d.clear) notify([], d.source || "chart", void 0, false, selectionPublished || !(current && current.length));
     else if (d.mark) notify(parseRowIdxs(d.mark.getAttribute?.(ROW_IDX_ATTR)), d.source || "chart", d.mark, true);
     else if (Array.isArray(d.rows)) notify(validRowSet(d.rows), d.source || "chart", null, true);
   };
@@ -2483,7 +2509,7 @@ function createChartHost(container, config) {
         } catch {
         }
       }
-      if (current && current.length) notify([], "user");
+      if (current && current.length) notify([], "user", void 0, false, selectionPublished);
     }
   };
   let lasso = null;
@@ -2679,7 +2705,7 @@ function createChartHost(container, config) {
         container,
         options: () => resolved,
         rows: data.rows ? data.rows.length : 0,
-        select: (rows) => notify(rows, "user", null, true),
+        select: selectFromLasso,
         clearSelection: clearFromGesture
       });
     } catch {

package/dist/{chunk-CR7DSJVG.mjs → chunk-LFC5S4Z7.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-QHMLMF4L.mjs";
+} from "./chunk-6KACC7XH.mjs";
 
 // src/filterScope.ts
 function viewToken(view) {

package/dist/{chunk-45VILLJT.mjs → chunk-M7MBTLDP.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. */
 
 // src/contract.ts
-var HOST_CONTRACT_VERSION = "1.16.0";
+var HOST_CONTRACT_VERSION = "1.17.0";
 var GEO_POINT_PRECISIONS = ["latlon", "city", "zip3", "state", "country"];
 var MARK_CLASS = "d3-mark";
 var LEGEND_MARK_CLASS = "d3-legend-mark";

package/dist/{chunk-VC3Z5CH7.mjs → chunk-PMA56BKD.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 {
   SNAPSHOT_SVG_ATTR
-} from "./chunk-45VILLJT.mjs";
+} from "./chunk-M7MBTLDP.mjs";
 
 // src/snapshot.ts
 var DEFAULT_TIMEOUT_MS = 2e3;

package/dist/index.mjs

@@ -15,7 +15,7 @@ import {
   svgNaturalSize,
   svgToDataUrl,
   tableHostOf
-} from "./chunk-VC3Z5CH7.mjs";
+} from "./chunk-PMA56BKD.mjs";
 import {
   ANNOTATION_CLASS,
   ANNOTATION_LAYER_CLASS,
@@ -97,11 +97,12 @@ import {
   toRGBA,
   toSourceRows,
   valuePlacementFlag
-} from "./chunk-4ICQEVZX.mjs";
+} from "./chunk-JPJSWL2H.mjs";
 import {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
   LASSO_DEFAULT_ACTIONS,
+  LASSO_DEFAULT_EFFECT,
   LASSO_DRAG_PX,
   LASSO_EVENT,
   LASSO_KNOB_KEY,
@@ -118,17 +119,18 @@ import {
   clearLasso,
   installLasso,
   lassoActions,
+  lassoEffect,
   lassoRowCap,
   lassoVerdict,
   pointInShape,
   registerLassoAction
-} from "./chunk-QHMLMF4L.mjs";
+} from "./chunk-6KACC7XH.mjs";
 import {
   MIN_HIT_BAND_PX,
   censusHitBands,
   ensureCrossfilterHitTargets,
   hitBandFlag
-} from "./chunk-PDVEIW42.mjs";
+} from "./chunk-ASLRGGLV.mjs";
 import {
   CONTAINER_SLOT_PRESS_AT,
   DRAG_NOT_CLICK_PX,
@@ -153,7 +155,7 @@ import {
   selectionRuleOf,
   trackPress,
   validRowSet
-} from "./chunk-VEVBXK44.mjs";
+} from "./chunk-5OCL4EFM.mjs";
 import {
   AXIS_PIN_BAND_PAD_PX,
   AXIS_PIN_MAX_BAND_FRACTION,
@@ -182,7 +184,7 @@ import {
   svgInkReach,
   takeScroll,
   unpinScrolledAxis
-} from "./chunk-NNLBFIWU.mjs";
+} from "./chunk-3JBJ2SIF.mjs";
 import {
   _3,
   l,
@@ -241,7 +243,7 @@ import {
   chartOwnsTimeline,
   periodTickSuppressesFeedback,
   withoutViewOnlyKeys
-} from "./chunk-45VILLJT.mjs";
+} from "./chunk-M7MBTLDP.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/optionsVocabulary.ts
@@ -2195,6 +2197,7 @@ export {
   LASSO_AXES_SLOT,
   LASSO_COUNT_CLASS,
   LASSO_DEFAULT_ACTIONS,
+  LASSO_DEFAULT_EFFECT,
   LASSO_DRAG_PX,
   LASSO_EVENT,
   LASSO_KNOB_KEY,
@@ -2360,6 +2363,7 @@ export {
   isPillBackdropAlpha,
   labelBand,
   lassoActions,
+  lassoEffect,
   lassoRowCap,
   lassoVerdict,
   latePickupAction,

package/dist/legend-fit.mjs

@@ -2,13 +2,13 @@
 import {
   chartSvgOf,
   tableHostOf
-} from "./chunk-VC3Z5CH7.mjs";
+} from "./chunk-PMA56BKD.mjs";
 import {
   FIT_CONTENT_SELECTOR,
   ctmScaleOf,
   isPhantomBox
-} from "./chunk-NNLBFIWU.mjs";
-import "./chunk-45VILLJT.mjs";
+} from "./chunk-3JBJ2SIF.mjs";
+import "./chunk-M7MBTLDP.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/legendFit/legendReconcile.ts

package/dist/page.mjs

@@ -14,10 +14,10 @@ import {
   readControls,
   viewFromToken,
   viewToken
-} from "./chunk-CR7DSJVG.mjs";
-import "./chunk-QHMLMF4L.mjs";
-import "./chunk-VEVBXK44.mjs";
-import "./chunk-45VILLJT.mjs";
+} from "./chunk-LFC5S4Z7.mjs";
+import "./chunk-6KACC7XH.mjs";
+import "./chunk-5OCL4EFM.mjs";
+import "./chunk-M7MBTLDP.mjs";
 import "./chunk-GHODWOAL.mjs";
 export {
   LINKED_HOVER_CLASS,

package/dist/react.mjs

@@ -13,7 +13,7 @@ import {
   payloadRowReader,
   viewFromToken,
   viewToken
-} from "./chunk-CR7DSJVG.mjs";
+} from "./chunk-LFC5S4Z7.mjs";
 import {
   assembleD3,
   createChartGroup,
@@ -22,14 +22,14 @@ import {
   loadGeo,
   syncMemberSelection,
   toSourceRows
-} from "./chunk-4ICQEVZX.mjs";
-import "./chunk-QHMLMF4L.mjs";
-import "./chunk-PDVEIW42.mjs";
-import "./chunk-VEVBXK44.mjs";
-import "./chunk-NNLBFIWU.mjs";
+} from "./chunk-JPJSWL2H.mjs";
+import "./chunk-6KACC7XH.mjs";
+import "./chunk-ASLRGGLV.mjs";
+import "./chunk-5OCL4EFM.mjs";
+import "./chunk-3JBJ2SIF.mjs";
 import "./chunk-NQFJHNMC.mjs";
 import "./chunk-A2GMXZP7.mjs";
-import "./chunk-45VILLJT.mjs";
+import "./chunk-M7MBTLDP.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/react.tsx
@@ -119,6 +119,8 @@ function BicChart(props) {
     zoomRef.current = zoomMemory ?? null;
   });
   const builtWithRef = useRef(null);
+  const reachRef = useRef({ selects, group, id });
+  reachRef.current = { selects, group, id };
   const onSelectRef = useRef(onSelect);
   onSelectRef.current = onSelect;
   const onLabelContrastRef = useRef(onLabelContrast);
@@ -175,7 +177,12 @@ function BicChart(props) {
         return onInvalidSentinelRef.current ? (info) => onInvalidSentinelRef.current?.(info) : void 0;
       },
       annotations: annotationsRef.current ?? [],
-      onAnnotationClick: (a) => onAnnotationClickRef.current?.(a)
+      onAnnotationClick: (a) => onAnnotationClickRef.current?.(a),
+      // What a filtering lasso reaches: the page filter (`selects`), or the
+      // siblings of a chart that has an id in a group. This binding always
+      // subscribes to the selection (for onSelect), so the host cannot count
+      // subscribers here; an onSelect callback alone is not the page's filter.
+      selectionReachesPage: () => !!reachRef.current.selects || !!(reachRef.current.group && reachRef.current.id)
     });
     hostRef.current = host;
     builtAnnKeyRef.current = annKey;

package/dist/testing.mjs

@@ -4,7 +4,7 @@ import {
   MARK_CLASS,
   MARK_SELECTED_CLASS,
   ROW_IDX_ATTR
-} from "./chunk-45VILLJT.mjs";
+} from "./chunk-M7MBTLDP.mjs";
 import "./chunk-GHODWOAL.mjs";
 
 // src/testing/interact.ts

package/dist/types/contract.d.ts

@@ -1,4 +1,4 @@
-export declare const HOST_CONTRACT_VERSION = "1.16.0";
+export declare const HOST_CONTRACT_VERSION = "1.17.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[];
@@ -214,12 +214,17 @@ export interface RenderOptions {
      *              so. Absent is LASSO_ROW_CAP.
      *   actions  - what the host runs on release, in order, by name. Absent is ["select"]; a name the host does
      *              not know is skipped, so a list can be sent ahead of the build that understands it.
+     *   effect   - what circling a group does to the PAGE (1.17.0). "filter", the default (absent, or anything that
+     *              is not exactly "highlight"): the marks inside are published as the selection a click makes, so a
+     *              page filter bound to the chart sets every circled key and the other charts follow. "highlight":
+     *              they light inside the chart only, and nothing is published. A host's choice, never the chart's.
      */
     lasso?: {
         enabled?: boolean;
         rowCap?: number;
         actions?: string[];
         capable?: boolean;
+        effect?: "filter" | "highlight";
     };
 }
 /** One reader gesture on a chart's own control. */

package/dist/types/host.d.ts

@@ -263,6 +263,15 @@ export interface ChartHostConfig {
     annotations?: MarkAnnotation[];
     /** A badge was clicked. The mark beneath is not selected. */
     onAnnotationClick?: (annotation: MarkAnnotation) => void;
+    /**
+     * WHETHER THIS CHART'S SELECTION REACHES ANYTHING OUTSIDE IT - a page filter bound to it, a chart group that
+     * cross-filters. Read when a filtering lasso (RenderOptions.lasso.effect "filter", the default) circles a
+     * group: false makes the host say once, in the console, that the page gave the chart no filter to set, so the
+     * lasso only highlights. Absent: the selection reaches something when anything subscribes to it
+     * (selection.onChange, which bindFilter and a group's attach both use). The React binding answers it from
+     * `selects` and the group itself. Never throws through: an answer that throws counts as reached.
+     */
+    selectionReachesPage?: () => boolean;
 }
 export interface ChartHost {
     /** Replace the notes drawn on marks (see ChartHostConfig.annotations); redraws them at once. */

package/dist/types/index.d.ts

@@ -14,7 +14,7 @@ export type { Controls, ControlInfo, ControlsAttachment } from "./controls";
 export { createChartGroup, toSourceRows, syncMemberSelection, type ChartGroup, type ChartGroupMember, type ChartGroupSelection, type ChartGroupChange, type ChartGroupMemberOptions, type ChartGroupSourceOptions, type ChartGroupPayload } from "./group";
 export type { Filter, FilterScope, FilterOptions, FilterKey, FilterChangeReason, FilterBinding, BindFilterOptions, VegaInteractionEvent, PageView } from "./filterScope";
 export { createMarkResolver, isInsideControl, rowIdxsFromMark, nextSelection, DRAG_NOT_CLICK_PX, gestureWasDrag, trackPress, pressOf, clearPress, clickWasDrag, CONTAINER_SLOT_PRESS_AT, type PressPoint, dispatchRowSet, validRowSet, ROW_SET_MAX, selectionRuleOf, markKeyOf, planSelectionPaint, nextClickedMarks, sameRowSet, type SelectionRule, type ClickedMarks, type SelectionPaintMark, type SelectionPaintMode, type SelectionPaintPlan, collectD3GlyphCenters, clearSelectionGlyphs, paintSelectionGlyphs, SELECTION_GLYPH_CLASS, type MarkResolver, type MarkResolverEnv, type GlyphCenter, type SelectionGlyphStyle, type SelectionModifiers, } from "./selection";
-export { installLasso, clearLasso, lassoVerdict, lassoRowCap, lassoActions, registerLassoAction, pointInShape, LASSO_ROW_CAP, LASSO_DRAG_PX, LASSO_SAMPLE_PX, LASSO_MAX_VERTICES, LASSO_RESTORE_MAX_VERTICES, LASSO_RESTORE_MAX_SHAPES, LASSO_EVENT, LASSO_SURFACE_CLASS, LASSO_OUTLINE_CLASS, LASSO_COUNT_CLASS, LASSO_NOTE_CLASS, LASSO_PLOT_CLASS, LASSO_MODE_ATTR, LASSO_KNOB_KEY, LASSO_AXES_SLOT, LASSO_DEFAULT_ACTIONS, type LassoSetting, type LassoVerdict, type LassoMode, type LassoSpace, type LassoShape, type LassoStored, type LassoEventDetail, type LassoAxes, type LassoAction, type LassoActionContext, type LassoEnv, type LassoHandle, } from "./lasso";
+export { installLasso, clearLasso, lassoVerdict, lassoRowCap, lassoActions, lassoEffect, registerLassoAction, pointInShape, LASSO_ROW_CAP, LASSO_DRAG_PX, LASSO_SAMPLE_PX, LASSO_MAX_VERTICES, LASSO_RESTORE_MAX_VERTICES, LASSO_RESTORE_MAX_SHAPES, LASSO_EVENT, LASSO_SURFACE_CLASS, LASSO_OUTLINE_CLASS, LASSO_COUNT_CLASS, LASSO_NOTE_CLASS, LASSO_PLOT_CLASS, LASSO_MODE_ATTR, LASSO_KNOB_KEY, LASSO_AXES_SLOT, LASSO_DEFAULT_ACTIONS, LASSO_DEFAULT_EFFECT, type LassoSetting, type LassoVerdict, type LassoEffect, type LassoMode, type LassoSpace, type LassoShape, type LassoStored, type LassoEventDetail, type LassoAxes, type LassoAction, type LassoActionContext, type LassoEnv, type LassoHandle, } from "./lasso";
 export type { AdapterEvent, AdapterHit, AdapterId, AdapterScene, MarkHandle, MarkInfo, MarkRole, PaintRequest, RendererAdapter, RowTable, } from "./adapters/types";
 export { planTrivialChart, compileTrivialSource, type TrivialPlan, type TrivialShapeKind } from "./trivial";
 export { captureSvgSnapshot, svgToDataUrl, svgNaturalSize, rasterizeSvgToPngDataUrl, tableHostOf, chartSvgOf, htmlToSvgDataUrl, htmlNaturalSize, type SnapshotOptions } from "./snapshot";

package/dist/types/lasso.d.ts

@@ -49,6 +49,12 @@ export type LassoVerdict = "on" | "not-capable" | "disabled" | "over-cap";
 export declare function lassoRowCap(setting: LassoSetting | null | undefined): number;
 /** The action names to run on release, in order. Anything that is not a list of names is the default. */
 export declare function lassoActions(setting: LassoSetting | null | undefined): string[];
+/** What circling a group does to the page: "filter" publishes it as the selection, "highlight" only lights it. */
+export type LassoEffect = "filter" | "highlight";
+/** The effect when the setting names none. */
+export declare const LASSO_DEFAULT_EFFECT: LassoEffect;
+/** The effect in force: "highlight" only when the setting says exactly that, else LASSO_DEFAULT_EFFECT. */
+export declare function lassoEffect(setting: LassoSetting | null | undefined): LassoEffect;
 /** Whether a chart with `rows` rows in view gets a lasso under `setting`. */
 export declare function lassoVerdict(setting: LassoSetting | null | undefined, rows: number): LassoVerdict;
 type Pt = [number, number];
@@ -111,7 +117,8 @@ export interface LassoEnv {
     options: () => RenderOptions;
     /** How many rows the chart was handed: the number the cap is measured against. */
     rows: number;
-    /** Publish this row set as the selection (what the "select" action does). */
+    /** Make this row set the selection (what the "select" action does). The host decides, from the setting's
+     *  effect, whether it is published to the page or only lit inside the chart. */
     select(rows: number[]): void;
     /** Clear the host's selection the way an empty click does: the chart's own clear slot first when the
      *  chart owns the selection, then a published clear. A no-op when nothing is selected. */

package/package.json

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