@withpotter/components 0.13.0-next.101

package/dist/dashboard/home/money-hero.js

@@ -0,0 +1,200 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useReducedMotion } from "motion/react";
+import { ArrowUpRight, ArrowDownRight } from "lucide-react";
+import {
+  computeDelta
+} from "@withpotter/pages-analytics/dashboard/(analytics)/analytics/helpers";
+import { RevenueSpineChart } from "@withpotter/components/charts/revenue-spine-chart";
+import {
+  describeAge
+} from "./money-snapshot";
+import { useCountUp } from "@withpotter/hooks/use-count-up";
+function Placeholder({
+  className,
+  state
+}) {
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      "aria-hidden": true,
+      className: `inline-block rounded bg-[var(--bg-subtle)] ${state === "loading" ? "animate-pulse" : "opacity-60"} ${className}`
+    }
+  );
+}
+function Delta({
+  dir,
+  pct,
+  hasBaseline
+}) {
+  if (!hasBaseline || dir === "flat") return null;
+  const good = dir === "up";
+  return /* @__PURE__ */ jsxs(
+    "span",
+    {
+      className: `inline-flex items-center gap-0.5 text-sm font-semibold tabular-nums ${good ? "text-[var(--success)]" : "text-[var(--error)]"}`,
+      children: [
+        good ? /* @__PURE__ */ jsx(ArrowUpRight, {}) : /* @__PURE__ */ jsx(ArrowDownRight, {}),
+        pct.toFixed(pct >= 10 ? 0 : 1),
+        "%"
+      ]
+    }
+  );
+}
+function SubStat({
+  label,
+  value,
+  foot,
+  delta,
+  pending
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+    /* @__PURE__ */ jsx("p", { className: "text-xs text-[var(--text-tertiary)]", children: label }),
+    /* @__PURE__ */ jsxs("div", { className: "mt-0.5 flex items-baseline gap-2", children: [
+      pending ? /* @__PURE__ */ jsx(Placeholder, { className: "h-[17px] w-16", state: pending }) : /* @__PURE__ */ jsx("span", { className: "text-xl font-semibold tabular-nums tracking-[-0.01em] text-[var(--text-primary)]", children: value }),
+      !pending && delta
+    ] }),
+    foot && /* @__PURE__ */ jsx("p", { className: "mt-0.5 truncate text-2xs text-[var(--text-muted)]", children: foot })
+  ] });
+}
+function MoneyHero({
+  data,
+  prior,
+  outstanding,
+  formatCurrency,
+  language,
+  failed,
+  cachedAt,
+  onRetry
+}) {
+  const reduce = useReducedMotion() ?? false;
+  const pending = data != null ? null : failed ? "failed" : "loading";
+  const staleAt = data != null && cachedAt != null ? cachedAt : null;
+  const revenue = data?.sales.totalRevenue ?? 0;
+  const shownRevenue = useCountUp(revenue, !reduce);
+  const orders = data?.sales.totalOrders ?? 0;
+  const aov = data?.sales.averageOrderValue ?? 0;
+  const priorSales = prior?.sales;
+  const revenueDelta = computeDelta(revenue, priorSales?.totalRevenue ?? 0);
+  const ordersDelta = computeDelta(orders, priorSales?.totalOrders ?? 0);
+  const series = data?.revenueTimeSeries ?? [];
+  const best = series.reduce(
+    (acc, p) => !acc || p.value > acc.value ? { value: p.value, date: p.date } : acc,
+    null
+  );
+  const avgPerDay = series.length ? series.reduce((a, p) => a + p.value, 0) / series.length : 0;
+  const bestDayLabel = best && best.value > 0 ? `${new Date(best.date).toLocaleDateString(void 0, {
+    weekday: "short"
+  })} ${formatCurrency(best.value)}` : "\u2014";
+  const overdueFoot = outstanding == null ? void 0 : outstanding.count === 0 ? "nothing owed" : outstanding.overdueCount > 0 ? `${outstanding.overdueCount} overdue` : `${outstanding.count} open invoice${outstanding.count === 1 ? "" : "s"}`;
+  return /* @__PURE__ */ jsxs("section", { className: "surface-quiet grid gap-x-6 gap-y-4 p-4 lg:grid-cols-[minmax(0,1fr)_minmax(0,0.85fr)] lg:p-4", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-col", children: [
+      /* @__PURE__ */ jsx("p", { className: "text-xs text-[var(--text-tertiary)]", children: "Revenue \xB7 last 30 days" }),
+      /* @__PURE__ */ jsxs("div", { className: "mt-1 flex flex-wrap items-baseline gap-x-3 gap-y-1", children: [
+        pending ? /* @__PURE__ */ jsx(
+          Placeholder,
+          {
+            className: "h-[26px] w-40 sm:h-[34px] sm:w-56",
+            state: pending
+          }
+        ) : /* @__PURE__ */ jsx("span", { className: "text-4xl font-semibold leading-none tracking-[-0.025em] text-[var(--text-primary)] sm:text-5xl", children: formatCurrency(Math.round(shownRevenue)) }),
+        !pending && /* @__PURE__ */ jsx(
+          Delta,
+          {
+            dir: revenueDelta.dir,
+            pct: revenueDelta.pct,
+            hasBaseline: revenueDelta.hasBaseline
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsxs("p", { className: "mt-2 flex flex-wrap items-baseline gap-x-2 text-xs text-[var(--text-muted)]", children: [
+        /* @__PURE__ */ jsx("span", { children: staleAt != null ? `${language.revenueFoot}, as of ${describeAge(staleAt)}` : pending === "failed" ? "Couldn\u2019t load this just now." : language.revenueFoot }),
+        failed && onRetry && /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            onClick: onRetry,
+            className: "rounded-sm font-medium text-[var(--text-secondary)] underline underline-offset-2 transition-colors hover:text-[var(--text-primary)] focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[var(--focus-ring)]",
+            children: staleAt != null ? "Refresh" : "Try again"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "mt-7 grid grid-cols-2 gap-x-6 gap-y-4 border-t border-[var(--border-subtle)] pt-4 sm:grid-cols-3", children: [
+        /* @__PURE__ */ jsx(
+          SubStat,
+          {
+            label: language.countLabel,
+            value: orders.toLocaleString(),
+            foot: language.countFoot,
+            pending,
+            delta: /* @__PURE__ */ jsx(
+              Delta,
+              {
+                dir: ordersDelta.dir,
+                pct: ordersDelta.pct,
+                hasBaseline: ordersDelta.hasBaseline
+              }
+            )
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          SubStat,
+          {
+            label: language.averageLabel,
+            value: formatCurrency(aov),
+            foot: language.averageFoot,
+            pending
+          }
+        ),
+        pending ? /* @__PURE__ */ jsx(SubStat, { label: "Outstanding", value: "", pending }) : outstanding != null && /* @__PURE__ */ jsx(
+          SubStat,
+          {
+            label: "Outstanding",
+            value: formatCurrency(outstanding.totalOutstanding),
+            foot: overdueFoot
+          }
+        )
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-col", children: [
+      /* @__PURE__ */ jsxs("div", { className: "mb-1 flex items-baseline justify-between gap-3", children: [
+        /* @__PURE__ */ jsx("span", { className: "text-xs text-[var(--text-tertiary)]", children: "Trend" }),
+        /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-3 text-2xs text-[var(--text-muted)]", children: [
+          /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-2", children: [
+            /* @__PURE__ */ jsx("span", { className: "inline-block h-[3px] w-2.5 rounded-sm bg-[var(--color-brand-500)]" }),
+            "This period"
+          ] }),
+          !pending && prior && /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-2", children: [
+            /* @__PURE__ */ jsx("span", { className: "inline-block h-0 w-2.5 border-t-2 border-dashed border-[var(--text-muted)]" }),
+            "Prior"
+          ] })
+        ] })
+      ] }),
+      data == null ? /* @__PURE__ */ jsx("div", { className: "h-[168px] animate-pulse rounded-lg bg-[var(--bg-subtle)]" }) : /* @__PURE__ */ jsx(
+        RevenueSpineChart,
+        {
+          current: data.revenueTimeSeries,
+          prior: prior?.revenueTimeSeries,
+          formatCurrency,
+          height: 168
+        }
+      ),
+      /* @__PURE__ */ jsxs("div", { className: "mt-2 flex gap-4 border-t border-[var(--border-subtle)] pt-3 text-2xs text-[var(--text-muted)]", children: [
+        /* @__PURE__ */ jsxs("span", { children: [
+          "Best day",
+          " ",
+          /* @__PURE__ */ jsx("span", { className: "font-semibold tabular-nums text-[var(--text-secondary)]", children: bestDayLabel })
+        ] }),
+        /* @__PURE__ */ jsxs("span", { children: [
+          "Avg/day",
+          " ",
+          /* @__PURE__ */ jsx("span", { className: "font-semibold tabular-nums text-[var(--text-secondary)]", children: formatCurrency(avgPerDay) })
+        ] })
+      ] })
+    ] })
+  ] });
+}
+export {
+  MoneyHero
+};
+//# sourceMappingURL=money-hero.js.map

package/dist/dashboard/home/money-hero.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/dashboard/home/money-hero.tsx"],"sourcesContent":["'use client';\n\nimport { useReducedMotion } from 'motion/react';\nimport { ArrowUpRight, ArrowDownRight } from 'lucide-react';\nimport {\n  computeDelta,\n  type DeltaDirection,\n} from '@withpotter/pages-analytics/dashboard/(analytics)/analytics/helpers';\nimport { RevenueSpineChart } from '@withpotter/components/charts/revenue-spine-chart';\nimport type { MoneyLanguage } from './money-language';\nimport {\n  describeAge,\n  type MoneyFigures,\n  type MoneyOutstanding,\n} from './money-snapshot';\nimport { useCountUp } from '@withpotter/hooks/use-count-up';\n\n/**\n * The home's money band.\n *\n * The home previously reused the Analytics money spine verbatim: a 2×2 quadrant\n * where revenue, order count, average value and outstanding all got identical\n * type. A period revenue figure and a count of orders are not peers, and the\n * quadrant's internal hairlines fought every other (gap-separated) card on the\n * page. That is a report, and Analytics is the right place for a report.\n *\n * Here money leads at real scale: ONE dominant number, everything else visibly\n * subordinate to it. The data source is unchanged — the same\n * `analyticsApi.getDashboard` payload Analytics reads — so this is a different\n * presentation of one truth, not a second copy of it.\n *\n * Two deliberate honesty fixes carried over from the old spine:\n *   - No baseline to compare against renders NOTHING, instead of the bare word\n *     \"new\" sitting unexplained beside four separate numbers.\n *   - Outstanding is omitted entirely when it hasn't loaded, instead of showing\n *     an em dash next to siblings showing a real zero.\n */\n\n/** Why a figure isn't showing: still in flight, or the request failed. */\ntype Pending = 'loading' | 'failed';\n\n/**\n * Holds the exact space a figure will occupy, so nothing jumps when it lands.\n * It only pulses while something is actually still coming — a shimmer that\n * never resolves promises an arrival that isn't on its way.\n */\nfunction Placeholder({\n  className,\n  state,\n}: {\n  className: string;\n  state: Pending;\n}) {\n  return (\n    <span\n      aria-hidden\n      className={`inline-block rounded bg-[var(--bg-subtle)] ${\n        state === 'loading' ? 'animate-pulse' : 'opacity-60'\n      } ${className}`}\n    />\n  );\n}\n\nfunction Delta({\n  dir,\n  pct,\n  hasBaseline,\n}: {\n  dir: DeltaDirection;\n  pct: number;\n  hasBaseline: boolean;\n}) {\n  // No prior period to compare against: say nothing. Colour and arrows are\n  // reserved for real movement.\n  if (!hasBaseline || dir === 'flat') return null;\n\n  const good = dir === 'up';\n  return (\n    <span\n      className={`inline-flex items-center gap-0.5 text-sm font-semibold tabular-nums ${\n        good ? 'text-[var(--success)]' : 'text-[var(--error)]'\n      }`}\n    >\n      {good ? <ArrowUpRight /> : <ArrowDownRight />}\n      {pct.toFixed(pct >= 10 ? 0 : 1)}%\n    </span>\n  );\n}\n\n/** A subordinate figure. Deliberately a fraction of the hero's weight. */\nfunction SubStat({\n  label,\n  value,\n  foot,\n  delta,\n  pending,\n}: {\n  label: string;\n  value: string;\n  foot?: string;\n  delta?: React.ReactNode;\n  pending?: Pending | null;\n}) {\n  return (\n    <div className=\"min-w-0\">\n      <p className=\"text-xs text-[var(--text-tertiary)]\">{label}</p>\n      <div className=\"mt-0.5 flex items-baseline gap-2\">\n        {pending ? (\n          <Placeholder className=\"h-[17px] w-16\" state={pending} />\n        ) : (\n          <span className=\"text-xl font-semibold tabular-nums tracking-[-0.01em] text-[var(--text-primary)]\">\n            {value}\n          </span>\n        )}\n        {!pending && delta}\n      </div>\n      {foot && (\n        <p className=\"mt-0.5 truncate text-2xs text-[var(--text-muted)]\">\n          {foot}\n        </p>\n      )}\n    </div>\n  );\n}\n\nexport function MoneyHero({\n  data,\n  prior,\n  outstanding,\n  formatCurrency,\n  language,\n  failed,\n  cachedAt,\n  onRetry,\n}: {\n  /** Null only when there is nothing to show at all: no live read, no cache. */\n  data: MoneyFigures | null;\n  prior: MoneyFigures | null;\n  outstanding: MoneyOutstanding | null;\n  formatCurrency: (n: number) => string;\n  language: MoneyLanguage;\n  /** The request errored rather than merely being slow. */\n  failed?: boolean;\n  /** Epoch ms these figures were read, when they came from the cache. */\n  cachedAt?: number | null;\n  onRetry?: () => void;\n}) {\n  const reduce = useReducedMotion() ?? false;\n  const pending: Pending | null =\n    data != null ? null : failed ? 'failed' : 'loading';\n  /** Figures are on screen, but they came from the cache, not this read. */\n  const staleAt = data != null && cachedAt != null ? cachedAt : null;\n  const revenue = data?.sales.totalRevenue ?? 0;\n  // The one number the page is about earns the one number animation.\n  const shownRevenue = useCountUp(revenue, !reduce);\n  const orders = data?.sales.totalOrders ?? 0;\n  const aov = data?.sales.averageOrderValue ?? 0;\n\n  const priorSales = prior?.sales;\n  const revenueDelta = computeDelta(revenue, priorSales?.totalRevenue ?? 0);\n  const ordersDelta = computeDelta(orders, priorSales?.totalOrders ?? 0);\n\n  // Best and average day, from the series the chart already has.\n  const series = data?.revenueTimeSeries ?? [];\n  const best = series.reduce<{ value: number; date: string } | null>(\n    (acc, p) =>\n      !acc || p.value > acc.value ? { value: p.value, date: p.date } : acc,\n    null,\n  );\n  const avgPerDay = series.length\n    ? series.reduce((a, p) => a + p.value, 0) / series.length\n    : 0;\n  const bestDayLabel =\n    best && best.value > 0\n      ? `${new Date(best.date).toLocaleDateString(undefined, {\n          weekday: 'short',\n        })} ${formatCurrency(best.value)}`\n      : '—';\n\n  const overdueFoot =\n    outstanding == null\n      ? undefined\n      : outstanding.count === 0\n        ? 'nothing owed'\n        : outstanding.overdueCount > 0\n          ? `${outstanding.overdueCount} overdue`\n          : `${outstanding.count} open invoice${outstanding.count === 1 ? '' : 's'}`;\n\n  return (\n    <section className=\"surface-quiet grid gap-x-6 gap-y-4 p-4 lg:grid-cols-[minmax(0,1fr)_minmax(0,0.85fr)] lg:p-4\">\n      {/* Money, at the scale money deserves */}\n      <div className=\"flex min-w-0 flex-col\">\n        <p className=\"text-xs text-[var(--text-tertiary)]\">\n          Revenue · last 30 days\n        </p>\n        <div className=\"mt-1 flex flex-wrap items-baseline gap-x-3 gap-y-1\">\n          {/* 40px, not 52: it stays ~2.3x the sub-stats so the hierarchy is\n              unmistakable, but a zero at billboard size just shouts that there\n              is no money yet.\n              Deliberately NOT tabular-nums. Tabular monospaces every digit to\n              the width of the widest one, so a figure containing 1s gets padded\n              — measured at 225.3px tabular vs 208.8px proportional for\n              £1,324,800, 7.9% wider for nothing. Tabular earns its place where\n              numbers stack in a column and must align; this one aligns with\n              nothing. The sub-stats below keep it. */}\n          {pending ? (\n            <Placeholder\n              className=\"h-[26px] w-40 sm:h-[34px] sm:w-56\"\n              state={pending}\n            />\n          ) : (\n            <span className=\"text-4xl font-semibold leading-none tracking-[-0.025em] text-[var(--text-primary)] sm:text-5xl\">\n              {formatCurrency(Math.round(shownRevenue))}\n            </span>\n          )}\n          {!pending && (\n            <Delta\n              dir={revenueDelta.dir}\n              pct={revenueDelta.pct}\n              hasBaseline={revenueDelta.hasBaseline}\n            />\n          )}\n        </div>\n        {/* One line, three jobs: where the figure comes from, how old it is if\n            it isn't live, and the way back if the read failed. A failure is\n            demoted to here rather than taking the band off the page. */}\n        <p className=\"mt-2 flex flex-wrap items-baseline gap-x-2 text-xs text-[var(--text-muted)]\">\n          <span>\n            {staleAt != null\n              ? `${language.revenueFoot}, as of ${describeAge(staleAt)}`\n              : pending === 'failed'\n                ? 'Couldn\\u2019t load this just now.'\n                : language.revenueFoot}\n          </span>\n          {failed && onRetry && (\n            <button\n              type=\"button\"\n              onClick={onRetry}\n              className=\"rounded-sm font-medium text-[var(--text-secondary)] underline underline-offset-2 transition-colors hover:text-[var(--text-primary)] focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[var(--focus-ring)]\"\n            >\n              {staleAt != null ? 'Refresh' : 'Try again'}\n            </button>\n          )}\n        </p>\n\n        {/* Everything else, subordinate.\n            A fixed 28px gap, NOT `mt-auto`. Pushing this row to the bottom of\n            the column opened 61px of dead space under the revenue figure and\n            split the left column into two disconnected clusters — and it didn't\n            even buy alignment: the row ended 35px below the chart it was\n            supposedly levelling with. The money block reads as one unit now. */}\n        <div className=\"mt-7 grid grid-cols-2 gap-x-6 gap-y-4 border-t border-[var(--border-subtle)] pt-4 sm:grid-cols-3\">\n          <SubStat\n            label={language.countLabel}\n            value={orders.toLocaleString()}\n            foot={language.countFoot}\n            pending={pending}\n            delta={\n              <Delta\n                dir={ordersDelta.dir}\n                pct={ordersDelta.pct}\n                hasBaseline={ordersDelta.hasBaseline}\n              />\n            }\n          />\n          <SubStat\n            label={language.averageLabel}\n            value={formatCurrency(aov)}\n            foot={language.averageFoot}\n            pending={pending}\n          />\n          {/* Omitted rather than dashed when it hasn't loaded — but while the\n              whole band is pending it holds its place, so the row doesn't\n              reflow from two columns to three under the operator. */}\n          {pending ? (\n            <SubStat label=\"Outstanding\" value=\"\" pending={pending} />\n          ) : (\n            outstanding != null && (\n              <SubStat\n                label=\"Outstanding\"\n                value={formatCurrency(outstanding.totalOutstanding)}\n                foot={overdueFoot}\n              />\n            )\n          )}\n        </div>\n      </div>\n\n      {/* Trend, subordinate to the number it describes */}\n      <div className=\"flex min-w-0 flex-col\">\n        <div className=\"mb-1 flex items-baseline justify-between gap-3\">\n          <span className=\"text-xs text-[var(--text-tertiary)]\">Trend</span>\n          <span className=\"flex items-center gap-3 text-2xs text-[var(--text-muted)]\">\n            <span className=\"inline-flex items-center gap-2\">\n              <span className=\"inline-block h-[3px] w-2.5 rounded-sm bg-[var(--color-brand-500)]\" />\n              This period\n            </span>\n            {!pending && prior && (\n              <span className=\"inline-flex items-center gap-2\">\n                <span className=\"inline-block h-0 w-2.5 border-t-2 border-dashed border-[var(--text-muted)]\" />\n                Prior\n              </span>\n            )}\n          </span>\n        </div>\n        {data == null ? (\n          <div className=\"h-[168px] animate-pulse rounded-lg bg-[var(--bg-subtle)]\" />\n        ) : (\n          <RevenueSpineChart\n            current={data.revenueTimeSeries}\n            prior={prior?.revenueTimeSeries}\n            formatCurrency={formatCurrency}\n            height={168}\n          />\n        )}\n        {/* Best day / average day: the chart shows the shape, these two say what\n            a good day actually looks like here. Both come from the series\n            already fetched, so they cost nothing. */}\n        <div className=\"mt-2 flex gap-4 border-t border-[var(--border-subtle)] pt-3 text-2xs text-[var(--text-muted)]\">\n          <span>\n            Best day{' '}\n            <span className=\"font-semibold tabular-nums text-[var(--text-secondary)]\">\n              {bestDayLabel}\n            </span>\n          </span>\n          <span>\n            Avg/day{' '}\n            <span className=\"font-semibold tabular-nums text-[var(--text-secondary)]\">\n              {formatCurrency(avgPerDay)}\n            </span>\n          </span>\n        </div>\n      </div>\n    </section>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/dashboard/home/money-language.d.ts

@@ -0,0 +1,32 @@
+import type { ResolvedIntentConfig } from '@withpotter/lib/intents/types';
+/**
+ * The words the money band uses, resolved from the tenant's archetypes.
+ *
+ * The home used to hardcode commerce language — "Orders", "paid orders +
+ * invoices", "per paid order" — on top of a sidebar that had already renamed
+ * everything. A padel club read "Add your first product" under a nav full of
+ * Courts and Waitlist.
+ *
+ * `entities.order` is the existing per-archetype noun (Booking / Order /
+ * Invoice / Ticket), so this reads from the same source the rest of the
+ * dashboard renames from rather than inventing a parallel vocabulary.
+ *
+ * MULTI-ARCHETYPE: a business running bookings AND a shop has no single true
+ * noun for its money. Rather than picking the primary archetype's word and
+ * lying about the other half of the revenue, the band falls back to the neutral
+ * "Sales" whenever the archetypes disagree. When every archetype agrees (three
+ * booking-shaped models, say), the shared word is still correct and is used.
+ */
+export interface MoneyLanguage {
+    /** Plural noun for the count tile: "Bookings", "Orders", "Sales". */
+    countLabel: string;
+    /** Foot under the count tile. */
+    countFoot: string;
+    /** Label for average value: "Avg booking", "Avg order", "Avg sale". */
+    averageLabel: string;
+    /** Foot under the average tile. */
+    averageFoot: string;
+    /** Where the revenue figure comes from, in this business's words. */
+    revenueFoot: string;
+}
+export declare function resolveMoneyLanguage(intentConfig: ResolvedIntentConfig): MoneyLanguage;

package/dist/dashboard/home/money-language.js

@@ -0,0 +1,27 @@
+const NEUTRAL = {
+  countLabel: "Sales",
+  countFoot: "in the last 30 days",
+  averageLabel: "Avg sale",
+  averageFoot: "per paid sale",
+  revenueFoot: "paid sales and invoices"
+};
+function resolveMoneyLanguage(intentConfig) {
+  const orders = intentConfig.all.map((c) => c.entities.order);
+  const first = orders[0];
+  if (!first) return NEUTRAL;
+  const agreed = orders.every((o) => o.plural === first.plural);
+  if (!agreed) return NEUTRAL;
+  const plural = first.plural;
+  const singular = first.singular.toLowerCase();
+  return {
+    countLabel: plural,
+    countFoot: "in the last 30 days",
+    averageLabel: `Avg ${singular}`,
+    averageFoot: `per paid ${singular}`,
+    revenueFoot: `paid ${plural.toLowerCase()} and invoices`
+  };
+}
+export {
+  resolveMoneyLanguage
+};
+//# sourceMappingURL=money-language.js.map

package/dist/dashboard/home/money-language.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/dashboard/home/money-language.ts"],"sourcesContent":["import type { ResolvedIntentConfig } from '@withpotter/lib/intents/types';\n\n/**\n * The words the money band uses, resolved from the tenant's archetypes.\n *\n * The home used to hardcode commerce language — \"Orders\", \"paid orders +\n * invoices\", \"per paid order\" — on top of a sidebar that had already renamed\n * everything. A padel club read \"Add your first product\" under a nav full of\n * Courts and Waitlist.\n *\n * `entities.order` is the existing per-archetype noun (Booking / Order /\n * Invoice / Ticket), so this reads from the same source the rest of the\n * dashboard renames from rather than inventing a parallel vocabulary.\n *\n * MULTI-ARCHETYPE: a business running bookings AND a shop has no single true\n * noun for its money. Rather than picking the primary archetype's word and\n * lying about the other half of the revenue, the band falls back to the neutral\n * \"Sales\" whenever the archetypes disagree. When every archetype agrees (three\n * booking-shaped models, say), the shared word is still correct and is used.\n */\nexport interface MoneyLanguage {\n  /** Plural noun for the count tile: \"Bookings\", \"Orders\", \"Sales\". */\n  countLabel: string;\n  /** Foot under the count tile. */\n  countFoot: string;\n  /** Label for average value: \"Avg booking\", \"Avg order\", \"Avg sale\". */\n  averageLabel: string;\n  /** Foot under the average tile. */\n  averageFoot: string;\n  /** Where the revenue figure comes from, in this business's words. */\n  revenueFoot: string;\n}\n\nconst NEUTRAL: MoneyLanguage = {\n  countLabel: 'Sales',\n  countFoot: 'in the last 30 days',\n  averageLabel: 'Avg sale',\n  averageFoot: 'per paid sale',\n  revenueFoot: 'paid sales and invoices',\n};\n\nexport function resolveMoneyLanguage(\n  intentConfig: ResolvedIntentConfig,\n): MoneyLanguage {\n  const orders = intentConfig.all.map((c) => c.entities.order);\n  const first = orders[0];\n  if (!first) return NEUTRAL;\n\n  // Archetypes disagree on what a sale is called → use the neutral word rather\n  // than describing a mixed business in one archetype's language.\n  const agreed = orders.every((o) => o.plural === first.plural);\n  if (!agreed) return NEUTRAL;\n\n  const plural = first.plural;\n  const singular = first.singular.toLowerCase();\n\n  return {\n    countLabel: plural,\n    countFoot: 'in the last 30 days',\n    averageLabel: `Avg ${singular}`,\n    averageFoot: `per paid ${singular}`,\n    revenueFoot: `paid ${plural.toLowerCase()} and invoices`,\n  };\n}\n"],"mappings":"AAiCA,MAAM,UAAyB;AAAA,EAC7B,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,cAAc;AAAA,EACd,aAAa;AAAA,EACb,aAAa;AACf;AAEO,SAAS,qBACd,cACe;AACf,QAAM,SAAS,aAAa,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,KAAK;AAC3D,QAAM,QAAQ,OAAO,CAAC;AACtB,MAAI,CAAC,MAAO,QAAO;AAInB,QAAM,SAAS,OAAO,MAAM,CAAC,MAAM,EAAE,WAAW,MAAM,MAAM;AAC5D,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,SAAS,MAAM;AACrB,QAAM,WAAW,MAAM,SAAS,YAAY;AAE5C,SAAO;AAAA,IACL,YAAY;AAAA,IACZ,WAAW;AAAA,IACX,cAAc,OAAO,QAAQ;AAAA,IAC7B,aAAa,YAAY,QAAQ;AAAA,IACjC,aAAa,QAAQ,OAAO,YAAY,CAAC;AAAA,EAC3C;AACF;","names":[]}

package/dist/dashboard/home/money-snapshot.d.ts

@@ -0,0 +1,48 @@
+import type { TimeSeriesPoint } from '@withpotter/lib/api/types';
+/**
+ * The last figures the money band actually saw, kept so the band can open with
+ * real numbers instead of empty boxes.
+ *
+ * The home is the first thing an operator looks at, usually on a phone on a bad
+ * connection. Making them stare at shimmer (or worse, an error) while the
+ * request runs hides the one thing they came for, and the figures rarely move
+ * much between two visits minutes apart. So: paint the last known numbers
+ * immediately, then swap them for live ones the moment they land.
+ *
+ * Only the fields the band renders are stored. `DashboardStats` carries twenty
+ * other collections (recent events, client errors, page dwell time) that would
+ * bloat localStorage for nothing. `DashboardStats` is structurally assignable
+ * to `MoneyFigures`, so callers pass the live payload straight through.
+ */
+export interface MoneyFigures {
+    sales: {
+        totalRevenue: number;
+        totalOrders: number;
+        averageOrderValue: number;
+    };
+    revenueTimeSeries: TimeSeriesPoint[];
+}
+export interface MoneyOutstanding {
+    totalOutstanding: number;
+    count: number;
+    overdueCount: number;
+}
+export interface MoneySnapshot {
+    data: MoneyFigures;
+    prior: MoneyFigures | null;
+    outstanding: MoneyOutstanding | null;
+    /** Epoch ms the live figures were read. */
+    at: number;
+}
+export declare function readMoneySnapshot(tenantSlug: string): MoneySnapshot | null;
+export declare function writeMoneySnapshot(tenantSlug: string, snapshot: {
+    data: MoneyFigures;
+    prior: MoneyFigures | null;
+    outstanding: MoneyOutstanding | null;
+}): void;
+export declare function useLastMoneySnapshot(tenantSlug: string | undefined): MoneySnapshot | null;
+/**
+ * "a moment ago" / "12 minutes ago" / "yesterday". Said in the band's own quiet
+ * voice, so a stale figure is never presented as a live one.
+ */
+export declare function describeAge(at: number, now?: number): string;

package/dist/dashboard/home/money-snapshot.js

@@ -0,0 +1,81 @@
+"use client";
+import { useCallback, useSyncExternalStore } from "react";
+const VERSION = 1;
+const MAX_AGE_MS = 7 * 24 * 60 * 60 * 1e3;
+const key = (tenantSlug) => `potter:home:money:v${VERSION}:${tenantSlug}`;
+function slim(figures) {
+  return {
+    sales: {
+      totalRevenue: figures.sales.totalRevenue,
+      totalOrders: figures.sales.totalOrders,
+      averageOrderValue: figures.sales.averageOrderValue
+    },
+    revenueTimeSeries: (figures.revenueTimeSeries ?? []).map((p) => ({
+      date: p.date,
+      value: p.value
+    }))
+  };
+}
+function readMoneySnapshot(tenantSlug) {
+  if (typeof window === "undefined") return null;
+  try {
+    const raw = window.localStorage.getItem(key(tenantSlug));
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (!parsed?.data?.sales || typeof parsed.at !== "number") return null;
+    if (Date.now() - parsed.at > MAX_AGE_MS) return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function writeMoneySnapshot(tenantSlug, snapshot) {
+  if (typeof window === "undefined") return;
+  try {
+    const payload = {
+      data: slim(snapshot.data),
+      prior: snapshot.prior ? slim(snapshot.prior) : null,
+      outstanding: snapshot.outstanding ? {
+        totalOutstanding: snapshot.outstanding.totalOutstanding,
+        count: snapshot.outstanding.count,
+        overdueCount: snapshot.outstanding.overdueCount
+      } : null,
+      at: Date.now()
+    };
+    window.localStorage.setItem(key(tenantSlug), JSON.stringify(payload));
+  } catch {
+  }
+}
+const readOnce = /* @__PURE__ */ new Map();
+function snapshotFor(tenantSlug) {
+  if (!readOnce.has(tenantSlug)) {
+    readOnce.set(tenantSlug, readMoneySnapshot(tenantSlug));
+  }
+  return readOnce.get(tenantSlug) ?? null;
+}
+const subscribe = () => () => {
+};
+const getServerSnapshot = () => null;
+function useLastMoneySnapshot(tenantSlug) {
+  const getSnapshot = useCallback(
+    () => tenantSlug ? snapshotFor(tenantSlug) : null,
+    [tenantSlug]
+  );
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+function describeAge(at, now = Date.now()) {
+  const mins = Math.max(0, Math.round((now - at) / 6e4));
+  if (mins < 2) return "a moment ago";
+  if (mins < 60) return `${mins} minutes ago`;
+  const hours = Math.round(mins / 60);
+  if (hours < 24) return `${hours} hour${hours === 1 ? "" : "s"} ago`;
+  const days = Math.round(hours / 24);
+  return days === 1 ? "yesterday" : `${days} days ago`;
+}
+export {
+  describeAge,
+  readMoneySnapshot,
+  useLastMoneySnapshot,
+  writeMoneySnapshot
+};
+//# sourceMappingURL=money-snapshot.js.map

package/dist/dashboard/home/money-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/dashboard/home/money-snapshot.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useSyncExternalStore } from 'react';\nimport type { TimeSeriesPoint } from '@withpotter/lib/api/types';\n\n/**\n * The last figures the money band actually saw, kept so the band can open with\n * real numbers instead of empty boxes.\n *\n * The home is the first thing an operator looks at, usually on a phone on a bad\n * connection. Making them stare at shimmer (or worse, an error) while the\n * request runs hides the one thing they came for, and the figures rarely move\n * much between two visits minutes apart. So: paint the last known numbers\n * immediately, then swap them for live ones the moment they land.\n *\n * Only the fields the band renders are stored. `DashboardStats` carries twenty\n * other collections (recent events, client errors, page dwell time) that would\n * bloat localStorage for nothing. `DashboardStats` is structurally assignable\n * to `MoneyFigures`, so callers pass the live payload straight through.\n */\n\nexport interface MoneyFigures {\n  sales: {\n    totalRevenue: number;\n    totalOrders: number;\n    averageOrderValue: number;\n  };\n  revenueTimeSeries: TimeSeriesPoint[];\n}\n\nexport interface MoneyOutstanding {\n  totalOutstanding: number;\n  count: number;\n  overdueCount: number;\n}\n\nexport interface MoneySnapshot {\n  data: MoneyFigures;\n  prior: MoneyFigures | null;\n  outstanding: MoneyOutstanding | null;\n  /** Epoch ms the live figures were read. */\n  at: number;\n}\n\n/** Bumped if the stored shape changes, so old entries are ignored, not crashed on. */\nconst VERSION = 1;\n/** Past this, the figures are old enough that showing them silently would mislead. */\nconst MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;\n\nconst key = (tenantSlug: string) =>\n  `potter:home:money:v${VERSION}:${tenantSlug}`;\n\nfunction slim(figures: MoneyFigures): MoneyFigures {\n  return {\n    sales: {\n      totalRevenue: figures.sales.totalRevenue,\n      totalOrders: figures.sales.totalOrders,\n      averageOrderValue: figures.sales.averageOrderValue,\n    },\n    revenueTimeSeries: (figures.revenueTimeSeries ?? []).map((p) => ({\n      date: p.date,\n      value: p.value,\n    })),\n  };\n}\n\nexport function readMoneySnapshot(tenantSlug: string): MoneySnapshot | null {\n  if (typeof window === 'undefined') return null;\n  try {\n    const raw = window.localStorage.getItem(key(tenantSlug));\n    if (!raw) return null;\n    const parsed = JSON.parse(raw) as MoneySnapshot;\n    // A hand-edited or half-written entry must never be able to break the home.\n    if (!parsed?.data?.sales || typeof parsed.at !== 'number') return null;\n    if (Date.now() - parsed.at > MAX_AGE_MS) return null;\n    return parsed;\n  } catch {\n    return null;\n  }\n}\n\nexport function writeMoneySnapshot(\n  tenantSlug: string,\n  snapshot: {\n    data: MoneyFigures;\n    prior: MoneyFigures | null;\n    outstanding: MoneyOutstanding | null;\n  },\n): void {\n  if (typeof window === 'undefined') return;\n  try {\n    const payload: MoneySnapshot = {\n      data: slim(snapshot.data),\n      prior: snapshot.prior ? slim(snapshot.prior) : null,\n      outstanding: snapshot.outstanding\n        ? {\n            totalOutstanding: snapshot.outstanding.totalOutstanding,\n            count: snapshot.outstanding.count,\n            overdueCount: snapshot.outstanding.overdueCount,\n          }\n        : null,\n      at: Date.now(),\n    };\n    window.localStorage.setItem(key(tenantSlug), JSON.stringify(payload));\n  } catch {\n    // Private mode, quota, disabled storage: caching is an optimisation.\n  }\n}\n\n/**\n * Read once per tenant, then held for the life of the tab.\n *\n * `useSyncExternalStore` rather than useState + useEffect, for the same two\n * reasons as `useDaysSinceLastSeen`: setting state synchronously inside an\n * effect cascades renders, and a lazy useState initialiser reading\n * localStorage would desync SSR from hydration and make the figures flicker.\n * getSnapshot must return a stable value, so the parsed object is memoised per\n * slug — recomputing it per call would loop forever.\n */\nconst readOnce = new Map<string, MoneySnapshot | null>();\n\nfunction snapshotFor(tenantSlug: string): MoneySnapshot | null {\n  if (!readOnce.has(tenantSlug)) {\n    readOnce.set(tenantSlug, readMoneySnapshot(tenantSlug));\n  }\n  return readOnce.get(tenantSlug) ?? null;\n}\n\n/** Never changes within a session, so there is nothing to subscribe to. */\nconst subscribe = () => () => {};\n/** Null on the server, so SSR and the first client paint agree. */\nconst getServerSnapshot = (): MoneySnapshot | null => null;\n\nexport function useLastMoneySnapshot(\n  tenantSlug: string | undefined,\n): MoneySnapshot | null {\n  const getSnapshot = useCallback(\n    () => (tenantSlug ? snapshotFor(tenantSlug) : null),\n    [tenantSlug],\n  );\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n\n/**\n * \"a moment ago\" / \"12 minutes ago\" / \"yesterday\". Said in the band's own quiet\n * voice, so a stale figure is never presented as a live one.\n */\nexport function describeAge(at: number, now = Date.now()): string {\n  const mins = Math.max(0, Math.round((now - at) / 60000));\n  if (mins < 2) return 'a moment ago';\n  if (mins < 60) return `${mins} minutes ago`;\n  const hours = Math.round(mins / 60);\n  if (hours < 24) return `${hours} hour${hours === 1 ? '' : 's'} ago`;\n  const days = Math.round(hours / 24);\n  return days === 1 ? 'yesterday' : `${days} days ago`;\n}\n"],"mappings":";AAEA,SAAS,aAAa,4BAA4B;AA2ClD,MAAM,UAAU;AAEhB,MAAM,aAAa,IAAI,KAAK,KAAK,KAAK;AAEtC,MAAM,MAAM,CAAC,eACX,sBAAsB,OAAO,IAAI,UAAU;AAE7C,SAAS,KAAK,SAAqC;AACjD,SAAO;AAAA,IACL,OAAO;AAAA,MACL,cAAc,QAAQ,MAAM;AAAA,MAC5B,aAAa,QAAQ,MAAM;AAAA,MAC3B,mBAAmB,QAAQ,MAAM;AAAA,IACnC;AAAA,IACA,oBAAoB,QAAQ,qBAAqB,CAAC,GAAG,IAAI,CAAC,OAAO;AAAA,MAC/D,MAAM,EAAE;AAAA,MACR,OAAO,EAAE;AAAA,IACX,EAAE;AAAA,EACJ;AACF;AAEO,SAAS,kBAAkB,YAA0C;AAC1E,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,MAAI;AACF,UAAM,MAAM,OAAO,aAAa,QAAQ,IAAI,UAAU,CAAC;AACvD,QAAI,CAAC,IAAK,QAAO;AACjB,UAAM,SAAS,KAAK,MAAM,GAAG;AAE7B,QAAI,CAAC,QAAQ,MAAM,SAAS,OAAO,OAAO,OAAO,SAAU,QAAO;AAClE,QAAI,KAAK,IAAI,IAAI,OAAO,KAAK,WAAY,QAAO;AAChD,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,mBACd,YACA,UAKM;AACN,MAAI,OAAO,WAAW,YAAa;AACnC,MAAI;AACF,UAAM,UAAyB;AAAA,MAC7B,MAAM,KAAK,SAAS,IAAI;AAAA,MACxB,OAAO,SAAS,QAAQ,KAAK,SAAS,KAAK,IAAI;AAAA,MAC/C,aAAa,SAAS,cAClB;AAAA,QACE,kBAAkB,SAAS,YAAY;AAAA,QACvC,OAAO,SAAS,YAAY;AAAA,QAC5B,cAAc,SAAS,YAAY;AAAA,MACrC,IACA;AAAA,MACJ,IAAI,KAAK,IAAI;AAAA,IACf;AACA,WAAO,aAAa,QAAQ,IAAI,UAAU,GAAG,KAAK,UAAU,OAAO,CAAC;AAAA,EACtE,QAAQ;AAAA,EAER;AACF;AAYA,MAAM,WAAW,oBAAI,IAAkC;AAEvD,SAAS,YAAY,YAA0C;AAC7D,MAAI,CAAC,SAAS,IAAI,UAAU,GAAG;AAC7B,aAAS,IAAI,YAAY,kBAAkB,UAAU,CAAC;AAAA,EACxD;AACA,SAAO,SAAS,IAAI,UAAU,KAAK;AACrC;AAGA,MAAM,YAAY,MAAM,MAAM;AAAC;AAE/B,MAAM,oBAAoB,MAA4B;AAE/C,SAAS,qBACd,YACsB;AACtB,QAAM,cAAc;AAAA,IAClB,MAAO,aAAa,YAAY,UAAU,IAAI;AAAA,IAC9C,CAAC,UAAU;AAAA,EACb;AACA,SAAO,qBAAqB,WAAW,aAAa,iBAAiB;AACvE;AAMO,SAAS,YAAY,IAAY,MAAM,KAAK,IAAI,GAAW;AAChE,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,OAAO,MAAM,MAAM,GAAK,CAAC;AACvD,MAAI,OAAO,EAAG,QAAO;AACrB,MAAI,OAAO,GAAI,QAAO,GAAG,IAAI;AAC7B,QAAM,QAAQ,KAAK,MAAM,OAAO,EAAE;AAClC,MAAI,QAAQ,GAAI,QAAO,GAAG,KAAK,QAAQ,UAAU,IAAI,KAAK,GAAG;AAC7D,QAAM,OAAO,KAAK,MAAM,QAAQ,EAAE;AAClC,SAAO,SAAS,IAAI,cAAc,GAAG,IAAI;AAC3C;","names":[]}

package/dist/dashboard/home/next-up-sources.d.ts

@@ -0,0 +1,172 @@
+import type { Order, Invoice, BookingItem, CustomerSubscription } from '@withpotter/lib/api/types';
+/**
+ * "Next up": the home's single archetype-shaped slot.
+ *
+ * WHY THIS REPLACES THE FOUR SUMMARY CARDS. Across all eleven archetypes the
+ * dashboard stat row resolves to the same four numbers wearing different
+ * labels — revenue (9/11), catalog size (9/11), sale count (6/11 plus two
+ * aliases) and average sale (6/11). Three of those are the money band, said
+ * better and with a trend. The fourth, catalog size, answers no question anyone
+ * opens a dashboard to ask.
+ *
+ * What was genuinely archetype-specific in those configs — `todayBookings`,
+ * `upcomingThisWeek`, `upcomingEventCount`, `checkInRate` — is every one of them
+ * a question about TIME: what is happening today, and what is next. That is not
+ * a tile. It is a list on a clock, and this is it.
+ *
+ * MULTI-ARCHETYPE IS THE POINT. A club running courts, a tournament and a shop
+ * used to get three separate panels and had to assemble its own day. Streams
+ * from every active archetype merge into ONE chronological list here, so the
+ * business sees its day rather than its org chart.
+ *
+ * NO ARCHETYPE degrades cleanly: `default` falls back to the order queue, which
+ * every commerce business has, so nothing looks missing on a tenant that never
+ * picked an operating model.
+ */
+export interface NextUpItem {
+    id: string;
+    /**
+     * ISO datetime this is scheduled or due. The sort key. Empty for blocking
+     * items, which have no clock — they simply need doing.
+     */
+    at: string;
+    title: string;
+    meta?: string;
+    href: string;
+    /**
+     * The archetype that contributed this item. Rendered only when the business
+     * runs more than one, where "which part of the business is this?" is a real
+     * question; in a single-model business it would be noise.
+     */
+    stream: string;
+    /** Past its time and still open — an overdue invoice, a passed booking. */
+    overdue?: boolean;
+    /**
+     * Nothing can happen until this is fixed (no payout account, stock about to
+     * run out). Sorts above everything, whatever the clock says.
+     */
+    blocking?: boolean;
+    /**
+     * The verb on a blocking item's button. A blocker is not a row you browse to,
+     * it is a chore with one obvious next move, and "Set up" says what happens
+     * next where a chevron only says "there is more of this somewhere".
+     */
+    action?: string;
+    /**
+     * This one stops money outright, as opposed to merely being urgent. Carries
+     * the `Required` pill and takes the primary button; everything below it is
+     * secondary, so the block states an order of operations rather than offering
+     * a menu of equally loud chores.
+     */
+    required?: boolean;
+}
+/**
+ * Things needing attention that have no clock.
+ *
+ * These used to live in a separate "Needs you" panel beside this one, which
+ * meant the home carried three panels sharing one job: a queue, a triage strip
+ * restating the same orders ("6 orders came in today"), and a feed. Worse, the
+ * triage strip mixed genuine blockers with statistics — "5 new customers this
+ * week" is a fact the money band already covers, not a task.
+ *
+ * What survived is what actually stops the business: no way to get paid, and
+ * stock about to run out. They belong at the top of the ONE worklist, not in a
+ * panel of their own.
+ */
+export interface NextUpAlerts {
+    hasPayments: boolean;
+    /** A bank account exists but its owner is not verified, so payouts wait. */
+    needsIdentity?: boolean;
+    /** Sells goods or food, and has not said where. Never blocks anything. */
+    needsSalesChannel?: boolean;
+    /**
+     * Whether an order can physically reach a customer — a delivery area, or a
+     * shop to collect from.
+     *
+     * `undefined` means the question was not answered, which is NOT the same as
+     * "no". The check lives on the API and an older backend does not serve it,
+     * so an unreachable check must show nothing rather than accuse a shop that
+     * is set up correctly.
+     *
+     * The reason this is a blocker at all is invisible from the merchant's side:
+     * the checkout builds its country/state/city dropdowns from the delivery
+     * ZONES, with no free-text escape and city required. No zone is therefore
+     * not "delivery is unconfigured", it is a checkout no customer can submit —
+     * for collection too, because the address step is still what they land on.
+     */
+    canReceiveOrders?: boolean;
+    lowStockCount: number;
+    /**
+     * The merchant's word for a catalogue item, BOTH forms.
+     *
+     * This took `contentTypeSingular` and pluralised it by appending an "s". Two
+     * faults, both visible on screen:
+     *
+     *   1. `contentTypeSingular` is derived from the TEMPLATE'S INDUSTRY, not from
+     *      `entities.item`. The rest of this page — the setup cards, the header
+     *      button, the sidebar — resolves the noun through `useEntityLabel`, so a
+     *      business that had renamed items to "Property" read "Add property" in
+     *      the header and "3 products low on stock" in this list, on one screen.
+     *   2. `${item}s` is not a pluraliser. It produces "3 propertys", "3 boxs",
+     *      "3 dishs". `EntityLabel` already carries the real plural.
+     */
+    itemLabel: {
+        singular: string;
+        plural: string;
+    };
+    primaryContentHref: string;
+}
+/**
+ * Where "next up" goes, when the business is several things.
+ *
+ * One archetype's answer is that archetype's screen. Several that disagree have
+ * no shared next thing, so it is the queue they all feed, which is what the
+ * sidebar collapses to for the same reason.
+ *
+ * Lives here rather than in the page because it is knowledge about what the
+ * next-up list contains, and the page had no other reason to hold a map of
+ * archetype keys to routes.
+ */
+export declare function resolveNextUpHref(intentKeys: string[]): string;
+export interface NextUpData {
+    upcomingBookings: BookingItem[];
+    recentOrders: Order[];
+    recentInvoices: Invoice[];
+    recentSubscriptions: CustomerSubscription[];
+    formatCurrency: (amount: number, currency?: string) => string;
+}
+type SourceFn = (d: NextUpData, stream: string, now: number) => NextUpItem[];
+/**
+ * What each archetype puts on the clock. Every registered intent key resolves,
+ * and `next-up.test.ts` asserts that — the widget registry drifting out of sync
+ * with the configs is exactly the bug this codebase already shipped once.
+ */
+export declare const NEXT_UP_SOURCES: Record<string, SourceFn>;
+/** The label shown against an item when a business runs several models. */
+export declare const STREAM_FALLBACK = "Activity";
+export declare function selectNextUp(intents: {
+    key: string;
+    label: string;
+}[], data: NextUpData, { now, limit, alerts, extra, }?: {
+    now?: number;
+    limit?: number;
+    alerts?: NextUpAlerts;
+    /**
+     * Blocking work assembled somewhere else.
+     *
+     * The alerts above are things this module can compute from the day's data.
+     * A connection that stopped talking to a provider is not: it is owned by
+     * Connect, which knows nothing about archetypes and should not be imported
+     * here to learn them. It hands finished items in instead, and they sort
+     * with everything else rather than getting a panel of their own — which is
+     * the mistake the "Needs you" strip made before this list absorbed it.
+     */
+    extra?: readonly NextUpItem[];
+}): NextUpItem[];
+/**
+ * Human time for a row: today shows a clock, tomorrow says so, anything further
+ * out shows a weekday and date. Absolute dates beat "in 3 days" here — an
+ * operator is matching this against a physical diary.
+ */
+export declare function formatNextUpTime(iso: string, now?: number): string;
+export {};