@liiift-studio/sanity-visitor-insights 0.67.0 → 0.69.0

package/dist/index.d.mts

@@ -275,6 +275,21 @@ interface FunnelStage {
     value: number;
     /** Share of the previous shown step, or null when it could not be computed. */
     conversionFromPrevious: number | null;
+    /**
+     * Set when this step was only instrumented part-way through the window.
+     *
+     * The count is real but it covers fewer days than the rungs around it, so any ratio drawn
+     * across the two is arithmetic over mismatched windows. `JourneyPanel` used to drop the
+     * metric's `partial` status on the way in, so a `view_item` that began firing on 1 September
+     * was drawn identically to a full-month `page_view` and captioned "33.9% of landed" — a
+     * thirteen-day numerator over a thirty-one-day denominator, stated to a decimal place.
+     *
+     * Everywhere else a partial metric carries a badge and a note; this was the one render site
+     * that stripped it, and it is the most quoted number on the tab.
+     */
+    partial?: {
+        from: string;
+    };
 }
 /** Props for FunnelChart. */
 interface FunnelChartProps {
@@ -433,6 +448,20 @@ interface SeriesPoint {
 }
 /** How a value should be written out. */
 type SeriesUnit = 'count' | 'money' | 'percent';
+/**
+ * The floating readout, anchored to the hovered day.
+ *
+ * Sits over the plot rather than under it. The values used to live in a row beneath the chart, so
+ * reading a peak meant looking at the peak, then travelling to the bottom of the component, then
+ * back — and on a tall stack of small multiples the two were far enough apart that the reader lost
+ * which day they were on. Anchored to the crosshair, the number is where the eye already is.
+ *
+ * `pointer-events: none` throughout: the card follows the pointer across the plot and must never
+ * become the thing under it, which would end the hover it exists to describe and flicker.
+ *
+ * It flips to the left of the crosshair in the right-hand third, so the last week of a range — the
+ * part a reader looks at most — does not push the card off the pane.
+ */
 interface Series {
     key: string;
     label: string;

package/dist/index.d.ts

@@ -275,6 +275,21 @@ interface FunnelStage {
     value: number;
     /** Share of the previous shown step, or null when it could not be computed. */
     conversionFromPrevious: number | null;
+    /**
+     * Set when this step was only instrumented part-way through the window.
+     *
+     * The count is real but it covers fewer days than the rungs around it, so any ratio drawn
+     * across the two is arithmetic over mismatched windows. `JourneyPanel` used to drop the
+     * metric's `partial` status on the way in, so a `view_item` that began firing on 1 September
+     * was drawn identically to a full-month `page_view` and captioned "33.9% of landed" — a
+     * thirteen-day numerator over a thirty-one-day denominator, stated to a decimal place.
+     *
+     * Everywhere else a partial metric carries a badge and a note; this was the one render site
+     * that stripped it, and it is the most quoted number on the tab.
+     */
+    partial?: {
+        from: string;
+    };
 }
 /** Props for FunnelChart. */
 interface FunnelChartProps {
@@ -433,6 +448,20 @@ interface SeriesPoint {
 }
 /** How a value should be written out. */
 type SeriesUnit = 'count' | 'money' | 'percent';
+/**
+ * The floating readout, anchored to the hovered day.
+ *
+ * Sits over the plot rather than under it. The values used to live in a row beneath the chart, so
+ * reading a peak meant looking at the peak, then travelling to the bottom of the component, then
+ * back — and on a tall stack of small multiples the two were far enough apart that the reader lost
+ * which day they were on. Anchored to the crosshair, the number is where the eye already is.
+ *
+ * `pointer-events: none` throughout: the card follows the pointer across the plot and must never
+ * become the thing under it, which would end the hover it exists to describe and flicker.
+ *
+ * It flips to the left of the crosshair in the right-hand third, so the last week of a range — the
+ * part a reader looks at most — does not push the card off the pane.
+ */
 interface Series {
     key: string;
     label: string;