@wick-charts/vue 0.3.5 → 0.3.6

package/dist/index.d.ts

@@ -183,6 +183,13 @@ declare type __VLS_Props_3 = {
      * later changes are ignored.
      */
     perf?: PerfOption;
+    /**
+     * Fired after the user releases a pan/zoom gesture that pulled the viewport
+     * past a data edge by more than ~10% of the visible range. Hosts typically
+     * respond by prefetching more history. Captured at mount only; changing
+     * the prop identity later is ignored.
+     */
+    onEdgeReached?: (info: EdgeReachedInfo) => void;
 };
 
 declare type __VLS_Props_4 = {
@@ -939,6 +946,36 @@ export declare class ChartInstance extends EventEmitter<ChartEvents> {
     setVisibleRange(range: VisibleRange | number): void;
     getYRange(): YRange;
     getCrosshairPosition(): CrosshairPosition | null;
+    /**
+     * Programmatically set or clear the crosshair. Same effect as the user
+     * hovering over `(timeToX(time), valueToY(y))` — emits `crosshairMove`,
+     * marks the overlay layer dirty, and lets `<Crosshair>` / `<Tooltip>`
+     * react via their normal store subscriptions.
+     *
+     * Pass `null` to clear (mirrors the pointer-leave path).
+     *
+     * `y` is optional. Resolution order when omitted:
+     *   1. **current crosshair's y** — preserves whatever the chart already
+     *      has (real cursor y, or a previously-synthesised value). This is
+     *      what makes the cross-chart broadcast pattern work: when an echo
+     *      arrives at the chart that originated the hover, the existing y
+     *      stays in place and the idempotency check below short-circuits the
+     *      loop. Without preservation, the echo would overwrite the source's
+     *      real cursor y with the midpoint default and the tooltip would
+     *      jitter between cursor and midpoint every mouse-move.
+     *   2. **midpoint of the current Y range** — fallback when there is no
+     *      current crosshair (first programmatic set on a chart that hasn't
+     *      been hovered yet).
+     *
+     * Idempotent: a call that produces the same `(time, y)` pair as the
+     * current crosshair is a no-op (no emit). Combined with the y-preservation
+     * above, this lets N charts broadcast their hover to each other without
+     * a feedback-loop guard.
+     */
+    setCrosshair(pos: {
+        time: number;
+        y?: number;
+    } | null): void;
     /** Get the last visible value and whether the absolute last point is on screen. */
     getLastValue(seriesId: string): {
         value: number;