@wick-charts/vue 0.3.4 → 0.3.6

package/README.md

@@ -2,6 +2,9 @@
 
 <!-- Generated from README.tmpl.md — edit the template, not this file. -->
 
+[![codecov](https://codecov.io/gh/mo4islona/wick-charts/branch/main/graph/badge.svg)](https://codecov.io/gh/mo4islona/wick-charts) [![license](https://img.shields.io/github/license/mo4islona/wick-charts.svg)](./LICENSE)
+[![npm @wick-charts/vue](https://img.shields.io/npm/v/@wick-charts/vue.svg?label=%40wick-charts%2Fvue)](https://www.npmjs.com/package/@wick-charts/vue)
+
 High-performance timeseries charts for **React**, **Vue**, and **Svelte**. Canvas-rendered, tree-shakeable, zero runtime dependencies.
 
 [Live Demo](https://mo4islona.github.io/wick-charts/) · [Docs](https://mo4islona.github.io/wick-charts/#/api/chart-container)

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;
@@ -1410,6 +1447,13 @@ export declare interface CrosshairPosition {
     y: number;
 }
 
+/**
+ * @deprecated Use a named preset instead — `catppuccin.theme` is the new
+ * default dark palette, and `dracula`, `nightOwl`, `oneDarkPro`, `gruvbox`,
+ * `monokaiPro`, `materialPalenight`, or `panda` cover the rest of the
+ * dark spectrum. `darkTheme` is kept as an alias for the previous default
+ * and will be removed in a future major release.
+ */
 export declare const darkTheme: ChartTheme;
 
 export declare function detectInterval(times: number[]): number;
@@ -1545,6 +1589,13 @@ declare type LegendMode = 'toggle' | 'isolate' | 'solo';
 
 export declare const lightPink: ThemePreset;
 
+/**
+ * @deprecated Use a named light preset instead — `quietLight`, `githubLight`,
+ * `solarizedLight`, `minimalLight`, `peachCream`, `sandDune`, `lightPink`,
+ * `lavenderMist`, `mintBreeze`, `rosePineDawn`, or `handwritten`. `lightTheme`
+ * is kept as an alias for the previous default and will be removed in a
+ * future major release.
+ */
 export declare const lightTheme: ChartTheme;
 
 /** @deprecated Use {@link TimePoint} instead. */