@liiift-studio/sanity-visitor-insights 0.73.0 → 0.74.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, c as MeasurementHealthData, D as DiagnosticReport, J as JourneyData, T as TypefaceInterestData } from './ranges-DhfuNtgW.mjs';
-export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DateRange, j as DiagnosticCheck, E as EmailCampaign, k as EventCutover, l as JourneyOutcome, m as JourneySegment, 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-DhfuNtgW.mjs';
+import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, c as MeasurementHealthData, D as DiagnosticReport, J as JourneyData, T as TypefaceInterestData } from './ranges-DfjCK0XY.mjs';
+export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DateRange, j as DiagnosticCheck, E as EmailCampaign, k as EventCutover, l as JourneyOutcome, m as JourneySegment, 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-DfjCK0XY.mjs';
 
 /**
  * Data hook for the Studio panels.

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, c as MeasurementHealthData, D as DiagnosticReport, J as JourneyData, T as TypefaceInterestData } from './ranges-DhfuNtgW.js';
-export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DateRange, j as DiagnosticCheck, E as EmailCampaign, k as EventCutover, l as JourneyOutcome, m as JourneySegment, 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-DhfuNtgW.js';
+import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, c as MeasurementHealthData, D as DiagnosticReport, J as JourneyData, T as TypefaceInterestData } from './ranges-DfjCK0XY.js';
+export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DateRange, j as DiagnosticCheck, E as EmailCampaign, k as EventCutover, l as JourneyOutcome, m as JourneySegment, 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-DfjCK0XY.js';
 
 /**
  * Data hook for the Studio panels.

package/dist/index.js

@@ -279,10 +279,6 @@ var SERIES = {
   /** Revenue, same source, different unit. */
   revenue: "#BF5D9B"
 };
-var REGION_ALPHA = 0.18;
-function seriesFill(key, alpha = REGION_ALPHA) {
-  return withAlpha(SERIES[key], alpha);
-}
 function withAlpha(hex, alpha) {
   const r = parseInt(hex.slice(1, 3), 16);
   const g = parseInt(hex.slice(3, 5), 16);
@@ -304,21 +300,14 @@ var MARKS = {
   "chart.coverage": { key: "ga4Sessions", alpha: 1, role: "data", note: "Share one source saw of another" },
   "chart.stem": { key: "orders", alpha: 1, role: "data", note: "One day that had orders" },
   "chart.zeroTick": { key: "orders", alpha: 1, role: "data", note: "A day MEASURED at zero \u2014 the package's founding distinction" },
-  "chart.regionEdge": { key: "ga4Pageviews", alpha: 1, role: "data", note: "The upper boundary of the shortfall region" },
-  "chart.region": {
-    key: "ga4Pageviews",
-    alpha: 0.22,
-    role: "fill",
-    boundary: "chart.regionEdge",
-    note: "What the lossier source missed. Light on purpose \u2014 the line it covers must stay readable"
-  },
+  // Renamed from `chart.regionEdge`. It was the boundary of a filled region; the region is gone —
+  // its width was the absolute gap, which under a flat coverage rate is the traffic curve scaled
+  // down, so it widened on busy days with no change in the instrument. This is now simply the
+  // lossier source's own line, which is what the collapse detector and the spoken summary read.
+  "chart.lossy": { key: "ga4Pageviews", alpha: 1, role: "data", note: "The lossier source's own level, dashed beneath the complete one" },
   "chart.ghost": { key: "comparison", alpha: 1, role: "data", note: "The same window last period, behind everything" },
   "chart.grid": { key: "neutral", alpha: 0.18, role: "furniture", note: "Grid rules" },
   "bar.fill": { key: "vercel", alpha: 1, role: "data", note: "Every proportion, comparison and funnel bar" },
-  // The hatch on a rung whose count covers fewer days than the rail it sits in. A `data` mark, not
-  // furniture: it is the only thing on that rung saying the figure is not comparable, so it has to
-  // be as visible as a bar would have been.
-  "bar.partial": { key: "vercel", alpha: 1, role: "data", note: "A funnel rung measured over part of the window" },
   "bar.track": { key: "neutral", alpha: 0.12, role: "furniture", note: "The rail a bar sits in" },
   // Neither a source nor money. It was drawn in the REVENUE hue, so a magenta bar between funnel
   // rungs read as takings; GA4's hue was rejected for the opposite reason, since that hue means
@@ -750,27 +739,14 @@ function FunnelChart({ stages, measurement }) {
                 /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Text, { size: 1, weight: "medium", children: stage.label }),
                 /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Text, { size: 1, weight: "semibold", children: formatCount(stage.value) })
               ] }),
-              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { "aria-hidden": "true", style: { ...barTrack, height: 10 }, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-                "div",
-                {
-                  style: stage.partial ? {
-                    height: "100%",
-                    width: "100%",
-                    borderRadius: 3,
-                    backgroundImage: `repeating-linear-gradient(135deg, ${mark("bar.partial")} 0 4px, transparent 4px 8px)`
-                  } : { ...barFill, width: `${width}%` }
-                }
-              ) }),
+              stage.partial ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: partialSlot }) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { "aria-hidden": "true", style: { ...barTrack, height: 10 }, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { ...barFill, width: `${width}%` } }) }),
               rateLine(stage, index, entry, share, stages[0]?.label ?? "")
             ]
           }
         )
       ] }, stage.key);
     }) }),
-    stages.some((stage) => stage.partial) && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: funnelKey, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "aria-hidden": "true", style: funnelKeySwatch }),
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Text, { size: 0, muted: true, children: "Striped: tracking started partway through this period, so the step covers fewer days than the ones above it and cannot be compared with them." })
-    ] }),
+    stages.some((stage) => stage.partial) && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Text, { size: 0, muted: true, children: "Steps with no bar were only tracked for part of this period, so they cover fewer days than the ones above and cannot be drawn against them. Their counts are exact for the days they do cover." }),
     withheldAny && /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_sanity_ui_compat.Text, { size: 0, muted: true, children: [
       "Shares are shown only for steps at least ",
       MIN_RATE_DENOMINATOR,
@@ -787,15 +763,7 @@ function gapLabel(delta, measurement, entry = 0) {
   }
   return `${formatCount(-delta)} more \u2014 not a subset of the step above`;
 }
-var funnelKey = { display: "flex", alignItems: "center", gap: 8, paddingTop: 4 };
-var funnelKeySwatch = {
-  display: "inline-block",
-  width: 24,
-  height: 10,
-  flex: "0 0 auto",
-  borderRadius: 3,
-  backgroundImage: `repeating-linear-gradient(135deg, ${mark("bar.partial")} 0 4px, transparent 4px 8px)`
-};
+var partialSlot = { height: 10 };
 var funnelList = { listStyle: "none", margin: 0, padding: 0 };
 var funnelItem = { display: "grid", gap: 4 };
 function funnelGapStyle(hasBar) {
@@ -1013,11 +981,12 @@ function EstimateDotPlot({
           " of ",
           formatCount(estimate.actual),
           wide && " \u2014 too small a sample to lean on",
+          estimate.note && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: estimateNote, children: estimate.note }),
           estimate.rate > 1.05 && " \u2014 over 100%, so GA4 is counting more than the source it is checked against. That is usually a tag firing twice, not extra traffic."
         ] })
       ] }, estimate.basis);
     }),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Text, { size: 0, muted: true, children: "Each is a separate way of asking the same question. Where they disagree, the spread is the answer\u2019s uncertainty \u2014 the rule marks 100%." })
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_sanity_ui_compat.Text, { size: 0, muted: true, children: "The rule marks 100%." })
   ] });
 }
 function SurvivalLines({
@@ -1435,6 +1404,7 @@ var estimateTrack = {
   borderRadius: 2,
   background: mark("bar.track")
 };
+var estimateNote = { display: "block", marginTop: 2, opacity: 0.85 };
 var estimateRule = {
   position: "absolute",
   top: 0,
@@ -2008,8 +1978,6 @@ function CrossSourceTimeline({ series, markers = [], currency, onBrush }) {
               const defined = (p) => p.value !== null;
               const lineGen = (0, import_d3_shape.line)().defined(defined).x(at).y((p) => y(p.value)).curve(import_d3_shape.curveLinear);
               const shortfallPoints = row.shortfall?.points ?? [];
-              const byDate = new Map(shortfallPoints.map((p) => [p.date, p.value]));
-              const gapGen = (0, import_d3_shape.area)().defined((p) => p.value !== null && byDate.get(p.date) != null).x(at).y0((p) => y(byDate.get(p.date))).y1((p) => y(p.value)).curve(import_d3_shape.curveLinear);
               const path = row.mark === "events" ? "" : lineGen(row.points) ?? "";
               const ghost = row.comparison && row.comparison.length > 1 ? lineGen(row.comparison.slice(0, dates.length).map((point, i) => ({
                 date: dates[i] ?? point.date,
@@ -2019,7 +1987,6 @@ function CrossSourceTimeline({ series, markers = [], currency, onBrush }) {
               const stemWidth = Math.max(1, Math.min(9, pitch > 2 ? pitch - 1 : pitch));
               const stems = row.mark === "events" ? row.points.filter((p) => p.value !== null && p.value !== 0) : [];
               const zeroes = row.mark === "events" && pitch >= 6 ? row.points.filter((p) => p.value === 0) : [];
-              const gap = row.shortfall ? gapGen(row.points) ?? "" : "";
               const shortfallLine = row.shortfall ? lineGen(shortfallPoints) ?? "" : "";
               const clipId = `${instanceId}-row-${rowIndex}`;
               return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("g", { children: [
@@ -2044,20 +2011,12 @@ function CrossSourceTimeline({ series, markers = [], currency, onBrush }) {
                       strokeDasharray: "2 3"
                     }
                   ),
-                  gap && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-                    "path",
-                    {
-                      d: gap,
-                      fill: shortfallStroke ? seriesFill(colorFor(row.shortfall.source, row.unit, row.shortfall.color), MARKS["chart.region"].alpha) : "currentColor",
-                      opacity: shortfallStroke ? 1 : 0.48
-                    }
-                  ),
                   shortfallLine && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
                     "path",
                     {
                       d: shortfallLine,
                       fill: "none",
-                      stroke: mark("chart.regionEdge"),
+                      stroke: mark("chart.lossy"),
                       strokeWidth: 1.5,
                       strokeDasharray: "6 4"
                     }
@@ -2229,22 +2188,13 @@ function CrossSourceTimeline({ series, markers = [], currency, onBrush }) {
       ] }, m.label))
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: legendRow, children: [
-      series.some((row) => row.shortfall) && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-          LegendKey,
-          {
-            swatch: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: legendDash(shortfallColour(series)) }),
-            label: `${shortfallLabel(series)} \u2014 the dashed line`
-          }
-        ),
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-          LegendKey,
-          {
-            swatch: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: legendBlock(seriesFill(shortfallKey(series), MARKS["chart.region"].alpha), shortfallColour(series)) }),
-            label: "Shaded: what your analytics did not see"
-          }
-        )
-      ] }),
+      series.some((row) => row.shortfall) && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+        LegendKey,
+        {
+          swatch: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: legendDash(shortfallColour(series)) }),
+          label: `${shortfallLabel(series)} \u2014 the dashed line`
+        }
+      ) }),
       series.some((row) => (row.comparison?.length ?? 0) > 1) && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
         LegendKey,
         {
@@ -2281,15 +2231,6 @@ function legendDash(colour) {
     borderTop: `2px dashed ${colour}`
   };
 }
-function legendBlock(fill, edge) {
-  return {
-    display: "inline-block",
-    width: 18,
-    height: 10,
-    background: fill,
-    borderTop: `1.5px dashed ${edge}`
-  };
-}
 var legendMarker = {
   display: "inline-block",
   position: "relative",
@@ -2383,9 +2324,6 @@ function metricOr(metric, detail) {
   return { status: "unavailable", reason: "route_outdated", detail };
 }
 var OLDER_ROUTE = "This site\u2019s analytics route is older than this figure \u2014 it will appear after the site is next deployed.";
-function maxOf(metrics) {
-  return metrics.reduce((max, metric) => !metric || metric.status === "unavailable" ? max : Math.max(max, metric.value), 0);
-}
 function finiteOrNull(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
@@ -2847,7 +2785,6 @@ function Verdict({ data, previous }) {
   );
 }
 function DataHealthPanel({ data, diagnostics }) {
-  const pageviewMax = maxOf([data.ga4Pageviews, data.vercelPageviews]);
   const contained = isContainment(data.vercelPageviews, data.ga4Pageviews);
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Stack, { space: 4, children: [
     /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Card, { padding: 3, radius: 2, tone: "transparent", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Stack, { space: 2, children: [
@@ -3465,6 +3402,8 @@ function TypefaceInterestPanel({ data }) {
             },
             {
               key: "bought",
+              // Never folded. Zero sales is the finding, not an empty column.
+              alwaysShow: true,
               label: "Bought (orders)",
               numeric: true,
               sortValue: (row) => metricSortValue(row.bought),
@@ -3472,6 +3411,8 @@ function TypefaceInterestPanel({ data }) {
             },
             {
               key: "revenue",
+              // Same reason as Bought: an exact zero from the order book is a measurement.
+              alwaysShow: true,
               label: "Revenue (orders)",
               numeric: true,
               sortValue: (row) => metricSortValue(row.revenue),