@liiift-studio/sanity-visitor-insights 0.17.0 → 0.19.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as sanity from 'sanity';
 import React from 'react';
-import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-B_OrmcdP.mjs';
-export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DailyPoint, j as DateRange, k as DiagnosticCheck, E as EmailCampaign, l as EventCutover, m as JourneyOutcome, n as JourneyStep, L as LandingPage, o as LicenceTierRow, P as PREEXISTING, p as REPORT_NAMES, q as ReportError, S as SiteAnalyticsConfig, r as SourceName, s as SourceRow, t as SourceStatus, u as TimelineEvent, v as TypefaceInterestRow, U as UnavailableReason, w as coverageForRange, x as estimated, y as isReportName, z as ok, B as partial, F as previousRange, G as resolveRange, H as unavailable, I as validateSiteConfig, K as valueOrNull } from './ranges-B_OrmcdP.mjs';
+import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-BUZuS1c-.mjs';
+export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DailyPoint, j as DateRange, k as DiagnosticCheck, E as EmailCampaign, l as EventCutover, m as JourneyOutcome, n as JourneyStep, L as LandingPage, o as LicenceTierRow, P as PREEXISTING, p as REPORT_NAMES, q as ReportError, S as SiteAnalyticsConfig, r as SourceName, s as SourceRow, t as SourceStatus, u as TimelineEvent, v as TypefaceInterestRow, U as UnavailableReason, w as coverageForRange, x as estimated, y as isReportName, z as ok, B as partial, F as previousRange, G as resolveRange, H as unavailable, I as validateSiteConfig, K as valueOrNull } from './ranges-BUZuS1c-.mjs';
 
 /**
  * The Visitor Insights Studio tool.
@@ -342,24 +342,37 @@ interface SeriesPoint {
 }
 /** How a value should be written out. */
 type SeriesUnit = 'count' | 'money' | 'percent';
-/** One row of the chart. */
+/**
+ * One row of the chart: one answer, with what a lossier source saw underneath it.
+ *
+ * A row shows a SINGLE line by default. Two peer lines make the reader reconcile before they get
+ * an answer, and at a glance a foundry owner wants "how much", not "here are two measurements that
+ * disagree". The disagreement is still drawn — as a filled region, and in full on hover — because
+ * hiding it entirely would switch off the alarm: the 24 August collapse was visible precisely
+ * because two lines came apart.
+ */
 interface Series {
     key: string;
     label: string;
-    /** Which upstream this came from, shown so the reader can weigh it. */
+    /** Which upstream the LINE came from. */
     source: 'GA4' | 'Vercel' | 'Sanity' | 'Mailchimp';
-    /**
-     * Whether the source sees everything. GA4 does not; the others do.
-     * Drives the dashed stroke and the uncertainty band rather than a footnote nobody reads.
-     */
+    /** Whether the line's source sees everything. Drives the stroke and the wording. */
     complete: boolean;
     unit: SeriesUnit;
     points: SeriesPoint[];
     /**
-     * Multiplier from observed to estimated-true, for a lossy series. 1 means no correction known.
-     * Drawn as a band above the line, never as a replacement for it — the measured line stays.
+     * What a lossier source saw of the same thing.
+     *
+     * Drawn as a filled region between the two, NOT as a symmetric uncertainty band. There is no
+     * doubt about the traffic here: Vercel counted it server-side. What is uncertain is how much of
+     * it the analytics could see, and the honest way to draw that is the area it missed — a
+     * quantity, visible to scale, rather than a percentage on another tab.
      */
-    grossUpFactor?: number;
+    shortfall?: {
+        label: string;
+        source: Series['source'];
+        points: SeriesPoint[];
+    };
 }
 /** A dated event drawn through every row, e.g. a campaign send. */
 interface TimelineMarker {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as sanity from 'sanity';
 import React from 'react';
-import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-B_OrmcdP.js';
-export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DailyPoint, j as DateRange, k as DiagnosticCheck, E as EmailCampaign, l as EventCutover, m as JourneyOutcome, n as JourneyStep, L as LandingPage, o as LicenceTierRow, P as PREEXISTING, p as REPORT_NAMES, q as ReportError, S as SiteAnalyticsConfig, r as SourceName, s as SourceRow, t as SourceStatus, u as TimelineEvent, v as TypefaceInterestRow, U as UnavailableReason, w as coverageForRange, x as estimated, y as isReportName, z as ok, B as partial, F as previousRange, G as resolveRange, H as unavailable, I as validateSiteConfig, K as valueOrNull } from './ranges-B_OrmcdP.js';
+import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-BUZuS1c-.js';
+export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DailyPoint, j as DateRange, k as DiagnosticCheck, E as EmailCampaign, l as EventCutover, m as JourneyOutcome, n as JourneyStep, L as LandingPage, o as LicenceTierRow, P as PREEXISTING, p as REPORT_NAMES, q as ReportError, S as SiteAnalyticsConfig, r as SourceName, s as SourceRow, t as SourceStatus, u as TimelineEvent, v as TypefaceInterestRow, U as UnavailableReason, w as coverageForRange, x as estimated, y as isReportName, z as ok, B as partial, F as previousRange, G as resolveRange, H as unavailable, I as validateSiteConfig, K as valueOrNull } from './ranges-BUZuS1c-.js';
 
 /**
  * The Visitor Insights Studio tool.
@@ -342,24 +342,37 @@ interface SeriesPoint {
 }
 /** How a value should be written out. */
 type SeriesUnit = 'count' | 'money' | 'percent';
-/** One row of the chart. */
+/**
+ * One row of the chart: one answer, with what a lossier source saw underneath it.
+ *
+ * A row shows a SINGLE line by default. Two peer lines make the reader reconcile before they get
+ * an answer, and at a glance a foundry owner wants "how much", not "here are two measurements that
+ * disagree". The disagreement is still drawn — as a filled region, and in full on hover — because
+ * hiding it entirely would switch off the alarm: the 24 August collapse was visible precisely
+ * because two lines came apart.
+ */
 interface Series {
     key: string;
     label: string;
-    /** Which upstream this came from, shown so the reader can weigh it. */
+    /** Which upstream the LINE came from. */
     source: 'GA4' | 'Vercel' | 'Sanity' | 'Mailchimp';
-    /**
-     * Whether the source sees everything. GA4 does not; the others do.
-     * Drives the dashed stroke and the uncertainty band rather than a footnote nobody reads.
-     */
+    /** Whether the line's source sees everything. Drives the stroke and the wording. */
     complete: boolean;
     unit: SeriesUnit;
     points: SeriesPoint[];
     /**
-     * Multiplier from observed to estimated-true, for a lossy series. 1 means no correction known.
-     * Drawn as a band above the line, never as a replacement for it — the measured line stays.
+     * What a lossier source saw of the same thing.
+     *
+     * Drawn as a filled region between the two, NOT as a symmetric uncertainty band. There is no
+     * doubt about the traffic here: Vercel counted it server-side. What is uncertain is how much of
+     * it the analytics could see, and the honest way to draw that is the area it missed — a
+     * quantity, visible to scale, rather than a percentage on another tab.
      */
-    grossUpFactor?: number;
+    shortfall?: {
+        label: string;
+        source: Series['source'];
+        points: SeriesPoint[];
+    };
 }
 /** A dated event drawn through every row, e.g. a campaign send. */
 interface TimelineMarker {