@liiift-studio/sanity-visitor-insights 0.72.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-CMhL0Chn.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-CMhL0Chn.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-CMhL0Chn.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-CMhL0Chn.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;
 }
@@ -2438,7 +2376,7 @@ function OverviewPanel({ data, previous, onBrush }) {
           ),
           /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Delta, { current: metricSortValue(data.revenue), previous: metricSortValue(previous?.revenue) })
         ] }),
-        rankLine(data.crossSource, (d) => d.revenue) && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: rankLine(data.crossSource, (d) => d.revenue) })
+        revenueCoversEveryOrder(data) && rankLine(data.crossSource, (d) => d.revenue) && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: rankLine(data.crossSource, (d) => d.revenue) })
       ] }) }),
       /* @__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: 3, children: [
         /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Label, { size: 1, muted: true, children: "Orders" }),
@@ -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: [
@@ -3160,8 +3097,9 @@ function AcquisitionPanel({ data, previous }) {
         formatMoney(finiteOrNull(data.actualRevenue) ?? 0, data.currency ?? null),
         " from",
         " ",
-        finiteOrNull(data.actualOrders) === null ? "your orders" : `${formatCount(data.actualOrders)} orders`,
-        " in Sanity, split across the ",
+        finiteOrNull(data.actualOrders) === null ? "your orders" : (data.ordersMissingTotal ?? 0) > 0 ? `the ${formatCount(data.actualOrders - data.ordersMissingTotal)} of ${formatCount(data.actualOrders)} orders that carry an amount` : `${formatCount(data.actualOrders)} orders`,
+        " ",
+        "in Sanity, split across the ",
         formatCount(data.trackedPurchases ?? 0),
         " purchase",
         data.trackedPurchases === 1 ? "" : "s",
@@ -3416,7 +3354,7 @@ function TypefaceInterestPanel({ data }) {
       /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Text, { size: 1, muted: true, children: [
         "Sort by any column. \u201CSells vs catalogue\u201D compares each family\u2019s sales-per-view against the catalogue as a whole \u2014 1.0\xD7 is average, and sorting up finds the families that are looked at and do not sell. It is a comparison between your families, not the share of visitors who buy: Google Analytics sees only a fraction of the views, which moves every family together and so cancels out here. With one or two sales a family will still swing a long way, so read it alongside the order counts beside it.",
         " ",
-        "Bought and Revenue come from your own orders and are exact \u2014 do not scale those up.",
+        "Bought and Revenue come from your own orders, not from Google Analytics \u2014 do not scale those up.",
         " ",
         "A family needs a reasonable number of views before it gets a comparison at all; below that it says so rather than ranking one order against the catalogue."
       ] }),
@@ -3464,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),
@@ -3471,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),
@@ -3564,7 +3506,19 @@ function TypefaceInterestPanel({ data }) {
         }
       )
     ] }),
-    data.revenueIsApportioned && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: "Revenue is apportioned: an order covering several families or licences is split evenly between them, because the order documents carry no per-line value." })
+    data.revenueIsApportioned && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: "An order covering several families is split evenly between them, because the order documents carry no per-line value." }),
+    finiteOrNull(data.unattributedRevenue) !== null && data.unattributedRevenue > 0 && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: [
+      formatMoney(data.unattributedRevenue, data.currency ?? null),
+      " of this range\u2019s takings is not in the column above \u2014 those orders name no family in this catalogue."
+    ] }),
+    finiteOrNull(data.ordersMissingTotal) !== null && data.ordersMissingTotal > 0 && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: [
+      formatCount(data.ordersMissingTotal),
+      " order",
+      data.ordersMissingTotal === 1 ? "" : "s",
+      " in this range carry no amount, so the revenue column does not cover ",
+      data.ordersMissingTotal === 1 ? "it" : "them",
+      "."
+    ] })
   ] });
 }
 var CHECK_TONE = {