@lilt-ui/charts 0.12.0 → 0.12.1

package/dist/interaction/axis-cursor.d.ts

@@ -13,6 +13,11 @@ export interface AxisCursor {
      * with the bars that light up, for marks that snap to a column rather than glide.
      */
     columnX: MotionValue<number>;
+    /**
+     * The color of the inspected column's mark: the hovered series' bar, or a candle's direction.
+     * Empty until a column is read; it keeps the last color while the band fades out.
+     */
+    columnColor: MotionValue<string>;
     y: MotionValue<number>;
     /** 1 while this chart owns an inspection with pills on its axes, else 0. */
     active: MotionValue<number>;

package/dist/interaction/use-pin-release.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Lets go of a card's pin the way a Cartesian chart does: on any press that misses the marks,
+ * whether on empty plot, elsewhere in the card, or off it, and on Escape while the card has the
+ * keyboard (focus inside it, or the last press landed in it). Presses on controls keep the pin,
+ * so a legend item or period menu decides for itself.
+ */
+export declare function usePinRelease(root: Element | null, pinned: boolean, release: (() => void) | undefined, 
+/** Whether a press inside the plot landed on a mark. */
+onMark: (event: PointerEvent, root: Element) => boolean): void;

package/dist/interaction/use-touch-glide.d.ts

@@ -12,6 +12,10 @@ export interface TouchGlideOptions<T> {
     /** A tap with no glide. Leave unset where the item's own click already handles taps. */
     onTap?: (value: T | null) => void;
     disabled?: boolean;
+    /** Whether the card holds a pin, so Escape or a press that misses the marks lets it go. */
+    pinned?: boolean;
+    /** Releases the pin. See `usePinRelease`. */
+    onRelease?: () => void;
 }
 /** Finds the nearest `data-glide-id` under a point, for families whose marks are elements. */
 export declare function glideTarget(clientX: number, clientY: number, root: Element): string | null;

package/dist/marks/contract.d.ts

@@ -33,6 +33,11 @@ export interface MarkSpec<P> {
     loading?: (props: P) => LoadingMark;
     /** Draws one observation emphasized, over the dimmed marks, while it is inspected. */
     highlight?: (props: P, input: MarkHighlightInput) => ReactNode;
+    /**
+     * The color one observation is drawn in, when the mark decides it (rising and falling
+     * candles). Otherwise the series' `colorAt`, then its color.
+     */
+    color?: (props: P, input: Omit<MarkHighlightInput, 'color'>) => string | undefined;
 }
 export interface MarkHighlightInput {
     row: NormalizedRow<unknown>;
@@ -47,6 +52,7 @@ export interface PlotMark {
     fields: readonly string[];
     loading?: LoadingMark;
     highlight?: (input: MarkHighlightInput) => ReactNode;
+    color?: (input: Omit<MarkHighlightInput, 'color'>) => string | undefined;
 }
 export declare function defineMark<P>(component: (props: P) => ReactElement, spec: MarkSpec<P>): (props: P) => ReactElement;
 /** Marks placed directly in a plot, or inside fragments there, in document order. */

package/dist/primitives/hover-band.d.ts

@@ -2,6 +2,7 @@ import { ReactElement } from 'react';
 /**
  * Behind a bar or column chart, the inspected column is lit as a whole: a soft band the height of
  * the plot, a little wider than its bars. A column is what a reader inspects on a bar chart, so
- * the band says so where a thin crosshair would not.
+ * the band says so where a thin crosshair would not. It takes the color of the column it holds,
+ * so a falling candle is lit in red and a rising one in green.
  */
 export declare function HoverBand(): ReactElement | null;