mirror of
https://github.com/pupperpowell/bibdle.git
synced 2026-10-22 05:54:10 -04:00
Compare commits
1
Commits
4d5893ce14
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
f9aded56f8 |
No files matched your search
@@ -4,6 +4,14 @@
|
|||||||
color: string;
|
color: string;
|
||||||
points: { date: string; value: number | null }[];
|
points: { date: string; value: number | null }[];
|
||||||
step?: boolean;
|
step?: boolean;
|
||||||
|
/** Draw the line dashed (e.g. a projection). */
|
||||||
|
dash?: boolean;
|
||||||
|
}
|
||||||
|
/** Optional shaded uncertainty band, aligned index-for-index with the series. */
|
||||||
|
interface Band {
|
||||||
|
lower: (number | null)[];
|
||||||
|
upper: (number | null)[];
|
||||||
|
color: string;
|
||||||
}
|
}
|
||||||
interface Props {
|
interface Props {
|
||||||
series: Series[];
|
series: Series[];
|
||||||
@@ -12,6 +20,13 @@
|
|||||||
yMin?: number;
|
yMin?: number;
|
||||||
yMax?: number;
|
yMax?: number;
|
||||||
showLegend?: boolean;
|
showLegend?: boolean;
|
||||||
|
/**
|
||||||
|
* Axis labels for calendar buckets, indexed like the points. Falls back
|
||||||
|
* to each point's date when omitted.
|
||||||
|
*/
|
||||||
|
xLabels?: string[];
|
||||||
|
/** Shaded range drawn behind the lines (p10–p90 style). */
|
||||||
|
band?: Band;
|
||||||
}
|
}
|
||||||
let {
|
let {
|
||||||
series,
|
series,
|
||||||
@@ -19,16 +34,42 @@
|
|||||||
ySuffix = '',
|
ySuffix = '',
|
||||||
yMin,
|
yMin,
|
||||||
yMax,
|
yMax,
|
||||||
showLegend = true
|
showLegend = true,
|
||||||
|
xLabels,
|
||||||
|
band
|
||||||
}: Props = $props();
|
}: Props = $props();
|
||||||
|
|
||||||
const W = 600;
|
/**
|
||||||
|
* The viewBox tracks the element's pixel width so the plot genuinely fills
|
||||||
|
* a full-width container. A fixed viewBox would be letterboxed and centred
|
||||||
|
* by the svg's "meet" scaling, leaving dead space at the sides and breaking
|
||||||
|
* the pointer -> index mapping. Falls back to 600 before first measurement.
|
||||||
|
*/
|
||||||
|
const FALLBACK_W = 600;
|
||||||
|
const MIN_W = 280;
|
||||||
|
let wrapperEl: HTMLDivElement | undefined = $state();
|
||||||
|
let measuredWidth = $state(0);
|
||||||
|
const W = $derived(Math.max(MIN_W, measuredWidth || FALLBACK_W));
|
||||||
|
|
||||||
|
$effect(() => {
|
||||||
|
const el = wrapperEl;
|
||||||
|
if (!el) return;
|
||||||
|
const observer = new ResizeObserver((entries) => {
|
||||||
|
measuredWidth = Math.round(entries[0]?.contentRect.width ?? 0);
|
||||||
|
});
|
||||||
|
observer.observe(el);
|
||||||
|
return () => observer.disconnect();
|
||||||
|
});
|
||||||
|
|
||||||
const pad = { l: 36, r: 10, t: 10, b: 22 };
|
const pad = { l: 36, r: 10, t: 10, b: 22 };
|
||||||
const innerW = W - pad.l - pad.r;
|
const innerW = $derived(W - pad.l - pad.r);
|
||||||
const innerH = $derived(height - pad.t - pad.b);
|
const innerH = $derived(height - pad.t - pad.b);
|
||||||
|
|
||||||
const allValues = $derived(
|
const allValues = $derived(
|
||||||
series.flatMap((s) => s.points.map((p) => p.value)).filter((v): v is number => v !== null)
|
[
|
||||||
|
...series.flatMap((s) => s.points.map((p) => p.value)),
|
||||||
|
...(band ? [...band.lower, ...band.upper] : [])
|
||||||
|
].filter((v): v is number => v !== null && v !== undefined)
|
||||||
);
|
);
|
||||||
const domain = $derived.by(() => {
|
const domain = $derived.by(() => {
|
||||||
const lo = yMin ?? (allValues.length ? Math.min(...allValues) : 0);
|
const lo = yMin ?? (allValues.length ? Math.min(...allValues) : 0);
|
||||||
@@ -64,25 +105,81 @@
|
|||||||
current.push(`${xAt(i).toFixed(1)},${yAt(p.value).toFixed(1)}`);
|
current.push(`${xAt(i).toFixed(1)},${yAt(p.value).toFixed(1)}`);
|
||||||
});
|
});
|
||||||
if (current.length) segments.push(current.join(' '));
|
if (current.length) segments.push(current.join(' '));
|
||||||
return { name: s.name, color: s.color, segments, step: s.step };
|
return { name: s.name, color: s.color, segments, step: s.step, dash: s.dash };
|
||||||
})
|
})
|
||||||
);
|
);
|
||||||
|
|
||||||
const firstLabel = $derived(series[0]?.points[0]?.date?.slice(5) ?? '');
|
/**
|
||||||
const lastLabel = $derived(
|
* Filled band path: for each contiguous run where both bounds exist, trace the
|
||||||
series[0]?.points[series[0].points.length - 1]?.date?.slice(5) ?? ''
|
* upper edge left-to-right and the lower edge right-to-left, then close.
|
||||||
);
|
*/
|
||||||
|
const bandPath = $derived.by(() => {
|
||||||
|
if (!band) return '';
|
||||||
|
const n = Math.max(band.lower.length, band.upper.length);
|
||||||
|
const parts: string[] = [];
|
||||||
|
let run: number[] = [];
|
||||||
|
const flush = () => {
|
||||||
|
if (run.length < 2) {
|
||||||
|
run = [];
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const top = run.map((i) => `${xAt(i).toFixed(1)},${yAt(band.upper[i] as number).toFixed(1)}`);
|
||||||
|
const bottom = [...run]
|
||||||
|
.reverse()
|
||||||
|
.map((i) => `${xAt(i).toFixed(1)},${yAt(band.lower[i] as number).toFixed(1)}`);
|
||||||
|
const edge = [top[0], ...top.slice(1).map((p) => `L${p}`), ...bottom.map((p) => `L${p}`)];
|
||||||
|
parts.push(`M${edge.join(' ')} Z`);
|
||||||
|
run = [];
|
||||||
|
};
|
||||||
|
for (let i = 0; i < n; i++) {
|
||||||
|
const lo = band.lower[i];
|
||||||
|
const hi = band.upper[i];
|
||||||
|
if (lo === null || lo === undefined || hi === null || hi === undefined) flush();
|
||||||
|
else run.push(i);
|
||||||
|
}
|
||||||
|
flush();
|
||||||
|
return parts.join(' ');
|
||||||
|
});
|
||||||
|
|
||||||
|
function labelAt(i: number): string {
|
||||||
|
return xLabels?.[i] ?? series[0]?.points[i]?.date ?? '';
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Axis ticks fall back to MM-DD so a 90-day chart's labels stay compact. */
|
||||||
|
function axisLabelAt(i: number): string {
|
||||||
|
const label = xLabels?.[i];
|
||||||
|
if (label !== undefined) return label;
|
||||||
|
return (series[0]?.points[i]?.date ?? '').slice(5);
|
||||||
|
}
|
||||||
|
|
||||||
|
const firstLabel = $derived.by(() => (pointCount > 0 ? axisLabelAt(0) : ''));
|
||||||
|
const lastLabel = $derived.by(() => (pointCount > 0 ? axisLabelAt(pointCount - 1) : ''));
|
||||||
|
|
||||||
|
// A middle tick only once the plot is wide enough that the three labels
|
||||||
|
// cannot collide (roughly 70px per label at this font size).
|
||||||
|
const midIndex = $derived(Math.floor((pointCount - 1) / 2));
|
||||||
|
const showMidLabel = $derived(innerW > 240 && pointCount > 4);
|
||||||
|
const midLabel = $derived(showMidLabel ? axisLabelAt(midIndex) : '');
|
||||||
|
|
||||||
// --- Hover / tooltip state -------------------------------------------------
|
// --- Hover / tooltip state -------------------------------------------------
|
||||||
let wrapperEl: HTMLDivElement | undefined = $state();
|
let svgEl: SVGSVGElement | undefined = $state();
|
||||||
let hoverIndex = $state<number | null>(null);
|
let hoverIndex = $state<number | null>(null);
|
||||||
|
/** Letterbox transform of the viewBox inside the element, refreshed on move. */
|
||||||
|
let box = $state({ left: 0, scale: 1, width: 1 });
|
||||||
|
|
||||||
function handlePointerMove(event: PointerEvent) {
|
function handlePointerMove(event: PointerEvent) {
|
||||||
if (!wrapperEl || pointCount <= 0) return;
|
if (!svgEl || pointCount <= 0) return;
|
||||||
const rect = wrapperEl.getBoundingClientRect();
|
const rect = svgEl.getBoundingClientRect();
|
||||||
if (rect.width === 0) return;
|
if (rect.width === 0 || rect.height === 0) return;
|
||||||
const scale = rect.width / W;
|
|
||||||
const svgX = (event.clientX - rect.left) / scale;
|
// The svg scales its viewBox to fit the element ("meet"), so on a
|
||||||
|
// container wider than the viewBox aspect ratio the drawing is
|
||||||
|
// letterboxed and centred. Map the pointer through that same transform,
|
||||||
|
// otherwise the right half of a full-width chart reports the wrong index.
|
||||||
|
const scale = Math.min(rect.width / W, rect.height / height);
|
||||||
|
const offsetX = (rect.width - W * scale) / 2;
|
||||||
|
box = { left: offsetX, scale, width: rect.width };
|
||||||
|
const svgX = (event.clientX - rect.left - offsetX) / scale;
|
||||||
if (pointCount <= 1) {
|
if (pointCount <= 1) {
|
||||||
hoverIndex = 0;
|
hoverIndex = 0;
|
||||||
return;
|
return;
|
||||||
@@ -109,18 +206,18 @@
|
|||||||
|
|
||||||
const hoveredDate = $derived.by(() => {
|
const hoveredDate = $derived.by(() => {
|
||||||
if (hoverIndex === null) return null;
|
if (hoverIndex === null) return null;
|
||||||
for (const s of series) {
|
return labelAt(hoverIndex) || null;
|
||||||
const point = s.points[hoverIndex];
|
|
||||||
if (point) return point.date;
|
|
||||||
}
|
|
||||||
return null;
|
|
||||||
});
|
});
|
||||||
|
|
||||||
const hasHoverValues = $derived(hoverRows.some((r) => r.value !== null));
|
const hasHoverValues = $derived(hoverRows.some((r) => r.value !== null));
|
||||||
|
|
||||||
const tooltipLeft = $derived(
|
/** Tooltip position in wrapper-relative %, following the letterboxed plot. */
|
||||||
hoverIndex === null ? 50 : Math.min(85, Math.max(15, (xAt(hoverIndex) / W) * 100))
|
const tooltipLeft = $derived.by(() => {
|
||||||
);
|
if (hoverIndex === null || box.width === 0) return 50;
|
||||||
|
const px = box.left + xAt(hoverIndex) * box.scale;
|
||||||
|
const pctLeft = (px / box.width) * 100;
|
||||||
|
return Math.min(88, Math.max(12, pctLeft));
|
||||||
|
});
|
||||||
|
|
||||||
function formatValue(value: number | null): string {
|
function formatValue(value: number | null): string {
|
||||||
if (value === null) return '—';
|
if (value === null) return '—';
|
||||||
@@ -138,6 +235,7 @@
|
|||||||
onpointercancel={clearHover}
|
onpointercancel={clearHover}
|
||||||
>
|
>
|
||||||
<svg
|
<svg
|
||||||
|
bind:this={svgEl}
|
||||||
viewBox={`0 0 ${W} ${height}`}
|
viewBox={`0 0 ${W} ${height}`}
|
||||||
class="w-full text-gray-400"
|
class="w-full text-gray-400"
|
||||||
style={`height:${height}px`}
|
style={`height:${height}px`}
|
||||||
@@ -162,6 +260,10 @@
|
|||||||
{domain.lo.toFixed(0)}{ySuffix}
|
{domain.lo.toFixed(0)}{ySuffix}
|
||||||
</text>
|
</text>
|
||||||
|
|
||||||
|
{#if band && bandPath}
|
||||||
|
<path d={bandPath} fill={band.color} opacity="0.16" stroke="none" />
|
||||||
|
{/if}
|
||||||
|
|
||||||
{#each paths as s (s.name)}
|
{#each paths as s (s.name)}
|
||||||
{#each s.segments as d}
|
{#each s.segments as d}
|
||||||
<polyline
|
<polyline
|
||||||
@@ -171,6 +273,7 @@
|
|||||||
stroke-width="1.75"
|
stroke-width="1.75"
|
||||||
stroke-linejoin="round"
|
stroke-linejoin="round"
|
||||||
stroke-linecap="round"
|
stroke-linecap="round"
|
||||||
|
stroke-dasharray={s.dash ? '4 3' : undefined}
|
||||||
vector-effect="non-scaling-stroke"
|
vector-effect="non-scaling-stroke"
|
||||||
opacity={hoverIndex === null ? 1 : 0.45}
|
opacity={hoverIndex === null ? 1 : 0.45}
|
||||||
style="transition:opacity 120ms ease"
|
style="transition:opacity 120ms ease"
|
||||||
@@ -209,6 +312,18 @@
|
|||||||
<text x={pad.l} y={height - 6} fill="currentColor" fill-opacity="0.8" font-size="9">
|
<text x={pad.l} y={height - 6} fill="currentColor" fill-opacity="0.8" font-size="9">
|
||||||
{firstLabel}
|
{firstLabel}
|
||||||
</text>
|
</text>
|
||||||
|
{#if showMidLabel && midLabel}
|
||||||
|
<text
|
||||||
|
x={xAt(midIndex)}
|
||||||
|
y={height - 6}
|
||||||
|
text-anchor="middle"
|
||||||
|
fill="currentColor"
|
||||||
|
fill-opacity="0.6"
|
||||||
|
font-size="9"
|
||||||
|
>
|
||||||
|
{midLabel}
|
||||||
|
</text>
|
||||||
|
{/if}
|
||||||
<text
|
<text
|
||||||
x={W - pad.r}
|
x={W - pad.r}
|
||||||
y={height - 6}
|
y={height - 6}
|
||||||
|
|||||||
@@ -0,0 +1,141 @@
|
|||||||
|
<script lang="ts">
|
||||||
|
import Container from '$lib/components/Container.svelte';
|
||||||
|
import CalendarHeatmap from '$lib/components/charts/CalendarHeatmap.svelte';
|
||||||
|
import { formatDateLabel, numOrDash } from '$lib/utils/stats-format';
|
||||||
|
import type { CommunityStatsData } from '$lib/types/stats';
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
data: CommunityStatsData;
|
||||||
|
/**
|
||||||
|
* `auto` follows the site light/dark theme (public page); `dark` forces
|
||||||
|
* the dark palette for the always-dark admin console.
|
||||||
|
*/
|
||||||
|
tone?: 'auto' | 'dark';
|
||||||
|
}
|
||||||
|
let { data, tone = 'auto' }: Props = $props();
|
||||||
|
|
||||||
|
const calendar = $derived(data.calendar);
|
||||||
|
const active = $derived(calendar.filter((d) => d.count > 0));
|
||||||
|
|
||||||
|
const total = $derived(calendar.reduce((sum, d) => sum + d.count, 0));
|
||||||
|
const avgPerDay = $derived(calendar.length ? total / calendar.length : 0);
|
||||||
|
|
||||||
|
const bestDay = $derived(
|
||||||
|
active.reduce<{ date: string; count: number } | null>(
|
||||||
|
(best, d) => (best === null || d.count > best.count ? d : best),
|
||||||
|
null
|
||||||
|
)
|
||||||
|
);
|
||||||
|
const worstDay = $derived(
|
||||||
|
active.reduce<{ date: string; count: number } | null>(
|
||||||
|
(worst, d) => (worst === null || d.count < worst.count ? d : worst),
|
||||||
|
null
|
||||||
|
)
|
||||||
|
);
|
||||||
|
const medianDay = $derived.by(() => {
|
||||||
|
if (active.length === 0) return null;
|
||||||
|
const sorted = [...active].sort((a, b) => a.count - b.count);
|
||||||
|
return sorted[Math.floor((sorted.length - 1) / 2)];
|
||||||
|
});
|
||||||
|
|
||||||
|
/** Compact enough to sit inside a day square. */
|
||||||
|
function compactCount(n: number): string {
|
||||||
|
if (n >= 10000) return `${Math.round(n / 1000)}k`;
|
||||||
|
if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;
|
||||||
|
return String(n);
|
||||||
|
}
|
||||||
|
|
||||||
|
const annotations = $derived.by(() => {
|
||||||
|
const out: Record<string, string> = {};
|
||||||
|
for (const day of [bestDay, medianDay, worstDay]) {
|
||||||
|
if (day) out[day.date] = compactCount(day.count);
|
||||||
|
}
|
||||||
|
return out;
|
||||||
|
});
|
||||||
|
|
||||||
|
const palette = $derived(
|
||||||
|
tone === 'dark'
|
||||||
|
? {
|
||||||
|
heading: 'text-gray-100',
|
||||||
|
sub: 'text-gray-400',
|
||||||
|
label: 'text-gray-400',
|
||||||
|
value: 'text-gray-100',
|
||||||
|
muted: 'text-gray-500'
|
||||||
|
}
|
||||||
|
: {
|
||||||
|
heading: 'text-gray-900 dark:text-gray-100',
|
||||||
|
sub: 'text-gray-600 dark:text-gray-400',
|
||||||
|
label: 'text-gray-600 dark:text-gray-400',
|
||||||
|
value: 'text-gray-900 dark:text-gray-100',
|
||||||
|
muted: 'text-gray-500 dark:text-gray-400'
|
||||||
|
}
|
||||||
|
);
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<div>
|
||||||
|
<div class="mb-6 text-center">
|
||||||
|
<h1 class="text-3xl font-bold {palette.heading}">Community Stats</h1>
|
||||||
|
<p class="mt-1 text-sm {palette.sub}">As of {formatDateLabel(data.asOfDate)}</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="grid grid-cols-2 gap-3 md:grid-cols-3">
|
||||||
|
{#each [
|
||||||
|
{ label: 'All-time plays', value: numOrDash(data.completions) },
|
||||||
|
{ label: 'All-time players', value: numOrDash(data.players) },
|
||||||
|
{ label: 'Players this week', value: numOrDash(data.weeklyPlayers) },
|
||||||
|
{ label: 'Players this month', value: numOrDash(data.monthlyPlayers) },
|
||||||
|
{ label: "Latest day's plays", value: numOrDash(data.yesterdayCompletions) },
|
||||||
|
{ label: 'Avg guesses that day', value: numOrDash(data.yesterdayAvgGuesses) }
|
||||||
|
] as card (card.label)}
|
||||||
|
<Container class="p-4 w-full items-start text-left">
|
||||||
|
<p class="text-[11px] font-semibold uppercase tracking-wider {palette.label}">{card.label}</p>
|
||||||
|
<p class="text-2xl font-bold {palette.value}">{card.value}</p>
|
||||||
|
</Container>
|
||||||
|
{/each}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<Container class="mt-3 p-4 w-full items-stretch text-left gap-3">
|
||||||
|
<p class="font-semibold {palette.heading}">Daily plays (last {calendar.length} days)</p>
|
||||||
|
<div class="flex flex-col gap-4 sm:flex-row sm:items-start">
|
||||||
|
<div class="flex flex-col gap-1">
|
||||||
|
<CalendarHeatmap data={calendar} cellSize={22} annotations={annotations} />
|
||||||
|
<p class="text-[10px] {palette.muted}">
|
||||||
|
Numbers mark the best, median, and least popular days.
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="flex min-w-0 flex-1 flex-col gap-4">
|
||||||
|
<dl class="grid grid-cols-2 gap-x-4 gap-y-3 text-sm">
|
||||||
|
<div>
|
||||||
|
<dt class="text-[11px] uppercase tracking-wider {palette.muted}">{calendar.length}-day plays</dt>
|
||||||
|
<dd class="font-semibold tabular-nums {palette.value}">{numOrDash(total)}</dd>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<dt class="text-[11px] uppercase tracking-wider {palette.muted}">Daily average</dt>
|
||||||
|
<dd class="font-semibold tabular-nums {palette.value}">
|
||||||
|
{avgPerDay.toLocaleString('en-US', { maximumFractionDigits: 1 })}
|
||||||
|
</dd>
|
||||||
|
</div>
|
||||||
|
{#if bestDay}
|
||||||
|
<div>
|
||||||
|
<dt class="text-[11px] uppercase tracking-wider {palette.muted}">Best day ({calendar.length}d)</dt>
|
||||||
|
<dd class="font-semibold tabular-nums {palette.value}">
|
||||||
|
{numOrDash(bestDay.count)}
|
||||||
|
<span class="font-normal {palette.muted}">on {formatDateLabel(bestDay.date)}</span>
|
||||||
|
</dd>
|
||||||
|
</div>
|
||||||
|
{/if}
|
||||||
|
{#if data.bestDayAllTime}
|
||||||
|
<div>
|
||||||
|
<dt class="text-[11px] uppercase tracking-wider {palette.muted}">Best day · all-time</dt>
|
||||||
|
<dd class="font-semibold tabular-nums {palette.value}">
|
||||||
|
{numOrDash(data.bestDayAllTime.count)}
|
||||||
|
<span class="font-normal {palette.muted}">on {formatDateLabel(data.bestDayAllTime.date)}</span>
|
||||||
|
</dd>
|
||||||
|
</div>
|
||||||
|
{/if}
|
||||||
|
</dl>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</Container>
|
||||||
|
</div>
|
||||||
@@ -11,6 +11,8 @@
|
|||||||
const GLOSSARY: GlossaryEntry[] = [
|
const GLOSSARY: GlossaryEntry[] = [
|
||||||
{ name: 'Players today', definition: 'Finished the puzzle yesterday.', action: 'Investigate content or traffic.' },
|
{ name: 'Players today', definition: 'Finished the puzzle yesterday.', action: 'Investigate content or traffic.' },
|
||||||
{ name: 'WAU / MAU', definition: 'Played at least once in the last 7 / 30 days.', action: 'Reach vs habit.' },
|
{ name: 'WAU / MAU', definition: 'Played at least once in the last 7 / 30 days.', action: 'Reach vs habit.' },
|
||||||
|
{ name: 'Weekly vs monthly players', definition: 'Every completed ISO week (Mon–Sun) or calendar month, up to the last fully closed one. Week buckets count the whole week; month buckets count the whole month.', action: 'A shrinking gap means fewer monthly players play weekly.' },
|
||||||
|
{ name: 'Resurrected', definition: `Came back after a break of 30+ days (see Settings).`, action: 'Did something bring them back?' },
|
||||||
{ name: 'Core players', definition: 'Finished 4+ times this week.', action: 'If falling, it is a retention problem.' },
|
{ name: 'Core players', definition: 'Finished 4+ times this week.', action: 'If falling, it is a retention problem.' },
|
||||||
{ name: 'Returning share', definition: 'Played before today vs. first time.', action: 'Low = acquisition-heavy and leaky.' },
|
{ name: 'Returning share', definition: 'Played before today vs. first time.', action: 'Low = acquisition-heavy and leaky.' },
|
||||||
{ name: 'D1 return', definition: 'First-timers who came back the next day.', action: 'The number one activation lever.' },
|
{ name: 'D1 return', definition: 'First-timers who came back the next day.', action: 'The number one activation lever.' },
|
||||||
|
|||||||
@@ -10,7 +10,8 @@
|
|||||||
}
|
}
|
||||||
let { payload }: Props = $props();
|
let { payload }: Props = $props();
|
||||||
|
|
||||||
const series = $derived(payload.dailySeries.slice(-60));
|
// The full 90-day window: 3 months of daily points.
|
||||||
|
const series = $derived(payload.dailySeries);
|
||||||
const hasStarted = $derived(payload.meta.hasStartedData);
|
const hasStarted = $derived(payload.meta.hasStartedData);
|
||||||
const signupTotal = $derived(payload.growth.signups.reduce((a, b) => a + b.count, 0));
|
const signupTotal = $derived(payload.growth.signups.reduce((a, b) => a + b.count, 0));
|
||||||
</script>
|
</script>
|
||||||
@@ -20,7 +21,7 @@
|
|||||||
|
|
||||||
<Container class="p-4 w-full items-stretch text-left gap-2">
|
<Container class="p-4 w-full items-stretch text-left gap-2">
|
||||||
<p class="font-semibold text-gray-100">New players per day</p>
|
<p class="font-semibold text-gray-100">New players per day</p>
|
||||||
<p class="text-xs text-gray-400">First-time players each day. Hover later for post annotations.</p>
|
<p class="text-xs text-gray-400">First-time players each day, last 3 months. Hover later for post annotations.</p>
|
||||||
<MiniLineChart
|
<MiniLineChart
|
||||||
series={[{ name: 'New players', color: '#60a5fa', points: series.map((d) => ({ date: d.date, value: d.newPlayers })) }]}
|
series={[{ name: 'New players', color: '#60a5fa', points: series.map((d) => ({ date: d.date, value: d.newPlayers })) }]}
|
||||||
showLegend={false}
|
showLegend={false}
|
||||||
|
|||||||
@@ -0,0 +1,147 @@
|
|||||||
|
<script lang="ts">
|
||||||
|
import Container from '$lib/components/Container.svelte';
|
||||||
|
import MiniLineChart from '$lib/components/charts/MiniLineChart.svelte';
|
||||||
|
import type { ProjectionPoint, SnapshotPayload } from '$lib/types/stats';
|
||||||
|
import { numOrDash } from '$lib/utils/stats-format';
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
payload: SnapshotPayload;
|
||||||
|
}
|
||||||
|
let { payload }: Props = $props();
|
||||||
|
|
||||||
|
type Method = 'flow' | 'regression' | 'seasonal';
|
||||||
|
let method: Method = $state('flow');
|
||||||
|
|
||||||
|
/** Only the most recent stretch of history is plotted; the models use all of it. */
|
||||||
|
const HISTORY_WEEKS = 52;
|
||||||
|
|
||||||
|
const weeks = $derived(payload.activity.stickiness?.week ?? []);
|
||||||
|
const projection = $derived(payload.activity.projection ?? null);
|
||||||
|
|
||||||
|
const methods: { value: Method; label: string; hint: string }[] = [
|
||||||
|
{
|
||||||
|
value: 'flow',
|
||||||
|
label: 'Flow',
|
||||||
|
hint: 'Retention × current base + new/returning inflow, fitted over all weeks. Converges to a saturation level; shaded band is a p10–p90 bootstrap.'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
value: 'regression',
|
||||||
|
label: 'Regression',
|
||||||
|
hint: 'OLS on lagged WAU and this week’s new/resurrected inflow. Band from residual bootstrap.'
|
||||||
|
},
|
||||||
|
{
|
||||||
|
value: 'seasonal',
|
||||||
|
label: 'Seasonal',
|
||||||
|
hint: 'One annual harmonic plus a damped linear trend. Meaningful once there is close to a full year of history; band from residual bootstrap.'
|
||||||
|
}
|
||||||
|
];
|
||||||
|
|
||||||
|
const chart = $derived.by(() => {
|
||||||
|
if (!projection || weeks.length === 0) return null;
|
||||||
|
const points: ProjectionPoint[] = projection[method];
|
||||||
|
if (points.length === 0) return null;
|
||||||
|
|
||||||
|
const recent = weeks.slice(-HISTORY_WEEKS);
|
||||||
|
const n = recent.length;
|
||||||
|
const total = n + points.length;
|
||||||
|
const actual: (number | null)[] = Array(total).fill(null);
|
||||||
|
const projected: (number | null)[] = Array(total).fill(null);
|
||||||
|
const lower: (number | null)[] = Array(total).fill(null);
|
||||||
|
const upper: (number | null)[] = Array(total).fill(null);
|
||||||
|
const labels: string[] = Array(total).fill('');
|
||||||
|
const dates: string[] = Array(total).fill('');
|
||||||
|
|
||||||
|
for (let i = 0; i < n; i++) {
|
||||||
|
actual[i] = recent[i].wau;
|
||||||
|
labels[i] = recent[i].label;
|
||||||
|
dates[i] = recent[i].date;
|
||||||
|
}
|
||||||
|
// Anchor the projection to the last actual point so the lines connect.
|
||||||
|
projected[n - 1] = recent[n - 1].wau;
|
||||||
|
lower[n - 1] = recent[n - 1].wau;
|
||||||
|
upper[n - 1] = recent[n - 1].wau;
|
||||||
|
for (let k = 0; k < points.length; k++) {
|
||||||
|
const idx = n + k;
|
||||||
|
projected[idx] = points[k].value;
|
||||||
|
lower[idx] = points[k].low;
|
||||||
|
upper[idx] = points[k].high;
|
||||||
|
labels[idx] = points[k].label;
|
||||||
|
dates[idx] = points[k].date;
|
||||||
|
}
|
||||||
|
|
||||||
|
const toLine = (values: (number | null)[]) =>
|
||||||
|
values.map((value, i) => ({ date: dates[i], value }));
|
||||||
|
|
||||||
|
return {
|
||||||
|
series: [
|
||||||
|
{ name: 'Actual WAU', color: '#60a5fa', points: toLine(actual) },
|
||||||
|
{ name: 'Projected', color: '#a78bfa', dash: true, points: toLine(projected) }
|
||||||
|
],
|
||||||
|
band: { lower, upper, color: '#a78bfa' },
|
||||||
|
xLabels: labels
|
||||||
|
};
|
||||||
|
});
|
||||||
|
|
||||||
|
const activeHint = $derived(methods.find((m) => m.value === method)?.hint ?? '');
|
||||||
|
const lastWau = $derived(weeks.at(-1)?.wau ?? null);
|
||||||
|
const projectedLast = $derived(projection?.[method].at(-1) ?? null);
|
||||||
|
|
||||||
|
function toggleClass(value: Method): string {
|
||||||
|
return method === value
|
||||||
|
? 'bg-white/15 text-gray-100'
|
||||||
|
: 'text-gray-400 hover:text-gray-200';
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<section class="flex flex-col gap-3">
|
||||||
|
<div class="flex flex-wrap items-center justify-between gap-2">
|
||||||
|
<h2 class="text-lg font-bold text-gray-100">Projection · Weekly active users</h2>
|
||||||
|
<div class="flex shrink-0 gap-1 rounded-lg border border-white/10 p-0.5">
|
||||||
|
{#each methods as m (m.value)}
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
onclick={() => (method = m.value)}
|
||||||
|
aria-pressed={method === m.value}
|
||||||
|
class="rounded-md px-2.5 py-1 text-xs font-medium transition-colors {toggleClass(m.value)}"
|
||||||
|
>
|
||||||
|
{m.label}
|
||||||
|
</button>
|
||||||
|
{/each}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<Container class="p-4 w-full items-stretch text-left gap-2">
|
||||||
|
{#if chart && projection}
|
||||||
|
<p class="text-xs text-gray-400">{activeHint}</p>
|
||||||
|
<div class="flex flex-wrap gap-x-6 gap-y-1 text-xs text-gray-400">
|
||||||
|
<span>Latest actual: <span class="font-semibold text-gray-200">{numOrDash(lastWau)}</span></span>
|
||||||
|
<span>
|
||||||
|
Retention:
|
||||||
|
<span class="font-semibold text-gray-200">{Math.round(projection.retention * 100)}%</span>/wk
|
||||||
|
</span>
|
||||||
|
<span>Weekly inflow: <span class="font-semibold text-gray-200">{numOrDash(projection.inflow)}</span></span>
|
||||||
|
<span>History: <span class="font-semibold text-gray-200">{projection.sampleWeeks}w</span></span>
|
||||||
|
<span>Horizon: <span class="font-semibold text-gray-200">{projection.horizonWeeks}w</span></span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<MiniLineChart series={chart.series} xLabels={chart.xLabels} band={chart.band} yMin={0} />
|
||||||
|
|
||||||
|
<p class="text-xs text-gray-400">
|
||||||
|
Projected WAU in {projectedLast?.label}:
|
||||||
|
<span class="font-semibold text-gray-200">{numOrDash(projectedLast?.value ?? null)}</span>
|
||||||
|
{#if projectedLast}
|
||||||
|
<span class="text-gray-500">
|
||||||
|
(80% range {numOrDash(projectedLast.low)}–{numOrDash(projectedLast.high)})</span
|
||||||
|
>
|
||||||
|
{/if}
|
||||||
|
· solid = actual, dashed = projection.
|
||||||
|
</p>
|
||||||
|
<p class="text-[11px] text-gray-500">
|
||||||
|
Models are fitted on all {projection.sampleWeeks} completed weeks. Bands are model uncertainty from
|
||||||
|
resampling, not real-world coverage; treat long horizons with caution.
|
||||||
|
</p>
|
||||||
|
{:else}
|
||||||
|
<p class="text-sm text-gray-400">Not enough completed weeks of history to project yet.</p>
|
||||||
|
{/if}
|
||||||
|
</Container>
|
||||||
|
</section>
|
||||||
@@ -1,9 +1,17 @@
|
|||||||
<script lang="ts">
|
<script lang="ts">
|
||||||
import KpiCard from './KpiCard.svelte';
|
import KpiCard from './KpiCard.svelte';
|
||||||
import StatusPill from '$lib/components/charts/StatusPill.svelte';
|
import StatusPill from '$lib/components/charts/StatusPill.svelte';
|
||||||
import type { Signal, SnapshotPayload, StatsSettings } from '$lib/types/stats';
|
import MiniLineChart from '$lib/components/charts/MiniLineChart.svelte';
|
||||||
|
import type {
|
||||||
|
ActivityBucket,
|
||||||
|
BucketGranularity,
|
||||||
|
Signal,
|
||||||
|
SnapshotPayload,
|
||||||
|
StatsSettings
|
||||||
|
} from '$lib/types/stats';
|
||||||
import {
|
import {
|
||||||
delta,
|
delta,
|
||||||
|
formatDateLabel,
|
||||||
numOrDash,
|
numOrDash,
|
||||||
pctOrDash,
|
pctOrDash,
|
||||||
signed
|
signed
|
||||||
@@ -30,6 +38,49 @@
|
|||||||
? 'bad'
|
? 'bad'
|
||||||
: 'warn'
|
: 'warn'
|
||||||
);
|
);
|
||||||
|
|
||||||
|
// WAU vs MAU, bucketed by calendar period rather than a rolling window.
|
||||||
|
let granularity: BucketGranularity = $state('week');
|
||||||
|
const buckets: ActivityBucket[] = $derived(payload.activity.stickiness?.[granularity] ?? []);
|
||||||
|
const latestBucket = $derived(buckets.at(-1) ?? null);
|
||||||
|
const priorBucket = $derived(buckets.at(-2) ?? null);
|
||||||
|
const stickiness = $derived(
|
||||||
|
latestBucket && latestBucket.mau > 0
|
||||||
|
? Math.round((latestBucket.wau / latestBucket.mau) * 100)
|
||||||
|
: null
|
||||||
|
);
|
||||||
|
// In week mode WAU is the headline series; in month mode it is MAU.
|
||||||
|
const comparisonMetric = $derived(granularity === 'week' ? ('wau' as const) : ('mau' as const));
|
||||||
|
const comparisonLabel = $derived(granularity === 'week' ? 'Weekly players' : 'Monthly players');
|
||||||
|
const stickinessDelta = $derived(
|
||||||
|
latestBucket && priorBucket
|
||||||
|
? delta(latestBucket[comparisonMetric], priorBucket[comparisonMetric])
|
||||||
|
: null
|
||||||
|
);
|
||||||
|
|
||||||
|
const granularityOptions: { value: BucketGranularity; label: string }[] = [
|
||||||
|
{ value: 'week', label: 'Weeks' },
|
||||||
|
{ value: 'month', label: 'Months' }
|
||||||
|
];
|
||||||
|
|
||||||
|
const bucketSeries = $derived([
|
||||||
|
{
|
||||||
|
name: 'Weekly players',
|
||||||
|
color: '#60a5fa',
|
||||||
|
points: buckets.map((b) => ({ date: b.date, value: b.wau }))
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: 'Monthly players',
|
||||||
|
color: '#a78bfa',
|
||||||
|
points: buckets.map((b) => ({ date: b.date, value: b.mau }))
|
||||||
|
}
|
||||||
|
]);
|
||||||
|
|
||||||
|
function toggleClass(value: BucketGranularity): string {
|
||||||
|
return granularity === value
|
||||||
|
? 'bg-white/15 text-gray-100'
|
||||||
|
: 'text-gray-400 hover:text-gray-200';
|
||||||
|
}
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
<section class="flex flex-col gap-3">
|
<section class="flex flex-col gap-3">
|
||||||
@@ -100,4 +151,48 @@
|
|||||||
caption={`New + returning − churned (${payload.activity.newPlayers} + ${payload.activity.resurrected} − ${payload.activity.churned}).`}
|
caption={`New + returning − churned (${payload.activity.newPlayers} + ${payload.activity.resurrected} − ${payload.activity.churned}).`}
|
||||||
/>
|
/>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<div
|
||||||
|
class="flex flex-col gap-3 rounded-2xl border border-white/10 bg-white/5 p-3 text-sm text-gray-200"
|
||||||
|
>
|
||||||
|
<div class="flex flex-wrap items-center justify-between gap-2">
|
||||||
|
<div>
|
||||||
|
<p class="font-semibold text-gray-100">Weekly vs monthly players</p>
|
||||||
|
<p class="text-xs text-gray-400">
|
||||||
|
{#if latestBucket}
|
||||||
|
Latest completed {granularity === 'week' ? 'week' : 'month'}
|
||||||
|
({latestBucket.label}) ended {formatDateLabel(latestBucket.date)}: {numOrDash(latestBucket.wau)}
|
||||||
|
weekly vs {numOrDash(latestBucket.mau)} monthly
|
||||||
|
{#if stickiness !== null}
|
||||||
|
— {stickiness}% stickiness
|
||||||
|
{/if}.
|
||||||
|
{:else}
|
||||||
|
Not enough history yet.
|
||||||
|
{/if}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
<div class="flex shrink-0 gap-1 rounded-lg border border-white/10 p-0.5">
|
||||||
|
{#each granularityOptions as opt (opt.value)}
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
onclick={() => (granularity = opt.value)}
|
||||||
|
aria-pressed={granularity === opt.value}
|
||||||
|
class="rounded-md px-2.5 py-1 text-xs font-medium transition-colors {toggleClass(opt.value)}"
|
||||||
|
>
|
||||||
|
{opt.label}
|
||||||
|
</button>
|
||||||
|
{/each}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<MiniLineChart series={bucketSeries} xLabels={buckets.map((b) => b.label)} yMin={0} />
|
||||||
|
|
||||||
|
{#if stickinessDelta && priorBucket}
|
||||||
|
<p class="text-xs text-gray-400">
|
||||||
|
{comparisonLabel} {stickinessDelta.text} vs the previous
|
||||||
|
{granularity === 'week' ? 'week' : 'month'}
|
||||||
|
({priorBucket.label}).
|
||||||
|
</p>
|
||||||
|
{/if}
|
||||||
|
</div>
|
||||||
</section>
|
</section>
|
||||||
@@ -13,7 +13,10 @@
|
|||||||
let { payload, settings }: Props = $props();
|
let { payload, settings }: Props = $props();
|
||||||
|
|
||||||
const mix = $derived(payload.retention.segmentMix);
|
const mix = $derived(payload.retention.segmentMix);
|
||||||
const colors = ['#60a5fa', '#34d399', '#a78bfa', '#f59e0b', '#fb7185'];
|
// New / Core / Returning / Resurrected (recently returning) / At risk.
|
||||||
|
// "Churned" is deliberately not plotted: it counts every player idle for
|
||||||
|
// churn_days+, so it only ever grows and flattens the other series.
|
||||||
|
const colors = ['#60a5fa', '#34d399', '#a78bfa', '#f59e0b'];
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
<section class="flex flex-col gap-3">
|
<section class="flex flex-col gap-3">
|
||||||
@@ -67,7 +70,12 @@
|
|||||||
<Container class="p-4 w-full items-stretch text-left gap-2">
|
<Container class="p-4 w-full items-stretch text-left gap-2">
|
||||||
<p class="font-semibold text-gray-100">Segment mix over time</p>
|
<p class="font-semibold text-gray-100">Segment mix over time</p>
|
||||||
<p class="text-xs text-gray-400">
|
<p class="text-xs text-gray-400">
|
||||||
Active players split into new, core, returning, at-risk and churned. Total tracked:
|
Players re-segmented on each of the past 30 days, over the last
|
||||||
|
{settings.active_window_days} days of history.
|
||||||
|
New = first week. Core = {settings.core_plays_per_week}+ plays this week. Returning = active
|
||||||
|
again, recently. Resurrected = recently returning after a break of
|
||||||
|
{settings.resurrect_gap_days}+ days. At risk = {settings.at_risk_days}+ days idle; churned
|
||||||
|
({settings.churn_days}+ days idle) is counted in the tiles above instead. Total tracked:
|
||||||
{numOrDash(payload.activity.mau)} recently active.
|
{numOrDash(payload.activity.mau)} recently active.
|
||||||
</p>
|
</p>
|
||||||
<MiniLineChart
|
<MiniLineChart
|
||||||
@@ -75,8 +83,8 @@
|
|||||||
{ name: 'New', color: colors[0], points: mix.map((m) => ({ date: m.date, value: m.new })) },
|
{ name: 'New', color: colors[0], points: mix.map((m) => ({ date: m.date, value: m.new })) },
|
||||||
{ name: 'Core', color: colors[1], points: mix.map((m) => ({ date: m.date, value: m.core })) },
|
{ name: 'Core', color: colors[1], points: mix.map((m) => ({ date: m.date, value: m.core })) },
|
||||||
{ name: 'Returning', color: colors[2], points: mix.map((m) => ({ date: m.date, value: m.returning })) },
|
{ name: 'Returning', color: colors[2], points: mix.map((m) => ({ date: m.date, value: m.returning })) },
|
||||||
{ name: 'At risk', color: colors[3], points: mix.map((m) => ({ date: m.date, value: m.atRisk })) },
|
{ name: 'Resurrected', color: colors[3], points: mix.map((m) => ({ date: m.date, value: m.resurrected })) },
|
||||||
{ name: 'Churned', color: colors[4], points: mix.map((m) => ({ date: m.date, value: m.churned })) }
|
{ name: 'At risk', color: colors[4], points: mix.map((m) => ({ date: m.date, value: m.atRisk })) }
|
||||||
]}
|
]}
|
||||||
/>
|
/>
|
||||||
</Container>
|
</Container>
|
||||||
|
|||||||
@@ -21,6 +21,32 @@ export function startOfWeek(dateStr: string): string {
|
|||||||
return addDays(dateStr, -day);
|
return addDays(dateStr, -day);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** The Monday on or before `dateStr` (ISO weeks run Monday–Sunday). */
|
||||||
|
export function startOfIsoWeek(dateStr: string): string {
|
||||||
|
const day = new Date(dateStr + 'T00:00:00Z').getUTCDay(); // 0 = Sunday
|
||||||
|
return addDays(dateStr, day === 0 ? -6 : 1 - day);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* ISO-8601 week number and week-year for `dateStr`.
|
||||||
|
*
|
||||||
|
* ISO weeks start on Monday and week 1 is the week containing the first
|
||||||
|
* Thursday of the year, so a date in late December can belong to week 1 of the
|
||||||
|
* following week-year and early January can belong to week 52/53 of the
|
||||||
|
* previous one.
|
||||||
|
*/
|
||||||
|
export function isoWeek(dateStr: string): { week: number; year: number } {
|
||||||
|
const d = new Date(dateStr + 'T00:00:00Z');
|
||||||
|
const day = d.getUTCDay() || 7; // Monday = 1 … Sunday = 7
|
||||||
|
// Move to the Thursday of the same ISO week; its calendar year is the
|
||||||
|
// ISO week-year and the number of weeks since Jan 1 gives the week number.
|
||||||
|
d.setUTCDate(d.getUTCDate() + 4 - day);
|
||||||
|
const year = d.getUTCFullYear();
|
||||||
|
const yearStart = Date.UTC(year, 0, 1);
|
||||||
|
const week = Math.ceil(((d.getTime() - yearStart) / DAY_MS + 1) / 7);
|
||||||
|
return { week, year };
|
||||||
|
}
|
||||||
|
|
||||||
/** All dates from `start` to `end` inclusive. */
|
/** All dates from `start` to `end` inclusive. */
|
||||||
export function dateRange(start: string, end: string): string[] {
|
export function dateRange(start: string, end: string): string[] {
|
||||||
const out: string[] = [];
|
const out: string[] = [];
|
||||||
|
|||||||
@@ -1,12 +1,16 @@
|
|||||||
import type {
|
import type {
|
||||||
|
ActivityBucket,
|
||||||
|
BucketGranularity,
|
||||||
BookStat,
|
BookStat,
|
||||||
CohortRow,
|
CohortRow,
|
||||||
CompletionRow,
|
CompletionRow,
|
||||||
HistogramBin,
|
HistogramBin,
|
||||||
VerseRow
|
ProjectionPoint,
|
||||||
|
VerseRow,
|
||||||
|
WauProjection
|
||||||
} from '$lib/types/stats';
|
} from '$lib/types/stats';
|
||||||
import { bibleBooks } from '$lib/types/bible';
|
import { bibleBooks } from '$lib/types/bible';
|
||||||
import { addDays, dateRange, dayDiff, startOfWeek } from './dates';
|
import { addDays, dateRange, dayDiff, isoWeek, startOfIsoWeek, startOfWeek } from './dates';
|
||||||
|
|
||||||
// ── internal helpers ─────────────────────────────────────────────────────────
|
// ── internal helpers ─────────────────────────────────────────────────────────
|
||||||
|
|
||||||
@@ -133,6 +137,446 @@ export function netGrowth(
|
|||||||
return { newPlayers, resurrected, churned, netGrowth: newPlayers + resurrected - churned };
|
return { newPlayers, resurrected, churned, netGrowth: newPlayers + resurrected - churned };
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Last day of the calendar month containing `dateStr`. */
|
||||||
|
function endOfMonth(dateStr: string): string {
|
||||||
|
const d = new Date(dateStr + 'T00:00:00Z');
|
||||||
|
return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 0))
|
||||||
|
.toISOString()
|
||||||
|
.slice(0, 10);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** First day of the calendar month containing `dateStr`. */
|
||||||
|
function startOfMonth(dateStr: string): string {
|
||||||
|
return `${dateStr.slice(0, 7)}-01`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* WAU vs MAU bucketed by whole calendar periods, from the first period that
|
||||||
|
* contains data up to the most recent *completed* one.
|
||||||
|
*
|
||||||
|
* Only fully completed periods are emitted, so the in-progress week/month never
|
||||||
|
* drags the series down. Weeks are ISO (Monday–Sunday); months are calendar
|
||||||
|
* months.
|
||||||
|
*
|
||||||
|
* Each bucket is anchored on its last day:
|
||||||
|
* - week buckets: `wau` is the whole calendar week, `mau` the 30 days ending it
|
||||||
|
* - month buckets: `mau` is the whole calendar month, `wau` the 7 days ending it
|
||||||
|
*/
|
||||||
|
export function activityBuckets(
|
||||||
|
completions: CompletionRow[],
|
||||||
|
asOfDate: string,
|
||||||
|
granularity: BucketGranularity
|
||||||
|
): ActivityBucket[] {
|
||||||
|
let earliest: string | null = null;
|
||||||
|
for (const c of completions) {
|
||||||
|
if (earliest === null || c.date < earliest) earliest = c.date;
|
||||||
|
}
|
||||||
|
if (earliest === null) return [];
|
||||||
|
|
||||||
|
// Period ends, most recent first while building, then reversed.
|
||||||
|
const ends: string[] = [];
|
||||||
|
const starts: string[] = [];
|
||||||
|
|
||||||
|
if (granularity === 'week') {
|
||||||
|
// The most recent completed ISO week is the one whose Sunday is on or
|
||||||
|
// before `asOfDate` (a week is complete once its Sunday has closed).
|
||||||
|
let end = addDays(startOfIsoWeek(asOfDate), 6);
|
||||||
|
while (end > asOfDate) end = addDays(end, -7);
|
||||||
|
const firstStart = startOfIsoWeek(earliest);
|
||||||
|
while (end >= firstStart) {
|
||||||
|
ends.push(end);
|
||||||
|
starts.push(addDays(end, -6));
|
||||||
|
end = addDays(end, -7);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// The most recent completed month is the one whose last day is on or
|
||||||
|
// before `asOfDate`; otherwise it is the previous month.
|
||||||
|
let end = endOfMonth(asOfDate);
|
||||||
|
if (end > asOfDate) end = endOfMonth(addDays(startOfMonth(asOfDate), -1));
|
||||||
|
const firstStart = startOfMonth(earliest);
|
||||||
|
while (end >= firstStart) {
|
||||||
|
ends.push(end);
|
||||||
|
starts.push(startOfMonth(end));
|
||||||
|
end = endOfMonth(addDays(startOfMonth(end), -1));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
ends.reverse(); // oldest first, most recent last
|
||||||
|
starts.reverse();
|
||||||
|
|
||||||
|
// Widest (earliest) window start per bucket, used to skip rows that are too
|
||||||
|
// old. Both arrays are ascending, so a completion touches a contiguous run.
|
||||||
|
const wauStart =
|
||||||
|
granularity === 'week' ? starts : ends.map((e) => addDays(e, -6));
|
||||||
|
const mauStart =
|
||||||
|
granularity === 'week' ? ends.map((e) => addDays(e, -29)) : starts;
|
||||||
|
|
||||||
|
// One pass over the rows instead of one pass per bucket. `ends` is
|
||||||
|
// ascending, so binary-search the first bucket that has not already ended;
|
||||||
|
// from there a completion touches a contiguous run until the widest window
|
||||||
|
// starts after it.
|
||||||
|
const wau = ends.map(() => new Set<string>());
|
||||||
|
const mau = ends.map(() => new Set<string>());
|
||||||
|
for (const c of completions) {
|
||||||
|
let lo = 0;
|
||||||
|
let hi = ends.length;
|
||||||
|
while (lo < hi) {
|
||||||
|
const mid = (lo + hi) >> 1;
|
||||||
|
if (ends[mid] < c.date) lo = mid + 1;
|
||||||
|
else hi = mid;
|
||||||
|
}
|
||||||
|
for (let i = lo; i < ends.length; i++) {
|
||||||
|
if (c.date < mauStart[i]) break; // too early for this and every later bucket
|
||||||
|
if (c.date >= wauStart[i]) wau[i].add(c.anonymousId);
|
||||||
|
mau[i].add(c.anonymousId);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const weeks = ends.map((e) => isoWeek(e));
|
||||||
|
const months = ends.map((e) => new Date(e + 'T00:00:00Z').getUTCMonth());
|
||||||
|
const years = ends.map((e) => new Date(e + 'T00:00:00Z').getUTCFullYear());
|
||||||
|
const spansYears =
|
||||||
|
granularity === 'week'
|
||||||
|
? new Set(weeks.map((w) => w.year)).size > 1
|
||||||
|
: new Set(years).size > 1;
|
||||||
|
|
||||||
|
return ends.map((date, i) => {
|
||||||
|
let label: string;
|
||||||
|
if (granularity === 'week') {
|
||||||
|
label = `W${weeks[i].week}${
|
||||||
|
spansYears ? ` '${String(weeks[i].year).slice(2)}` : ''
|
||||||
|
}`;
|
||||||
|
} else {
|
||||||
|
label =
|
||||||
|
new Date(date + 'T00:00:00Z').toLocaleDateString('en-US', {
|
||||||
|
month: 'short',
|
||||||
|
timeZone: 'UTC'
|
||||||
|
}) + (spansYears || months[i] === 0 ? ` ${String(years[i]).slice(2)}` : '');
|
||||||
|
}
|
||||||
|
return { date, label, wau: wau[i].size, mau: mau[i].size };
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── projection ───────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
export interface WeeklyFlow {
|
||||||
|
/** Last day (Sunday) of the ISO week. */
|
||||||
|
end: string;
|
||||||
|
wau: number;
|
||||||
|
/** Players active both this week and the previous one. */
|
||||||
|
retained: number;
|
||||||
|
/** Players active this week but not the previous one (new + resurrected). */
|
||||||
|
inflow: number;
|
||||||
|
/** First-ever players this week. */
|
||||||
|
newPlayers: number;
|
||||||
|
/** Players returning after a gap this week (inflow − newPlayers). */
|
||||||
|
resurrected: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Week-over-week flow accounting for every completed ISO week: how much of the
|
||||||
|
* previous week's active base returned, and how many active players were new to
|
||||||
|
* the active set. This is the input to the WAU projection.
|
||||||
|
*/
|
||||||
|
export function weeklyFlows(
|
||||||
|
completions: CompletionRow[],
|
||||||
|
asOfDate: string
|
||||||
|
): WeeklyFlow[] {
|
||||||
|
const weeks = activityBuckets(completions, asOfDate, 'week');
|
||||||
|
if (weeks.length === 0) return [];
|
||||||
|
const start0 = addDays(weeks[0].date, -6);
|
||||||
|
const sets = weeks.map(() => new Set<string>());
|
||||||
|
const firsts = firstPlayDates(completions);
|
||||||
|
const newCounts = weeks.map(() => 0);
|
||||||
|
for (const c of completions) {
|
||||||
|
const idx = Math.floor(dayDiff(start0, c.date) / 7);
|
||||||
|
if (idx >= 0 && idx < sets.length) sets[idx].add(c.anonymousId);
|
||||||
|
}
|
||||||
|
for (const first of firsts.values()) {
|
||||||
|
const idx = Math.floor(dayDiff(start0, first) / 7);
|
||||||
|
if (idx >= 0 && idx < newCounts.length) newCounts[idx]++;
|
||||||
|
}
|
||||||
|
|
||||||
|
const out: WeeklyFlow[] = [];
|
||||||
|
for (let i = 0; i < weeks.length; i++) {
|
||||||
|
const current = sets[i];
|
||||||
|
const previous = i > 0 ? sets[i - 1] : null;
|
||||||
|
let retained = 0;
|
||||||
|
if (previous) {
|
||||||
|
for (const id of current) if (previous.has(id)) retained++;
|
||||||
|
}
|
||||||
|
const newPlayers = newCounts[i];
|
||||||
|
const inflow = current.size - retained;
|
||||||
|
out.push({
|
||||||
|
end: weeks[i].date,
|
||||||
|
wau: current.size,
|
||||||
|
retained,
|
||||||
|
inflow,
|
||||||
|
newPlayers,
|
||||||
|
resurrected: Math.max(0, inflow - newPlayers)
|
||||||
|
});
|
||||||
|
}
|
||||||
|
return out;
|
||||||
|
}
|
||||||
|
|
||||||
|
function meanOf(xs: number[]): number {
|
||||||
|
return xs.length ? xs.reduce((sum, x) => sum + x, 0) / xs.length : 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Ordinary least squares with a tiny ridge term for collinear features. */
|
||||||
|
function fitOls(X: number[][], y: number[], ridge = 1e-6): number[] | null {
|
||||||
|
const p = X[0]?.length ?? 0;
|
||||||
|
if (p === 0 || X.length < p) return null;
|
||||||
|
const A: number[][] = Array.from({ length: p }, () => Array(p).fill(0));
|
||||||
|
const b: number[] = Array(p).fill(0);
|
||||||
|
for (let i = 0; i < X.length; i++) {
|
||||||
|
for (let a = 0; a < p; a++) {
|
||||||
|
b[a] += X[i][a] * y[i];
|
||||||
|
for (let c = 0; c <= a; c++) A[a][c] += X[i][a] * X[i][c];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (let a = 0; a < p; a++) {
|
||||||
|
for (let c = a + 1; c < p; c++) A[a][c] = A[c][a];
|
||||||
|
A[a][a] += ridge;
|
||||||
|
}
|
||||||
|
return solveLinear(A, b);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Gaussian elimination with partial pivoting. Mutates `A`/`b`. */
|
||||||
|
function solveLinear(A: number[][], b: number[]): number[] | null {
|
||||||
|
const n = A.length;
|
||||||
|
for (let col = 0; col < n; col++) {
|
||||||
|
let pivot = col;
|
||||||
|
for (let r = col + 1; r < n; r++) {
|
||||||
|
if (Math.abs(A[r][col]) > Math.abs(A[pivot][col])) pivot = r;
|
||||||
|
}
|
||||||
|
if (Math.abs(A[pivot][col]) < 1e-9) return null;
|
||||||
|
[A[col], A[pivot]] = [A[pivot], A[col]];
|
||||||
|
[b[col], b[pivot]] = [b[pivot], b[col]];
|
||||||
|
const d = A[col][col];
|
||||||
|
for (let c = col; c < n; c++) A[col][c] /= d;
|
||||||
|
b[col] /= d;
|
||||||
|
for (let r = 0; r < n; r++) {
|
||||||
|
if (r === col) continue;
|
||||||
|
const f = A[r][col];
|
||||||
|
if (f === 0) continue;
|
||||||
|
for (let c = col; c < n; c++) A[r][c] -= f * A[col][c];
|
||||||
|
b[r] -= f * b[col];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return b;
|
||||||
|
}
|
||||||
|
|
||||||
|
function dot(beta: number[], x: number[]): number {
|
||||||
|
let sum = 0;
|
||||||
|
for (let i = 0; i < beta.length; i++) sum += beta[i] * x[i];
|
||||||
|
return sum;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Weeks in a year, for the annual harmonic terms. */
|
||||||
|
const SEASONAL_PERIOD = 365.25 / 7;
|
||||||
|
|
||||||
|
/** One annual harmonic (a single sine/cosine pair) keeps the fit stable on <2y. */
|
||||||
|
function seasonalFeatures(t: number): number[] {
|
||||||
|
const w = (2 * Math.PI * t) / SEASONAL_PERIOD;
|
||||||
|
return [1, t, Math.sin(w), Math.cos(w)];
|
||||||
|
}
|
||||||
|
|
||||||
|
/** How quickly extrapolated trend is damped (per projected week). */
|
||||||
|
const TREND_DAMPING = 0.85;
|
||||||
|
|
||||||
|
function percentile(sorted: number[], p: number): number {
|
||||||
|
return sorted[Math.min(sorted.length - 1, Math.round(p * (sorted.length - 1)))];
|
||||||
|
}
|
||||||
|
|
||||||
|
function summarize(paths: number[][], horizonWeeks: number) {
|
||||||
|
const lows: number[] = [];
|
||||||
|
const highs: number[] = [];
|
||||||
|
for (let k = 0; k < horizonWeeks; k++) {
|
||||||
|
const column = paths.map((path) => path[k]).sort((a, b) => a - b);
|
||||||
|
lows.push(percentile(column, 0.1));
|
||||||
|
highs.push(percentile(column, 0.9));
|
||||||
|
}
|
||||||
|
return { lows, highs };
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Project weekly active users forward using three methods, all fitted over the
|
||||||
|
* full completed-week history:
|
||||||
|
*
|
||||||
|
* - flow: `WAU(t+1) = retention × WAU(t) + inflow`, with a bootstrap band
|
||||||
|
* - regression: distributed lag on lagged WAU and contemporaneous inflow
|
||||||
|
* - seasonal: harmonic (annual Fourier) regression with a damped trend
|
||||||
|
*
|
||||||
|
* The flow model is the structural guard against the classic linear overshoot:
|
||||||
|
* retention < 1 makes it converge to `inflow / (1 - retention)`.
|
||||||
|
*/
|
||||||
|
export function projectWau(
|
||||||
|
completions: CompletionRow[],
|
||||||
|
asOfDate: string,
|
||||||
|
horizonWeeks = 8
|
||||||
|
): WauProjection | null {
|
||||||
|
const flows = weeklyFlows(completions, asOfDate);
|
||||||
|
const n = flows.length;
|
||||||
|
if (n < 3) return null;
|
||||||
|
|
||||||
|
const last = flows[n - 1];
|
||||||
|
const SIMS = 1000;
|
||||||
|
let seed = 0x2f6e2b1;
|
||||||
|
const rand = () => {
|
||||||
|
// xorshift32: deterministic and good enough for a UI band.
|
||||||
|
seed ^= seed << 13;
|
||||||
|
seed ^= seed >>> 17;
|
||||||
|
seed ^= seed << 5;
|
||||||
|
return (seed >>> 0) / 0xffffffff;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Recency-weighted flow parameters over the whole history (13-week half-life).
|
||||||
|
const HALF_LIFE = 13;
|
||||||
|
let wsum = 0;
|
||||||
|
let retSum = 0;
|
||||||
|
let inSum = 0;
|
||||||
|
let newSum = 0;
|
||||||
|
let resSum = 0;
|
||||||
|
const samples: { retention: number; inflow: number }[] = [];
|
||||||
|
for (let i = 1; i < n; i++) {
|
||||||
|
const w = Math.pow(0.5, (n - 1 - i) / HALF_LIFE);
|
||||||
|
const prev = flows[i - 1];
|
||||||
|
const ret = prev.wau > 0 ? flows[i].retained / prev.wau : 0;
|
||||||
|
wsum += w;
|
||||||
|
retSum += w * ret;
|
||||||
|
inSum += w * flows[i].inflow;
|
||||||
|
newSum += w * flows[i].newPlayers;
|
||||||
|
resSum += w * flows[i].resurrected;
|
||||||
|
samples.push({ retention: ret, inflow: flows[i].inflow });
|
||||||
|
}
|
||||||
|
const retention = wsum > 0 ? retSum / wsum : 0;
|
||||||
|
const inflow = wsum > 0 ? inSum / wsum : 0;
|
||||||
|
const meanNew = wsum > 0 ? newSum / wsum : 0;
|
||||||
|
const meanRes = wsum > 0 ? resSum / wsum : 0;
|
||||||
|
|
||||||
|
// Future ISO-week dates, with the year only when it actually changes.
|
||||||
|
const futureDates = Array.from({ length: horizonWeeks }, (_, k) =>
|
||||||
|
addDays(last.end, 7 * (k + 1))
|
||||||
|
);
|
||||||
|
const lastYear = isoWeek(last.end).year;
|
||||||
|
const needsYear = futureDates.some((d) => isoWeek(d).year !== lastYear);
|
||||||
|
const labelFor = (date: string) => {
|
||||||
|
const { week, year } = isoWeek(date);
|
||||||
|
return `W${week}${needsYear ? ` '${String(year).slice(2)}` : ''}`;
|
||||||
|
};
|
||||||
|
const toPoints = (values: number[], lows: number[], highs: number[]): ProjectionPoint[] =>
|
||||||
|
values.map((v, k) => {
|
||||||
|
const value = Math.round(v);
|
||||||
|
return {
|
||||||
|
date: futureDates[k],
|
||||||
|
label: labelFor(futureDates[k]),
|
||||||
|
value,
|
||||||
|
low: Math.round(Math.min(lows[k], value)),
|
||||||
|
high: Math.round(Math.max(highs[k], value))
|
||||||
|
};
|
||||||
|
});
|
||||||
|
|
||||||
|
const wauY = flows.map((f) => f.wau);
|
||||||
|
|
||||||
|
// ── 1. Flow model + bootstrap band ──────────────────────────────────────
|
||||||
|
const flowPoint: number[] = [];
|
||||||
|
let wau = last.wau;
|
||||||
|
for (let k = 0; k < horizonWeeks; k++) {
|
||||||
|
wau = retention * wau + inflow;
|
||||||
|
flowPoint.push(Math.max(0, wau));
|
||||||
|
}
|
||||||
|
const flowPaths = Array.from({ length: SIMS }, () => {
|
||||||
|
let value = last.wau;
|
||||||
|
const path: number[] = [];
|
||||||
|
for (let k = 0; k < horizonWeeks; k++) {
|
||||||
|
const picked = samples[Math.floor(rand() * samples.length)];
|
||||||
|
value = picked.retention * value + picked.inflow;
|
||||||
|
path.push(Math.max(0, value));
|
||||||
|
}
|
||||||
|
return path;
|
||||||
|
});
|
||||||
|
|
||||||
|
// ── 2. Distributed-lag regression ───────────────────────────────────────
|
||||||
|
// Uses contemporaneous new/resurrected inflow, not lagged: WAU(t) is itself
|
||||||
|
// retained(t) + new(t) + resurrected(t). With lagged inflow (an earlier
|
||||||
|
// version) the autoregressive coefficient was the only real driver, so the
|
||||||
|
// projection decayed geometrically toward zero.
|
||||||
|
const regX: number[][] = [];
|
||||||
|
const regY: number[] = [];
|
||||||
|
for (let i = 1; i < n; i++) {
|
||||||
|
regX.push([1, flows[i - 1].wau, flows[i].newPlayers, flows[i].resurrected]);
|
||||||
|
regY.push(flows[i].wau);
|
||||||
|
}
|
||||||
|
const regBeta = fitOls(regX, regY);
|
||||||
|
const regResiduals = regBeta ? regY.map((y, i) => y - dot(regBeta, regX[i])) : [];
|
||||||
|
const runRegression = (sampled: boolean): number[] => {
|
||||||
|
const path: number[] = [];
|
||||||
|
let prev = last.wau;
|
||||||
|
for (let k = 0; k < horizonWeeks; k++) {
|
||||||
|
let pred = regBeta
|
||||||
|
? dot(regBeta, [1, prev, meanNew, meanRes])
|
||||||
|
: retention * prev + meanNew + meanRes;
|
||||||
|
if (sampled && regResiduals.length) {
|
||||||
|
pred += regResiduals[Math.floor(rand() * regResiduals.length)];
|
||||||
|
}
|
||||||
|
pred = Math.max(0, pred);
|
||||||
|
path.push(pred);
|
||||||
|
prev = pred;
|
||||||
|
}
|
||||||
|
return path;
|
||||||
|
};
|
||||||
|
const regressionPoint = runRegression(false);
|
||||||
|
const regressionPaths = Array.from({ length: SIMS }, () => runRegression(true));
|
||||||
|
|
||||||
|
// ── 3. Seasonality-aware harmonic regression ────────────────────────────
|
||||||
|
// A partial year cannot separate growth from seasonality, so only one annual
|
||||||
|
// harmonic is used and the linear trend is damped during projection. Without
|
||||||
|
// that, trend and annual cycle double-count the same rise and the forecast
|
||||||
|
// marches upward.
|
||||||
|
const seasonX = flows.map((_, i) => seasonalFeatures(i));
|
||||||
|
const seasonBeta = fitOls(seasonX, wauY);
|
||||||
|
const seasonResiduals = seasonBeta ? wauY.map((y, i) => y - dot(seasonBeta, seasonX[i])) : [0];
|
||||||
|
const seasonalBase: number[] = [];
|
||||||
|
let dampedTime = n - 1;
|
||||||
|
for (let k = 0; k < horizonWeeks; k++) {
|
||||||
|
dampedTime += Math.pow(TREND_DAMPING, k + 1);
|
||||||
|
if (seasonBeta) {
|
||||||
|
const w = (2 * Math.PI * (n + k)) / SEASONAL_PERIOD;
|
||||||
|
seasonalBase.push(
|
||||||
|
seasonBeta[0] +
|
||||||
|
seasonBeta[1] * dampedTime +
|
||||||
|
seasonBeta[2] * Math.sin(w) +
|
||||||
|
seasonBeta[3] * Math.cos(w)
|
||||||
|
);
|
||||||
|
} else {
|
||||||
|
seasonalBase.push(meanOf(wauY));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const seasonalPoint = seasonalBase.map((v) => Math.max(0, v));
|
||||||
|
const seasonalPaths = Array.from({ length: SIMS }, () => {
|
||||||
|
const path: number[] = [];
|
||||||
|
for (let k = 0; k < horizonWeeks; k++) {
|
||||||
|
const resid = seasonResiduals[Math.floor(rand() * seasonResiduals.length)];
|
||||||
|
path.push(Math.max(0, seasonalBase[k] + resid));
|
||||||
|
}
|
||||||
|
return path;
|
||||||
|
});
|
||||||
|
|
||||||
|
const flowBand = summarize(flowPaths, horizonWeeks);
|
||||||
|
const regressionBand = summarize(regressionPaths, horizonWeeks);
|
||||||
|
const seasonalBand = summarize(seasonalPaths, horizonWeeks);
|
||||||
|
|
||||||
|
return {
|
||||||
|
horizonWeeks,
|
||||||
|
retention: Math.round(retention * 1000) / 1000,
|
||||||
|
inflow: Math.round(inflow),
|
||||||
|
sampleWeeks: n,
|
||||||
|
flow: toPoints(flowPoint, flowBand.lows, flowBand.highs),
|
||||||
|
regression: toPoints(regressionPoint, regressionBand.lows, regressionBand.highs),
|
||||||
|
seasonal: toPoints(seasonalPoint, seasonalBand.lows, seasonalBand.highs)
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
// ── retention ────────────────────────────────────────────────────────────────
|
// ── retention ────────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -27,6 +27,7 @@ import { deriveSegments, countSegments } from './segments';
|
|||||||
import { evaluateSignals } from './signals';
|
import { evaluateSignals } from './signals';
|
||||||
import {
|
import {
|
||||||
activePlayers,
|
activePlayers,
|
||||||
|
activityBuckets,
|
||||||
averageGuesses,
|
averageGuesses,
|
||||||
bookCoverage,
|
bookCoverage,
|
||||||
cohortTriangle,
|
cohortTriangle,
|
||||||
@@ -39,6 +40,7 @@ import {
|
|||||||
netGrowth,
|
netGrowth,
|
||||||
newVsReturning,
|
newVsReturning,
|
||||||
overallReturnRate,
|
overallReturnRate,
|
||||||
|
projectWau,
|
||||||
repeatIntervals,
|
repeatIntervals,
|
||||||
retentionByGuessBucket,
|
retentionByGuessBucket,
|
||||||
streakSurvival,
|
streakSurvival,
|
||||||
@@ -53,7 +55,7 @@ export type BuildKind = 'scheduled' | 'lazy' | 'reconstructed';
|
|||||||
* Bump whenever the snapshot payload shape changes. Older snapshots are
|
* Bump whenever the snapshot payload shape changes. Older snapshots are
|
||||||
* rebuilt lazily so the UI never reads a stale shape.
|
* rebuilt lazily so the UI never reads a stale shape.
|
||||||
*/
|
*/
|
||||||
export const PAYLOAD_SCHEMA_VERSION = 4;
|
export const PAYLOAD_SCHEMA_VERSION = 9;
|
||||||
|
|
||||||
const RETENTION_WINDOW_DAYS = 180;
|
const RETENTION_WINDOW_DAYS = 180;
|
||||||
const SERIES_DAYS = 90;
|
const SERIES_DAYS = 90;
|
||||||
@@ -271,7 +273,12 @@ function buildActivity(
|
|||||||
churned: growth.churned,
|
churned: growth.churned,
|
||||||
netGrowth: growth.netGrowth,
|
netGrowth: growth.netGrowth,
|
||||||
corePrevious,
|
corePrevious,
|
||||||
previous
|
previous,
|
||||||
|
stickiness: {
|
||||||
|
week: activityBuckets(pointCompletions, asOfDate, 'week'),
|
||||||
|
month: activityBuckets(pointCompletions, asOfDate, 'month')
|
||||||
|
},
|
||||||
|
projection: projectWau(pointCompletions, asOfDate)
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -136,6 +136,60 @@ export interface BookStat {
|
|||||||
d1Return: number | null;
|
d1Return: number | null;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Calendar period used to bucket the WAU/MAU comparison. */
|
||||||
|
export type BucketGranularity = 'week' | 'month';
|
||||||
|
|
||||||
|
export interface ActivityBucket {
|
||||||
|
/** Last day of the calendar period, inclusive. */
|
||||||
|
date: string;
|
||||||
|
/** Axis label: "W36 '26" for ISO weeks, or a month name for months. */
|
||||||
|
label: string;
|
||||||
|
/**
|
||||||
|
* Distinct players in the bucket's weekly window: the whole ISO week for
|
||||||
|
* week buckets, or the 7 days ending on `date` for month buckets.
|
||||||
|
*/
|
||||||
|
wau: number;
|
||||||
|
/**
|
||||||
|
* Distinct players in the bucket's monthly window: the 30 days ending on
|
||||||
|
* `date` for week buckets, or the whole calendar month for month buckets.
|
||||||
|
*/
|
||||||
|
mau: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** One future week in a WAU projection. */
|
||||||
|
export interface ProjectionPoint {
|
||||||
|
date: string;
|
||||||
|
label: string;
|
||||||
|
/** Point estimate (or p50 for the range view). */
|
||||||
|
value: number;
|
||||||
|
/** p10 lower bound (equals `value` for the point models). */
|
||||||
|
low: number;
|
||||||
|
/** p90 upper bound (equals `value` for the point models). */
|
||||||
|
high: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Forward view of weekly active users. Three methods are produced so the UI can
|
||||||
|
* toggle between them: a flow/retention model (with a bootstrap p10–p90 band),
|
||||||
|
* a distributed-lag regression, and a seasonality-aware harmonic regression.
|
||||||
|
*/
|
||||||
|
export interface WauProjection {
|
||||||
|
/** Number of future weeks projected. */
|
||||||
|
horizonWeeks: number;
|
||||||
|
/** Recency-weighted week-over-week retention used by the flow model (0..1). */
|
||||||
|
retention: number;
|
||||||
|
/** Recency-weighted weekly inflow: players active who were not active before. */
|
||||||
|
inflow: number;
|
||||||
|
/** Completed weeks of history available to the models. */
|
||||||
|
sampleWeeks: number;
|
||||||
|
/** Flow model with a bootstrap p10–p90 band. */
|
||||||
|
flow: ProjectionPoint[];
|
||||||
|
/** Distributed-lag regression on lagged WAU and contemporaneous new/resurrected. */
|
||||||
|
regression: ProjectionPoint[];
|
||||||
|
/** Harmonic (annual Fourier) regression with a damped linear trend. */
|
||||||
|
seasonal: ProjectionPoint[];
|
||||||
|
}
|
||||||
|
|
||||||
export interface Activity {
|
export interface Activity {
|
||||||
dau: number;
|
dau: number;
|
||||||
wau: number;
|
wau: number;
|
||||||
@@ -155,6 +209,13 @@ export interface Activity {
|
|||||||
mau: number;
|
mau: number;
|
||||||
core: number;
|
core: number;
|
||||||
} | null;
|
} | null;
|
||||||
|
/**
|
||||||
|
* WAU vs MAU by completed calendar period, most recent last. Optional so
|
||||||
|
* payloads stored before this field existed still typecheck.
|
||||||
|
*/
|
||||||
|
stickiness?: Record<BucketGranularity, ActivityBucket[]>;
|
||||||
|
/** Forward WAU projection (trend / flow / range). Optional for old payloads. */
|
||||||
|
projection?: WauProjection | null;
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface Kpis {
|
export interface Kpis {
|
||||||
@@ -204,6 +265,19 @@ export interface HabitData {
|
|||||||
weekdayHour: number[][];
|
weekdayHour: number[][];
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Safe, all-time aggregates rendered by the public community stats widget. */
|
||||||
|
export interface CommunityStatsData {
|
||||||
|
asOfDate: string;
|
||||||
|
completions: number;
|
||||||
|
players: number;
|
||||||
|
weeklyPlayers: number;
|
||||||
|
monthlyPlayers: number;
|
||||||
|
yesterdayCompletions: number;
|
||||||
|
yesterdayAvgGuesses: number | null;
|
||||||
|
bestDayAllTime: { date: string; count: number } | null;
|
||||||
|
calendar: { date: string; count: number }[];
|
||||||
|
}
|
||||||
|
|
||||||
export interface SnapshotPayload {
|
export interface SnapshotPayload {
|
||||||
asOfDate: string;
|
asOfDate: string;
|
||||||
activity: Activity;
|
activity: Activity;
|
||||||
|
|||||||
@@ -2,19 +2,39 @@
|
|||||||
import type { PageData } from './$types';
|
import type { PageData } from './$types';
|
||||||
import ConsoleChrome from '$lib/components/stats/ConsoleChrome.svelte';
|
import ConsoleChrome from '$lib/components/stats/ConsoleChrome.svelte';
|
||||||
import Pulse from '$lib/components/stats/Pulse.svelte';
|
import Pulse from '$lib/components/stats/Pulse.svelte';
|
||||||
|
import Projection from '$lib/components/stats/Projection.svelte';
|
||||||
import GrowthLoop from '$lib/components/stats/GrowthLoop.svelte';
|
import GrowthLoop from '$lib/components/stats/GrowthLoop.svelte';
|
||||||
import RetentionLab from '$lib/components/stats/RetentionLab.svelte';
|
import RetentionLab from '$lib/components/stats/RetentionLab.svelte';
|
||||||
import VerseMixLab from '$lib/components/stats/VerseMixLab.svelte';
|
// VerseMixLab hidden for now.
|
||||||
|
// import VerseMixLab from '$lib/components/stats/VerseMixLab.svelte';
|
||||||
import HabitLab from '$lib/components/stats/HabitLab.svelte';
|
import HabitLab from '$lib/components/stats/HabitLab.svelte';
|
||||||
import SignalsFeed from '$lib/components/stats/SignalsFeed.svelte';
|
import SignalsFeed from '$lib/components/stats/SignalsFeed.svelte';
|
||||||
import FeatureImpact from '$lib/components/stats/FeatureImpact.svelte';
|
import FeatureImpact from '$lib/components/stats/FeatureImpact.svelte';
|
||||||
import Glossary from '$lib/components/stats/Glossary.svelte';
|
import Glossary from '$lib/components/stats/Glossary.svelte';
|
||||||
|
import CommunityStats from '$lib/components/stats/CommunityStats.svelte';
|
||||||
import Container from '$lib/components/Container.svelte';
|
import Container from '$lib/components/Container.svelte';
|
||||||
import { numOrDash } from '$lib/utils/stats-format';
|
import { numOrDash } from '$lib/utils/stats-format';
|
||||||
|
import type { CommunityStatsData } from '$lib/types/stats';
|
||||||
|
|
||||||
let { data }: { data: PageData } = $props();
|
let { data }: { data: PageData } = $props();
|
||||||
|
|
||||||
const segments = $derived(data.segmentCounts);
|
const segments = $derived(data.segmentCounts);
|
||||||
|
|
||||||
|
// The public community view lives at the top of the console too. The verse
|
||||||
|
// card is intentionally omitted here.
|
||||||
|
const community = $derived.by(
|
||||||
|
(): CommunityStatsData => ({
|
||||||
|
asOfDate: data.payload.asOfDate,
|
||||||
|
completions: data.payload.totals.completions,
|
||||||
|
players: data.payload.totals.players,
|
||||||
|
weeklyPlayers: data.payload.activity.wau,
|
||||||
|
monthlyPlayers: data.payload.activity.mau,
|
||||||
|
yesterdayCompletions: data.payload.totals.yesterdayCompletions,
|
||||||
|
yesterdayAvgGuesses: data.payload.totals.yesterdayAvgGuesses,
|
||||||
|
bestDayAllTime: data.payload.totals.bestDay,
|
||||||
|
calendar: data.payload.habit.calendar
|
||||||
|
})
|
||||||
|
);
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
<svelte:head>
|
<svelte:head>
|
||||||
@@ -24,6 +44,8 @@
|
|||||||
|
|
||||||
<div class="min-h-screen bg-gray-950 p-4 md:p-6">
|
<div class="min-h-screen bg-gray-950 p-4 md:p-6">
|
||||||
<div class="mx-auto flex max-w-6xl flex-col gap-8 pb-16">
|
<div class="mx-auto flex max-w-6xl flex-col gap-8 pb-16">
|
||||||
|
<CommunityStats data={community} tone="dark" />
|
||||||
|
|
||||||
<ConsoleChrome
|
<ConsoleChrome
|
||||||
date={data.date}
|
date={data.date}
|
||||||
today={data.today}
|
today={data.today}
|
||||||
@@ -41,6 +63,8 @@
|
|||||||
topSignal={data.topSignal}
|
topSignal={data.topSignal}
|
||||||
/>
|
/>
|
||||||
|
|
||||||
|
<Projection payload={data.payload} />
|
||||||
|
|
||||||
<section class="flex flex-col gap-3">
|
<section class="flex flex-col gap-3">
|
||||||
<h2 class="text-lg font-bold text-gray-100">Segment mix (as of this date)</h2>
|
<h2 class="text-lg font-bold text-gray-100">Segment mix (as of this date)</h2>
|
||||||
<div class="grid grid-cols-2 gap-3 sm:grid-cols-3 lg:grid-cols-6">
|
<div class="grid grid-cols-2 gap-3 sm:grid-cols-3 lg:grid-cols-6">
|
||||||
@@ -66,7 +90,8 @@
|
|||||||
|
|
||||||
<GrowthLoop payload={data.payload} />
|
<GrowthLoop payload={data.payload} />
|
||||||
<RetentionLab payload={data.payload} settings={data.settings} />
|
<RetentionLab payload={data.payload} settings={data.settings} />
|
||||||
<VerseMixLab payload={data.payload} />
|
<!-- VerseMixLab hidden for now. -->
|
||||||
|
<!-- <VerseMixLab payload={data.payload} /> -->
|
||||||
<HabitLab payload={data.payload} />
|
<HabitLab payload={data.payload} />
|
||||||
<SignalsFeed signals={data.payload.signals} />
|
<SignalsFeed signals={data.payload.signals} />
|
||||||
<FeatureImpact />
|
<FeatureImpact />
|
||||||
|
|||||||
@@ -1,6 +1,9 @@
|
|||||||
import type { PageServerLoad } from './$types';
|
import type { PageServerLoad } from './$types';
|
||||||
import { ensureSnapshot } from '$lib/server/stats/snapshot';
|
import { ensureSnapshot } from '$lib/server/stats/snapshot';
|
||||||
import { latestClosedDate } from '$lib/server/stats/dates';
|
import { latestClosedDate } from '$lib/server/stats/dates';
|
||||||
|
import { db } from '$lib/server/db';
|
||||||
|
import { dailyVerses } from '$lib/server/db/schema';
|
||||||
|
import { eq } from 'drizzle-orm';
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Slim public community widget. Reads the latest completed daily snapshot and
|
* Slim public community widget. Reads the latest completed daily snapshot and
|
||||||
@@ -10,8 +13,26 @@ export const load: PageServerLoad = async () => {
|
|||||||
const snapshot = await ensureSnapshot(latestClosedDate());
|
const snapshot = await ensureSnapshot(latestClosedDate());
|
||||||
const payload = snapshot.payload;
|
const payload = snapshot.payload;
|
||||||
|
|
||||||
|
// The verse itself is public content (it was served to everyone), so showing
|
||||||
|
// it here is safe. A missing row or lookup failure just hides the card.
|
||||||
|
let verse: { reference: string; verseText: string } | null = null;
|
||||||
|
try {
|
||||||
|
const [row] = await db
|
||||||
|
.select({
|
||||||
|
reference: dailyVerses.reference,
|
||||||
|
verseText: dailyVerses.verseText
|
||||||
|
})
|
||||||
|
.from(dailyVerses)
|
||||||
|
.where(eq(dailyVerses.date, payload.asOfDate))
|
||||||
|
.limit(1);
|
||||||
|
verse = row ?? null;
|
||||||
|
} catch (err) {
|
||||||
|
console.error('Failed to load community verse', err);
|
||||||
|
}
|
||||||
|
|
||||||
return {
|
return {
|
||||||
asOfDate: payload.asOfDate,
|
asOfDate: payload.asOfDate,
|
||||||
|
verse: verse ?? null,
|
||||||
completions: payload.totals.completions,
|
completions: payload.totals.completions,
|
||||||
players: payload.totals.players,
|
players: payload.totals.players,
|
||||||
weeklyPlayers: payload.activity.wau,
|
weeklyPlayers: payload.activity.wau,
|
||||||
@@ -19,6 +40,6 @@ export const load: PageServerLoad = async () => {
|
|||||||
yesterdayCompletions: payload.totals.yesterdayCompletions,
|
yesterdayCompletions: payload.totals.yesterdayCompletions,
|
||||||
yesterdayAvgGuesses: payload.totals.yesterdayAvgGuesses,
|
yesterdayAvgGuesses: payload.totals.yesterdayAvgGuesses,
|
||||||
bestDayAllTime: payload.totals.bestDay,
|
bestDayAllTime: payload.totals.bestDay,
|
||||||
calendar: payload.habit.calendar.slice(-90)
|
calendar: payload.habit.calendar
|
||||||
};
|
};
|
||||||
};
|
};
|
||||||
+19
-117
@@ -1,132 +1,34 @@
|
|||||||
<script lang="ts">
|
<script lang="ts">
|
||||||
import type { PageData } from './$types';
|
import type { PageData } from './$types';
|
||||||
import Container from '$lib/components/Container.svelte';
|
import Container from '$lib/components/Container.svelte';
|
||||||
import CalendarHeatmap from '$lib/components/charts/CalendarHeatmap.svelte';
|
import CommunityStats from '$lib/components/stats/CommunityStats.svelte';
|
||||||
import { formatDateLabel, numOrDash } from '$lib/utils/stats-format';
|
import { formatDateLabel } from '$lib/utils/stats-format';
|
||||||
|
|
||||||
let { data }: { data: PageData } = $props();
|
let { data }: { data: PageData } = $props();
|
||||||
|
|
||||||
const calendar = $derived(data.calendar);
|
|
||||||
const active = $derived(calendar.filter((d) => d.count > 0));
|
|
||||||
|
|
||||||
const total = $derived(calendar.reduce((sum, d) => sum + d.count, 0));
|
|
||||||
const avgPerDay = $derived(calendar.length ? total / calendar.length : 0);
|
|
||||||
|
|
||||||
const bestDay = $derived(
|
|
||||||
active.reduce<{ date: string; count: number } | null>(
|
|
||||||
(best, d) => (best === null || d.count > best.count ? d : best),
|
|
||||||
null
|
|
||||||
)
|
|
||||||
);
|
|
||||||
const worstDay = $derived(
|
|
||||||
active.reduce<{ date: string; count: number } | null>(
|
|
||||||
(worst, d) => (worst === null || d.count < worst.count ? d : worst),
|
|
||||||
null
|
|
||||||
)
|
|
||||||
);
|
|
||||||
const medianDay = $derived.by(() => {
|
|
||||||
if (active.length === 0) return null;
|
|
||||||
const sorted = [...active].sort((a, b) => a.count - b.count);
|
|
||||||
return sorted[Math.floor((sorted.length - 1) / 2)];
|
|
||||||
});
|
|
||||||
|
|
||||||
/** Compact enough to sit inside a day square. */
|
|
||||||
function compactCount(n: number): string {
|
|
||||||
if (n >= 10000) return `${Math.round(n / 1000)}k`;
|
|
||||||
if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;
|
|
||||||
return String(n);
|
|
||||||
}
|
|
||||||
|
|
||||||
const annotations = $derived.by(() => {
|
|
||||||
const out: Record<string, string> = {};
|
|
||||||
for (const day of [bestDay, medianDay, worstDay]) {
|
|
||||||
if (day) out[day.date] = compactCount(day.count);
|
|
||||||
}
|
|
||||||
return out;
|
|
||||||
});
|
|
||||||
</script>
|
</script>
|
||||||
|
|
||||||
<svelte:head>
|
<svelte:head>
|
||||||
<title>Community Stats | Bibdle</title>
|
<title>Community Stats | BIBDLE</title>
|
||||||
<meta name="description" content="Bibdle community statistics, as of the latest completed day." />
|
<meta name="description" content="BIBDLE community statistics, as of the latest completed day." />
|
||||||
</svelte:head>
|
</svelte:head>
|
||||||
|
|
||||||
<div class="mx-auto max-w-3xl px-4 py-8">
|
<div class="mx-auto max-w-3xl px-4 py-8">
|
||||||
<div class="mb-6 text-center">
|
<CommunityStats data={data} />
|
||||||
<h1 class="text-3xl font-bold text-gray-900 dark:text-gray-100">Community Stats</h1>
|
|
||||||
<p class="mt-1 text-sm text-gray-600 dark:text-gray-400">As of {formatDateLabel(data.asOfDate)}</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<div class="grid grid-cols-2 gap-3 md:grid-cols-3">
|
<Container class="mt-3 p-4 w-full items-stretch text-left gap-2">
|
||||||
<Container class="p-4 w-full items-start text-left">
|
<p class="font-semibold text-gray-900 dark:text-gray-100">Latest verse</p>
|
||||||
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">All-time plays</p>
|
{#if data.verse}
|
||||||
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.completions)}</p>
|
<blockquote class="text-sm leading-relaxed text-gray-700 dark:text-gray-200">
|
||||||
</Container>
|
“{data.verse.verseText}”
|
||||||
<Container class="p-4 w-full items-start text-left">
|
<cite class="mt-1 block text-xs not-italic text-gray-500 dark:text-gray-400">
|
||||||
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">All-time players</p>
|
— {data.verse.reference}
|
||||||
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.players)}</p>
|
</cite>
|
||||||
</Container>
|
</blockquote>
|
||||||
<Container class="p-4 w-full items-start text-left">
|
{:else}
|
||||||
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">Players this week</p>
|
<p class="text-sm text-gray-500 dark:text-gray-400">
|
||||||
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.weeklyPlayers)}</p>
|
Verse text unavailable for {formatDateLabel(data.asOfDate)}.
|
||||||
</Container>
|
</p>
|
||||||
<Container class="p-4 w-full items-start text-left">
|
{/if}
|
||||||
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">Players this month</p>
|
|
||||||
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.monthlyPlayers)}</p>
|
|
||||||
</Container>
|
|
||||||
<Container class="p-4 w-full items-start text-left">
|
|
||||||
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">Latest day's plays</p>
|
|
||||||
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.yesterdayCompletions)}</p>
|
|
||||||
</Container>
|
|
||||||
<Container class="p-4 w-full items-start text-left">
|
|
||||||
<p class="text-[11px] font-semibold uppercase tracking-wider text-gray-600 dark:text-gray-400">Avg guesses that day</p>
|
|
||||||
<p class="text-2xl font-bold text-gray-900 dark:text-gray-100">{numOrDash(data.yesterdayAvgGuesses)}</p>
|
|
||||||
</Container>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<Container class="mt-3 p-4 w-full items-stretch text-left gap-3">
|
|
||||||
<p class="font-semibold text-gray-900 dark:text-gray-100">Daily plays (last {calendar.length} days)</p>
|
|
||||||
<div class="flex flex-col gap-4 sm:flex-row sm:items-start">
|
|
||||||
<div class="flex flex-col gap-1">
|
|
||||||
<CalendarHeatmap data={calendar} cellSize={22} annotations={annotations} />
|
|
||||||
<p class="text-[10px] text-gray-500 dark:text-gray-400">
|
|
||||||
Numbers mark the best, median, and least popular days.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<div class="flex min-w-0 flex-1 flex-col gap-4">
|
|
||||||
<dl class="grid grid-cols-2 gap-x-4 gap-y-3 text-sm">
|
|
||||||
<div>
|
|
||||||
<dt class="text-[11px] uppercase tracking-wider text-gray-500 dark:text-gray-400">{calendar.length}-day plays</dt>
|
|
||||||
<dd class="font-semibold tabular-nums text-gray-900 dark:text-gray-100">{numOrDash(total)}</dd>
|
|
||||||
</div>
|
|
||||||
<div>
|
|
||||||
<dt class="text-[11px] uppercase tracking-wider text-gray-500 dark:text-gray-400">Daily average</dt>
|
|
||||||
<dd class="font-semibold tabular-nums text-gray-900 dark:text-gray-100">
|
|
||||||
{avgPerDay.toLocaleString('en-US', { maximumFractionDigits: 1 })}
|
|
||||||
</dd>
|
|
||||||
</div>
|
|
||||||
{#if bestDay}
|
|
||||||
<div>
|
|
||||||
<dt class="text-[11px] uppercase tracking-wider text-gray-500 dark:text-gray-400">Best day ({calendar.length}d)</dt>
|
|
||||||
<dd class="font-semibold tabular-nums text-gray-900 dark:text-gray-100">
|
|
||||||
{numOrDash(bestDay.count)}
|
|
||||||
<span class="font-normal text-gray-500 dark:text-gray-400">on {formatDateLabel(bestDay.date)}</span>
|
|
||||||
</dd>
|
|
||||||
</div>
|
|
||||||
{/if}
|
|
||||||
{#if data.bestDayAllTime}
|
|
||||||
<div>
|
|
||||||
<dt class="text-[11px] uppercase tracking-wider text-gray-500 dark:text-gray-400">Best day · all-time</dt>
|
|
||||||
<dd class="font-semibold tabular-nums text-gray-900 dark:text-gray-100">
|
|
||||||
{numOrDash(data.bestDayAllTime.count)}
|
|
||||||
<span class="font-normal text-gray-500 dark:text-gray-400">on {formatDateLabel(data.bestDayAllTime.date)}</span>
|
|
||||||
</dd>
|
|
||||||
</div>
|
|
||||||
{/if}
|
|
||||||
</dl>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
</Container>
|
</Container>
|
||||||
|
|
||||||
<p class="mt-4 text-center text-xs text-gray-500 dark:text-gray-500">
|
<p class="mt-4 text-center text-xs text-gray-500 dark:text-gray-500">
|
||||||
|
|||||||
+190
-1
@@ -17,7 +17,10 @@ import {
|
|||||||
retentionByGuessBucket,
|
retentionByGuessBucket,
|
||||||
weekdayHourHeatmap,
|
weekdayHourHeatmap,
|
||||||
cohortTriangle,
|
cohortTriangle,
|
||||||
dailyCompletionsSeries
|
dailyCompletionsSeries,
|
||||||
|
activityBuckets,
|
||||||
|
weeklyFlows,
|
||||||
|
projectWau
|
||||||
} from '$lib/server/stats/metrics';
|
} from '$lib/server/stats/metrics';
|
||||||
import type { CompletionRow } from '$lib/types/stats';
|
import type { CompletionRow } from '$lib/types/stats';
|
||||||
|
|
||||||
@@ -191,3 +194,189 @@ describe('dailyCompletionsSeries', () => {
|
|||||||
expect(series[2]).toEqual({ date: '2026-09-03', completions: 2, newPlayers: 0 });
|
expect(series[2]).toEqual({ date: '2026-09-03', completions: 2, newPlayers: 0 });
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
|
describe('activityBuckets', () => {
|
||||||
|
// 2026-09-10 is a Thursday, so its ISO week (Mon 09-07 .. Sun 09-13) is
|
||||||
|
// still in progress: the most recent completed week ends 2026-09-06 (W36).
|
||||||
|
const asOf = '2026-09-10';
|
||||||
|
|
||||||
|
test('weeks are ISO Monday–Sunday and stop at the last completed week', () => {
|
||||||
|
const rows: CompletionRow[] = [
|
||||||
|
c('mon', '2026-08-31'), // first day of the week
|
||||||
|
c('sun', '2026-09-06') // last day of the week
|
||||||
|
];
|
||||||
|
const weeks = activityBuckets(rows, asOf, 'week');
|
||||||
|
expect(weeks).toHaveLength(1);
|
||||||
|
expect(weeks[0].date).toBe('2026-09-06');
|
||||||
|
expect(weeks[0].label).toBe('W36');
|
||||||
|
expect(weeks[0].wau).toBe(2);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('spans every completed week back to the first week with data', () => {
|
||||||
|
const rows: CompletionRow[] = [
|
||||||
|
c('p1', '2026-08-20'),
|
||||||
|
c('p2', '2026-08-27'),
|
||||||
|
c('p3', '2026-09-03')
|
||||||
|
];
|
||||||
|
const weeks = activityBuckets(rows, asOf, 'week');
|
||||||
|
expect(weeks.map((b) => b.date)).toEqual(['2026-08-23', '2026-08-30', '2026-09-06']);
|
||||||
|
expect(weeks.map((b) => b.label)).toEqual(['W34', 'W35', 'W36']);
|
||||||
|
expect(weeks.map((b) => b.wau)).toEqual([1, 1, 1]);
|
||||||
|
// The trailing 30-day window reaches further back, so it grows per bucket.
|
||||||
|
expect(weeks.map((b) => b.mau)).toEqual([1, 2, 3]);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('excludes the in-progress week so a partial period cannot drag the series down', () => {
|
||||||
|
const rows: CompletionRow[] = [c('current', '2026-09-08'), c('done', '2026-09-04')];
|
||||||
|
const weeks = activityBuckets(rows, asOf, 'week');
|
||||||
|
expect(weeks).toHaveLength(1);
|
||||||
|
expect(weeks[0].date).toBe('2026-09-06');
|
||||||
|
expect(weeks[0].wau).toBe(1);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('monthly buckets are whole calendar months up to the last completed one', () => {
|
||||||
|
const rows: CompletionRow[] = [
|
||||||
|
c('jun', '2026-06-01'),
|
||||||
|
c('jul', '2026-07-15'),
|
||||||
|
c('aug', '2026-08-31')
|
||||||
|
];
|
||||||
|
const months = activityBuckets(rows, asOf, 'month');
|
||||||
|
expect(months.map((b) => b.date)).toEqual(['2026-06-30', '2026-07-31', '2026-08-31']);
|
||||||
|
expect(months.map((b) => b.label)).toEqual(['Jun', 'Jul', 'Aug']);
|
||||||
|
// A whole calendar month, not a trailing 30-day window: Jun 1 is included.
|
||||||
|
expect(months[0].mau).toBe(1);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('a month ending on the as-of day counts as completed', () => {
|
||||||
|
const rows: CompletionRow[] = [c('a', '2026-09-01'), c('b', '2026-09-30')];
|
||||||
|
const months = activityBuckets(rows, '2026-09-30', 'month');
|
||||||
|
expect(months.map((b) => b.date)).toEqual(['2026-09-30']);
|
||||||
|
expect(months[0].mau).toBe(2);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('adds the week-year only when the range spans week-years', () => {
|
||||||
|
const rows: CompletionRow[] = [c('a', '2025-12-01'), c('b', '2026-01-15')];
|
||||||
|
const weeks = activityBuckets(rows, '2026-02-10', 'week');
|
||||||
|
expect(weeks[0].label).toBe("W49 '25");
|
||||||
|
expect(weeks.at(-1)?.label).toBe("W6 '26");
|
||||||
|
});
|
||||||
|
|
||||||
|
test('adds the year to month labels when the range spans years', () => {
|
||||||
|
const rows: CompletionRow[] = [c('a', '2025-11-01'), c('b', '2026-01-15')];
|
||||||
|
const months = activityBuckets(rows, '2026-02-10', 'month');
|
||||||
|
expect(months.map((b) => b.label)).toEqual(['Nov 25', 'Dec 25', 'Jan 26']);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('labels January with its year even inside a single-year range', () => {
|
||||||
|
const rows: CompletionRow[] = [c('a', '2026-01-01'), c('b', '2026-03-15')];
|
||||||
|
const months = activityBuckets(rows, '2026-04-15', 'month');
|
||||||
|
expect(months.map((b) => b.label)).toEqual(['Jan 26', 'Feb', 'Mar']);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('returns nothing when every period with data is still in progress', () => {
|
||||||
|
const rows: CompletionRow[] = [c('a', '2026-09-08')];
|
||||||
|
expect(activityBuckets(rows, asOf, 'month')).toEqual([]);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('weeklyFlows / projectWau', () => {
|
||||||
|
// Three consecutive completed ISO weeks ending Sun 08-23, 08-30, 09-06.
|
||||||
|
// p2/p3 return, p4/p5 arrive: 2 retained and 1 inflow each week.
|
||||||
|
const rows: CompletionRow[] = [
|
||||||
|
c('p1', '2026-08-18'),
|
||||||
|
c('p2', '2026-08-18'),
|
||||||
|
c('p3', '2026-08-18'),
|
||||||
|
c('p2', '2026-08-25'),
|
||||||
|
c('p3', '2026-08-25'),
|
||||||
|
c('p4', '2026-08-25'),
|
||||||
|
c('p3', '2026-09-01'),
|
||||||
|
c('p4', '2026-09-01'),
|
||||||
|
c('p5', '2026-09-01')
|
||||||
|
];
|
||||||
|
const asOf = '2026-09-10';
|
||||||
|
|
||||||
|
test('weeklyFlows accounts for retained vs inflow players', () => {
|
||||||
|
const flows = weeklyFlows(rows, asOf);
|
||||||
|
expect(flows.map((f) => f.end)).toEqual(['2026-08-23', '2026-08-30', '2026-09-06']);
|
||||||
|
expect(flows.map((f) => f.wau)).toEqual([3, 3, 3]);
|
||||||
|
expect(flows.map((f) => f.retained)).toEqual([0, 2, 2]);
|
||||||
|
expect(flows.map((f) => f.inflow)).toEqual([3, 1, 1]);
|
||||||
|
expect(flows.map((f) => f.newPlayers)).toEqual([3, 1, 1]);
|
||||||
|
expect(flows.map((f) => f.resurrected)).toEqual([0, 0, 0]);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('the flow model holds a flat base steady instead of overshooting', () => {
|
||||||
|
const projection = projectWau(rows, asOf, 4);
|
||||||
|
expect(projection).not.toBeNull();
|
||||||
|
expect(projection?.sampleWeeks).toBe(3);
|
||||||
|
expect(projection?.retention).toBeCloseTo(0.667, 3);
|
||||||
|
expect(projection?.inflow).toBe(1);
|
||||||
|
// retention 2/3 * 3 + 1 = 3 every week.
|
||||||
|
expect(projection?.flow.map((p) => p.value)).toEqual([3, 3, 3, 3]);
|
||||||
|
expect(projection?.flow).toHaveLength(4);
|
||||||
|
expect(projection?.flow[0].label).toBe('W37');
|
||||||
|
});
|
||||||
|
|
||||||
|
test('every model returns a bracketed band', () => {
|
||||||
|
const projection = projectWau(rows, asOf, 4);
|
||||||
|
for (const key of ['flow', 'regression', 'seasonal'] as const) {
|
||||||
|
expect(projection?.[key]).toHaveLength(4);
|
||||||
|
for (const point of projection?.[key] ?? []) {
|
||||||
|
expect(point.low).toBeLessThanOrEqual(point.value);
|
||||||
|
expect(point.value).toBeLessThanOrEqual(point.high);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
test('fits regression and seasonal models once there is enough history', () => {
|
||||||
|
const start = new Date('2026-01-05T00:00:00Z'); // Monday
|
||||||
|
const rows: CompletionRow[] = [];
|
||||||
|
for (let w = 0; w < 30; w++) {
|
||||||
|
const weekStart = new Date(start);
|
||||||
|
weekStart.setUTCDate(weekStart.getUTCDate() + w * 7);
|
||||||
|
for (let p = 0; p < 3; p++) {
|
||||||
|
const d = new Date(weekStart);
|
||||||
|
d.setUTCDate(d.getUTCDate() + ((w + p) % 7));
|
||||||
|
rows.push(c(`core-${p}`, d.toISOString().slice(0, 10)));
|
||||||
|
}
|
||||||
|
for (let p = 0; p < 2; p++) {
|
||||||
|
const d = new Date(weekStart);
|
||||||
|
d.setUTCDate(d.getUTCDate() + ((w + p + 3) % 7));
|
||||||
|
rows.push(c(`new-${w}-${p}`, d.toISOString().slice(0, 10)));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const after = new Date(start);
|
||||||
|
after.setUTCDate(after.getUTCDate() + 30 * 7);
|
||||||
|
const projection = projectWau(rows, after.toISOString().slice(0, 10), 4);
|
||||||
|
expect(projection?.sampleWeeks).toBe(30);
|
||||||
|
expect(projection?.regression).toHaveLength(4);
|
||||||
|
expect(projection?.seasonal).toHaveLength(4);
|
||||||
|
expect(projection?.retention).toBeGreaterThan(0);
|
||||||
|
expect(projection?.retention).toBeLessThanOrEqual(1);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('the corrected regression does not collapse toward zero', () => {
|
||||||
|
const start = new Date('2026-01-05T00:00:00Z'); // Monday
|
||||||
|
const rows: CompletionRow[] = [];
|
||||||
|
for (let w = 0; w < 30; w++) {
|
||||||
|
const weekStart = new Date(start);
|
||||||
|
weekStart.setUTCDate(weekStart.getUTCDate() + w * 7);
|
||||||
|
for (let p = 0; p < 4; p++) {
|
||||||
|
const d = new Date(weekStart);
|
||||||
|
d.setUTCDate(d.getUTCDate() + ((w + p) % 7));
|
||||||
|
rows.push(c(`core-${p}`, d.toISOString().slice(0, 10)));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const after = new Date(start);
|
||||||
|
after.setUTCDate(after.getUTCDate() + 30 * 7);
|
||||||
|
const projection = projectWau(rows, after.toISOString().slice(0, 10), 4);
|
||||||
|
const last = projection?.regression.at(-1)?.value ?? 0;
|
||||||
|
// A stable 4-player base should not decay away.
|
||||||
|
expect(last).toBeGreaterThanOrEqual(3);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('needs at least three completed weeks', () => {
|
||||||
|
const few = [c('a', '2026-09-01'), c('b', '2026-09-02')];
|
||||||
|
expect(projectWau(few, asOf)).toBeNull();
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -1,14 +1,18 @@
|
|||||||
# in progress
|
# in progress
|
||||||
|
|
||||||
(admin/stats)
|
(admin/stats)
|
||||||
- [ ] WAU/MAU graph
|
- [x] WAU/MAU graph
|
||||||
- [ ] new players per day should show 3 months
|
- [x] show full calendar weeks (ISO, Mon-Sun) / months, stopping at the last completed period
|
||||||
- [ ] full width graphs need to have mouse tracking correctly
|
- [x] new players per day should show 3 months
|
||||||
- [ ] re: "segment mix over time": we need a counter for recently returning players
|
- [x] full width graphs need to have mouse tracking correctly
|
||||||
- [ ] (add clarification for past 30 days) maybe just remove "churned"
|
- [x] re: "segment mix over time": we need a counter for recently returning players
|
||||||
|
- [x] (add clarification for past 30 days) maybe just remove "churned"
|
||||||
|
- [x] embed the community stats view at the top of the console (minus the verse)
|
||||||
|
- [x] WAU projection section below Pulse (Flow / Regression / Seasonal, all-history fit, p10–p90 bands)
|
||||||
|
- [x] hide the verse mix lab completely, for now
|
||||||
|
|
||||||
(community stats)
|
(community stats)
|
||||||
- [ ] show yesterday's verse in the community stats
|
- [x] show yesterday's verse in the community stats
|
||||||
- [ ] show human readable numbers in the community stats
|
- [ ] show human readable numbers in the community stats
|
||||||
- [ ] fix the "last 30 days" github style view to be full-width
|
- [ ] fix the "last 30 days" github style view to be full-width
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user