@liiift-studio/sanity-visitor-insights 0.55.0 → 0.57.0

package/dist/index.js

@@ -1785,6 +1785,33 @@ var legendRow = {
   alignItems: "center"
 };
 
+// src/core/rank.ts
+var MIN_WEEKS_TO_RANK = 4;
+function weeklyRank(series) {
+  if (series.length < 7 * MIN_WEEKS_TO_RANK) return null;
+  const weeks = [];
+  for (let end = series.length; end - 7 >= 0; end -= 7) {
+    const slice = series.slice(end - 7, end);
+    weeks.push(slice.some((d) => d.value === null) ? null : slice.reduce((sum, d) => sum + d.value, 0));
+  }
+  const latest = weeks[0];
+  if (latest === null || latest === void 0) return null;
+  const comparable = weeks.filter((w) => w !== null);
+  if (comparable.length < MIN_WEEKS_TO_RANK) return null;
+  const better = comparable.filter((w) => w > latest).length;
+  return { rank: better + 1, of: comparable.length, value: latest };
+}
+function describeRank(rank) {
+  const ordinal = (n) => {
+    const tens = n % 100;
+    if (tens >= 11 && tens <= 13) return `${n}th`;
+    return `${n}${["th", "st", "nd", "rd"][n % 10] ?? "th"}`;
+  };
+  if (rank.rank === 1) return `best of the last ${rank.of} weeks`;
+  if (rank.rank === rank.of) return `lowest of the last ${rank.of} weeks`;
+  return `${ordinal(rank.rank)} best of the last ${rank.of} weeks`;
+}
+
 // src/types.ts
 function estimated(value, low, high, basis) {
   return { status: "estimated", value, low, high, basis };
@@ -1887,14 +1914,16 @@ function OverviewPanel({ data, previous, onBrush }) {
         /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { style: figureRow, children: [
           metricOr(data.revenue, OLDER_ROUTE).status === "ok" ? /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 4, children: formatMoney(data.revenue.value, data.currency ?? null) }) : /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(MetricFigure, { metric: metricOr(data.revenue, OLDER_ROUTE), label: "Revenue" }),
           /* @__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) })
       ] }) }),
       /* @__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" }),
         /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { style: figureRow, children: [
           /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(MetricFigure, { metric: data.orders, label: "Orders" }),
           /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Delta, { current: metricSortValue(data.orders), previous: metricSortValue(previous?.orders) })
-        ] })
+        ] }),
+        rankLine(data.crossSource, (d) => d.orders) && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: rankLine(data.crossSource, (d) => d.orders) })
       ] }) }),
       /* @__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: "Traffic" }),
@@ -1936,7 +1965,7 @@ function OverviewPanel({ data, previous, onBrush }) {
             average.status === "partial" && average.note && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: average.note })
           ] });
         })(),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: "From your own orders, so it is exact \u2014 but only across the orders that carry an amount, which is what the revenue figure covers." })
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 0, muted: true, children: "From your orders, so exact." })
       ] }) }),
       /* @__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: "Visitors per order" }),
@@ -2537,6 +2566,11 @@ function shortListNote(truncated, withheld, tail) {
   const cause = truncated && withheld ? "GA4 returned only its top rows, and withheld others with too few people to report" : truncated ? "GA4 returned only its top rows" : "GA4 withheld rows with too few people to report";
   return `${cause}, so this list is shorter than reality. ${tail}`;
 }
+function rankLine(series, pick) {
+  if (!series || series.length === 0) return null;
+  const ranked = weeklyRank(series.map((d) => ({ date: d.date, value: pick(d) })));
+  return ranked ? describeRank(ranked) : null;
+}
 function JourneyPanel({ data }) {
   const [segmentKey, setSegmentKey] = import_react4.default.useState(null);
   const segments = data.segments ?? [];
@@ -2856,7 +2890,7 @@ function TypefaceInterestPanel({ data }) {
     ] }),
     (data.licences?.length ?? 0) > 0 && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(import_sanity_ui_compat3.Stack, { space: 3, children: [
       /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(SectionTitle, { title: "How licences sell" }),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 1, muted: true, children: "From the orders themselves, so this is exact and unaffected by whatever GA4 is doing. Tier and term are separate rows, because they are the two variables in the pricing question and a tier that sells well at one year may not at perpetual." }),
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(import_sanity_ui_compat3.Text, { size: 1, muted: true, children: "From your orders, so exact. Tier and term are separate rows, because they are the two variables in the pricing question and a tier that sells well at one year may not at perpetual." }),
       /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
         ProportionChart,
         {
@@ -3183,14 +3217,11 @@ function CoverageRibbon({ ratio }) {
   const seen = Math.round((1 - ratio) * 100);
   const multiplier = seen > 0 ? Math.round(100 / seen) : null;
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_sanity_ui_compat4.Card, { padding: 3, radius: 2, tone: ratio > 0.6 ? "critical" : "caution", border: true, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_sanity_ui_compat4.Text, { size: 1, children: [
-    "Most figures on this tab come from Google Analytics, which is seeing roughly ",
+    "Google Analytics is seeing about ",
     seen,
-    "% of this site\u2019s traffic in this window \u2014 so the real numbers are",
-    " ",
-    multiplier === null ? "many times" : `several times`,
-    " these",
-    multiplier !== null && multiplier > 1 ? ` (very roughly ${multiplier}\xD7)` : "",
-    ". Figures drawn from your orders \u2014 anything labelled as coming from Sanity \u2014 are exact and must not be scaled up. Data health explains the rest, and how uncertain it is."
+    "% of your traffic here, so treat the figures below as roughly ",
+    multiplier === null ? "many times" : `${multiplier}\xD7`,
+    " low. Anything marked (orders) is exact \u2014 do not scale it."
   ] }) });
 }
 function ReadyReport({