@bicharts/chart-host 0.6.83 → 0.6.84

package/dist/types/selection.d.ts

@@ -3,6 +3,20 @@
  * numbers. A token that is not one names no row and is skipped; no attribute, no rows.
  */
 export declare function rowIdxsFromMark(el: Element | null): number[];
+/** The most rows one published set may name: the largest window any host hands a chart. A set past it
+ *  is cut there rather than refused, because the cap bounds the work an event can ask for and a table
+ *  never holds a row beyond it. */
+export declare const ROW_SET_MAX = 250000;
+/** The rows a published set names: whole non-negative numbers only, each once, in the order given, at
+ *  most ROW_SET_MAX. Anything else in the array is dropped, and a value that is not an array names none. */
+export declare function validRowSet(rows: unknown): number[];
+/**
+ * Publish a selection as a row set: fires the cross-filter event on `container`, carrying `rows` (valid
+ * ones only) and the `source` the host passes on to its subscribers. An empty set is a clear. For a
+ * chart that computes its own selection; a chart that selects by marks needs nothing, the host reads
+ * data-row-idx itself.
+ */
+export declare function dispatchRowSet(container: Element, rows: readonly number[], source?: string): void;
 /** The keys held during a click. Cmd counts as Ctrl. */
 export interface SelectionModifiers {
     ctrl?: boolean;
@@ -89,6 +103,43 @@ export declare function nextClickedMarks(prev: ClickedMarks | null | undefined,
  * 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;
+/** Movement between press and release, in px on either axis, at which a gesture is a drag. */
+export declare const DRAG_NOT_CLICK_PX = 5;
+/** A pointer position in client px. */
+export interface PressPoint {
+    x: number;
+    y: number;
+}
+/** True when the pointer travelled far enough between press and release to be a drag. */
+export declare function gestureWasDrag(down: PressPoint | null | undefined, up: PressPoint, thresholdPx?: number): boolean;
+/** Where the press is parked: on the CONTAINER, so every reader (the host's click handler, a renderer
+ *  adapter, the visual's bridge) reads the one record. */
+export declare const CONTAINER_SLOT_PRESS_AT = "__lchPressAt";
+/** The recorded press on `container`, or null when there is none. */
+export declare function pressOf(container: Element | null | undefined): PressPoint | null;
+/** Forget the recorded press: the click it led to has been read. */
+export declare function clearPress(container: Element | null | undefined): void;
+/**
+ * Record where the pointer goes down on `container`, in the CAPTURE phase so a renderer that stops
+ * propagation on its own handlers still leaves its origin, and whether it then travels 5px or more
+ * before it comes up. The travel is what makes a drag that ends where it began (a lasso closed on its
+ * own start, a brush returned to its origin) still a drag: the click it leaves has moved nowhere.
+ * Returns the function that stops all of it.
+ */
+export declare function trackPress(container: HTMLElement): () => void;
+/**
+ * True when `click` ended a press whose pointer travelled DRAG_NOT_CLICK_PX or more, on the way or by where
+ * the click landed. Reads the press, never writes it.
+ *
+ * A click a pointer made carries detail >= 1. A keyboard or scripted click carries detail 0 and no
+ * pointer position, so it is compared with nothing: the press on record may be one that never produced a
+ * click (released outside the chart), and a stale press must not turn a later keyboard click into a drag.
+ */
+export declare function clickWasDrag(container: Element | null | undefined, click: {
+    clientX?: number;
+    clientY?: number;
+    detail?: number;
+} | null | undefined): boolean;
 export interface MarkResolverEnv {
     root: HTMLElement;
     doc: Document;

package/package.json

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