@withpotter/components 0.13.0-next.101

package/dist/dashboard/home/ask-voice.js

@@ -0,0 +1,76 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { AnimatePresence, motion } from "motion/react";
+import { durations, eases } from "@withpotter/lib/motion";
+import { AskDictationFlow } from "./ask-dictation-flow";
+const CAPTION = {
+  idle: "",
+  listening: "Listening",
+  thinking: "Working that out",
+  speaking: "Answering",
+  denied: "Your browser is blocking the microphone",
+  unsupported: "This browser cannot listen"
+};
+function AskVoice({
+  state,
+  transcript,
+  spoken,
+  spokenChars,
+  endpointAt,
+  peaksRef,
+  canSpeak
+}) {
+  return /* @__PURE__ */ jsxs(
+    motion.div,
+    {
+      initial: { opacity: 0, y: -4 },
+      animate: { opacity: 1, y: 0 },
+      exit: { opacity: 0, y: -4 },
+      transition: { duration: durations.normal, ease: eases.out },
+      children: [
+        /* @__PURE__ */ jsx("div", { className: "flex items-center justify-between gap-3 px-1", children: /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [
+          /* @__PURE__ */ jsx(
+            "span",
+            {
+              "aria-hidden": true,
+              className: `h-1.5 w-1.5 shrink-0 rounded-full ${state === "listening" ? "animate-pulse bg-[var(--error)]" : state === "denied" || state === "unsupported" ? "bg-[var(--error)]" : "bg-brand-500"}`
+            }
+          ),
+          /* @__PURE__ */ jsxs(
+            "span",
+            {
+              "aria-live": "polite",
+              className: "truncate text-sm text-[var(--text-tertiary)]",
+              children: [
+                CAPTION[state],
+                state === "listening" && /* @__PURE__ */ jsxs("span", { className: "text-[var(--text-muted)]", children: [
+                  " ",
+                  "\xB7 pause when you are done"
+                ] }),
+                state === "listening" && !canSpeak && /* @__PURE__ */ jsxs("span", { className: "text-[var(--text-muted)]", children: [
+                  " ",
+                  "\xB7 answers on screen, this browser has no voice"
+                ] })
+              ]
+            }
+          )
+        ] }) }),
+        /* @__PURE__ */ jsx(AnimatePresence, { children: state !== "denied" && state !== "unsupported" && /* @__PURE__ */ jsx(
+          AskDictationFlow,
+          {
+            peaksRef,
+            transcript,
+            state,
+            spoken,
+            spokenChars,
+            endpointAt
+          }
+        ) })
+      ]
+    }
+  );
+}
+export {
+  AskVoice
+};
+//# sourceMappingURL=ask-voice.js.map

package/dist/dashboard/home/ask-voice.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/dashboard/home/ask-voice.tsx"],"sourcesContent":["'use client';\n\nimport { AnimatePresence, motion } from 'motion/react';\nimport { durations, eases } from '@withpotter/lib/motion';\nimport type { VoiceModeState } from '@withpotter/hooks/use-voice-mode';\nimport { AskDictationFlow } from './ask-dictation-flow';\n\n/**\n * Voice mode, on screen.\n *\n * ONE LINE OF STATUS AND ONE WAY OUT, over the curve that is doing the actual\n * talking. Everything else here was resisted: a mode that puts a panel on the\n * page has stopped being a mode and become a screen, and a screen is a thing\n * you have to come back FROM. The board behind is already faded, the field\n * above is already the transcript, and the curve below is already the state —\n * so what is left to add is the name of the state and a stop button.\n *\n * THE STATUS LINE IS NOT DECORATION. Voice is the one interface with no visible\n * affordances: nothing on screen says whether the microphone is open, whether\n * the question went, or whether the silence is being counted. Every one of\n * those is a thing the merchant can only otherwise discover by talking into a\n * dead mic for ten seconds. So each state says its own name, in the app's own\n * quiet register, and the sentence under `listening` is the one piece of\n * instruction in the whole feature because pausing-to-commit is the single rule\n * nobody can guess.\n *\n * STOP IS ALWAYS THERE, in every state including while Box is speaking. The\n * microphone is closed during the reply — see `use-voice-mode`, it has to be or\n * the recogniser transcribes the synthesiser — which means there is no way to\n * interrupt by talking. A mode you cannot interrupt by voice must be\n * interruptible by hand, always, and never behind a hover or a modifier.\n *\n * AND IT IS THE MIC, not a second button down here. This row shipped its own\n * red stop square, which put two identical stop controls eight pixels apart —\n * one in the bar where the mic had turned red, one directly under it. A\n * screenshot found it in a second and no measurement could have: both were\n * correct on their own, and the duplication only exists in the composition.\n * The bar's wins, because it is the same control you pressed to start and it\n * is inside the thing you are using rather than in a caption about it.\n *\n * WHEN THE BROWSER CANNOT TALK BACK it says so once, here, rather than being\n * silently downgraded. Firefox has no `SpeechRecognition` at all so voice mode\n * never appears there; a browser that hears but cannot speak is the awkward\n * middle case, and the merchant needs to know the answer is going to arrive on\n * screen before they spend a sentence waiting for it out loud.\n */\n\nconst CAPTION: Record<VoiceModeState, string> = {\n  idle: '',\n  listening: 'Listening',\n  thinking: 'Working that out',\n  speaking: 'Answering',\n  denied: 'Your browser is blocking the microphone',\n  unsupported: 'This browser cannot listen',\n};\n\nexport function AskVoice({\n  state,\n  transcript,\n  spoken,\n  spokenChars,\n  endpointAt,\n  peaksRef,\n  canSpeak,\n}: {\n  state: VoiceModeState;\n  transcript: string;\n  spoken: string;\n  spokenChars: number;\n  endpointAt: number | null;\n  peaksRef: { current: number[] };\n  canSpeak: boolean;\n}) {\n  return (\n    <motion.div\n      initial={{ opacity: 0, y: -4 }}\n      animate={{ opacity: 1, y: 0 }}\n      exit={{ opacity: 0, y: -4 }}\n      transition={{ duration: durations.normal, ease: eases.out }}\n    >\n      <div className=\"flex items-center justify-between gap-3 px-1\">\n        <span className=\"flex min-w-0 items-center gap-2\">\n          {/* The dot is the tell that survives a glance. It only pulses while\n              the microphone is actually open, so \"is it listening?\" is\n              answerable from across a counter without reading a word. */}\n          <span\n            aria-hidden\n            className={`h-1.5 w-1.5 shrink-0 rounded-full ${\n              state === 'listening'\n                ? 'animate-pulse bg-[var(--error)]'\n                : state === 'denied' || state === 'unsupported'\n                  ? 'bg-[var(--error)]'\n                  : 'bg-brand-500'\n            }`}\n          />\n          {/* `aria-live` because this is the only report of a state change in a\n              mode whose whole point is that nobody is looking at the screen. */}\n          <span\n            aria-live=\"polite\"\n            className=\"truncate text-sm text-[var(--text-tertiary)]\"\n          >\n            {CAPTION[state]}\n            {state === 'listening' && (\n              <span className=\"text-[var(--text-muted)]\">\n                {' '}\n                · pause when you are done\n              </span>\n            )}\n            {state === 'listening' && !canSpeak && (\n              <span className=\"text-[var(--text-muted)]\">\n                {' '}\n                · answers on screen, this browser has no voice\n              </span>\n            )}\n          </span>\n        </span>\n      </div>\n\n      {/* Only while there is something for the curve to carry. A serpentine\n          holding no words and no levels is a decoration, and this surface has\n          spent its whole design arguing against those. */}\n      <AnimatePresence>\n        {state !== 'denied' && state !== 'unsupported' && (\n          <AskDictationFlow\n            peaksRef={peaksRef}\n            transcript={transcript}\n            state={state}\n            spoken={spoken}\n            spokenChars={spokenChars}\n            endpointAt={endpointAt}\n          />\n        )}\n      </AnimatePresence>\n    </motion.div>\n  );\n}\n"],"mappings":";AAqFU,cAkBI,YAlBJ;AAnFV,SAAS,iBAAiB,cAAc;AACxC,SAAS,WAAW,aAAa;AAEjC,SAAS,wBAAwB;AA0CjC,MAAM,UAA0C;AAAA,EAC9C,MAAM;AAAA,EACN,WAAW;AAAA,EACX,UAAU;AAAA,EACV,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,aAAa;AACf;AAEO,SAAS,SAAS;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAQG;AACD,SACE;AAAA,IAAC,OAAO;AAAA,IAAP;AAAA,MACC,SAAS,EAAE,SAAS,GAAG,GAAG,GAAG;AAAA,MAC7B,SAAS,EAAE,SAAS,GAAG,GAAG,EAAE;AAAA,MAC5B,MAAM,EAAE,SAAS,GAAG,GAAG,GAAG;AAAA,MAC1B,YAAY,EAAE,UAAU,UAAU,QAAQ,MAAM,MAAM,IAAI;AAAA,MAE1D;AAAA,4BAAC,SAAI,WAAU,gDACb,+BAAC,UAAK,WAAU,mCAId;AAAA;AAAA,YAAC;AAAA;AAAA,cACC,eAAW;AAAA,cACX,WAAW,qCACT,UAAU,cACN,oCACA,UAAU,YAAY,UAAU,gBAC9B,sBACA,cACR;AAAA;AAAA,UACF;AAAA,UAGA;AAAA,YAAC;AAAA;AAAA,cACC,aAAU;AAAA,cACV,WAAU;AAAA,cAET;AAAA,wBAAQ,KAAK;AAAA,gBACb,UAAU,eACT,qBAAC,UAAK,WAAU,4BACb;AAAA;AAAA,kBAAI;AAAA,mBAEP;AAAA,gBAED,UAAU,eAAe,CAAC,YACzB,qBAAC,UAAK,WAAU,4BACb;AAAA;AAAA,kBAAI;AAAA,mBAEP;AAAA;AAAA;AAAA,UAEJ;AAAA,WACF,GACF;AAAA,QAKA,oBAAC,mBACE,oBAAU,YAAY,UAAU,iBAC/B;AAAA,UAAC;AAAA;AAAA,YACC;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA;AAAA,QACF,GAEJ;AAAA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/dashboard/home/card-scroller.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A horizontal card rail that SAYS it scrolls.
+ *
+ * The setup cards were a `overflow-x-auto` strip with the scrollbar hidden and
+ * four cards in a three-card viewport, so the fourth was simply invisible with
+ * nothing indicating it existed. Hidden scrollbars are fine; hiding the fact
+ * that there is more is not.
+ *
+ * The affordance is an arrow button that appears only on the side that actually
+ * has more, driven by measured scroll state rather than assumed. Deliberately
+ * no edge-fade mask: that needs a gradient, and gradients are banned in this
+ * design system. Native scroll, swipe and snap behaviour is untouched, and the
+ * arrows are real labelled buttons, so the rail is navigable by keyboard too.
+ */
+export declare function CardScroller({ children, className, }: {
+    children: React.ReactNode;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/dashboard/home/card-scroller.js

@@ -0,0 +1,67 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { ChevronLeft, ChevronRight } from "lucide-react";
+function CardScroller({
+  children,
+  className = ""
+}) {
+  const ref = useRef(null);
+  const [atStart, setAtStart] = useState(true);
+  const [atEnd, setAtEnd] = useState(true);
+  const measure = useCallback(() => {
+    const el = ref.current;
+    if (!el) return;
+    const TOL = 8;
+    setAtStart(el.scrollLeft <= TOL);
+    setAtEnd(el.scrollLeft + el.clientWidth >= el.scrollWidth - TOL);
+  }, []);
+  useEffect(() => {
+    const el = ref.current;
+    if (!el) return;
+    measure();
+    const ro = new ResizeObserver(measure);
+    ro.observe(el);
+    for (const child of Array.from(el.children)) ro.observe(child);
+    return () => ro.disconnect();
+  }, [measure]);
+  const scrollBy = (dir) => {
+    const el = ref.current;
+    if (!el) return;
+    const step = Math.max(240, el.clientWidth * 0.6);
+    el.scrollBy({ left: dir * step, behavior: "smooth" });
+  };
+  return /* @__PURE__ */ jsxs("div", { className: `relative ${className}`, children: [
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref,
+        onScroll: measure,
+        className: "-mx-1 flex snap-x snap-mandatory gap-4 overflow-x-auto px-1 pb-1 [scrollbar-width:none] [&::-webkit-scrollbar]:hidden",
+        children
+      }
+    ),
+    !atStart && /* @__PURE__ */ jsx(ScrollButton, { side: "left", onClick: () => scrollBy(-1) }),
+    !atEnd && /* @__PURE__ */ jsx(ScrollButton, { side: "right", onClick: () => scrollBy(1) })
+  ] });
+}
+function ScrollButton({
+  side,
+  onClick
+}) {
+  const Icon = side === "left" ? ChevronLeft : ChevronRight;
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      onClick,
+      "aria-label": side === "left" ? "Scroll back" : "Scroll for more",
+      className: `surface absolute top-1/2 grid h-8 w-8 -translate-y-1/2 place-items-center text-[var(--text-secondary)] transition-colors hover:text-[var(--text-primary)] ${side === "left" ? "-left-2" : "-right-2"}`,
+      children: /* @__PURE__ */ jsx(Icon, { className: "h-[13px] w-[13px]" })
+    }
+  );
+}
+export {
+  CardScroller
+};
+//# sourceMappingURL=card-scroller.js.map

package/dist/dashboard/home/card-scroller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/dashboard/home/card-scroller.tsx"],"sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { ChevronLeft, ChevronRight } from 'lucide-react';\n\n/**\n * A horizontal card rail that SAYS it scrolls.\n *\n * The setup cards were a `overflow-x-auto` strip with the scrollbar hidden and\n * four cards in a three-card viewport, so the fourth was simply invisible with\n * nothing indicating it existed. Hidden scrollbars are fine; hiding the fact\n * that there is more is not.\n *\n * The affordance is an arrow button that appears only on the side that actually\n * has more, driven by measured scroll state rather than assumed. Deliberately\n * no edge-fade mask: that needs a gradient, and gradients are banned in this\n * design system. Native scroll, swipe and snap behaviour is untouched, and the\n * arrows are real labelled buttons, so the rail is navigable by keyboard too.\n */\nexport function CardScroller({\n  children,\n  className = '',\n}: {\n  children: React.ReactNode;\n  className?: string;\n}) {\n  const ref = useRef<HTMLDivElement>(null);\n  const [atStart, setAtStart] = useState(true);\n  const [atEnd, setAtEnd] = useState(true);\n\n  const measure = useCallback(() => {\n    const el = ref.current;\n    if (!el) return;\n    // 8px tolerance. The rail carries `px-1` scroll padding and snap alignment,\n    // so a rail sitting at its true start measures scrollLeft ~4, not 0 — at a\n    // 2px tolerance the \"scroll back\" arrow was showing when there was nothing\n    // to scroll back to.\n    const TOL = 8;\n    setAtStart(el.scrollLeft <= TOL);\n    setAtEnd(el.scrollLeft + el.clientWidth >= el.scrollWidth - TOL);\n  }, []);\n\n  useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    measure();\n    const ro = new ResizeObserver(measure);\n    ro.observe(el);\n    for (const child of Array.from(el.children)) ro.observe(child);\n    return () => ro.disconnect();\n  }, [measure]);\n\n  const scrollBy = (dir: 1 | -1) => {\n    const el = ref.current;\n    if (!el) return;\n    // Roughly one card, so a click lands on a card edge rather than mid-card.\n    const step = Math.max(240, el.clientWidth * 0.6);\n    el.scrollBy({ left: dir * step, behavior: 'smooth' });\n  };\n\n  return (\n    <div className={`relative ${className}`}>\n      <div\n        ref={ref}\n        onScroll={measure}\n        className=\"-mx-1 flex snap-x snap-mandatory gap-4 overflow-x-auto px-1 pb-1 [scrollbar-width:none] [&::-webkit-scrollbar]:hidden\"\n      >\n        {children}\n      </div>\n\n      {!atStart && <ScrollButton side=\"left\" onClick={() => scrollBy(-1)} />}\n      {!atEnd && <ScrollButton side=\"right\" onClick={() => scrollBy(1)} />}\n    </div>\n  );\n}\n\nfunction ScrollButton({\n  side,\n  onClick,\n}: {\n  side: 'left' | 'right';\n  onClick: () => void;\n}) {\n  const Icon = side === 'left' ? ChevronLeft : ChevronRight;\n  return (\n    <button\n      type=\"button\"\n      onClick={onClick}\n      aria-label={side === 'left' ? 'Scroll back' : 'Scroll for more'}\n      className={`surface absolute top-1/2 grid h-8 w-8 -translate-y-1/2 place-items-center text-[var(--text-secondary)] transition-colors hover:text-[var(--text-primary)] ${\n        side === 'left' ? '-left-2' : '-right-2'\n      }`}\n    >\n      <Icon className=\"h-[13px] w-[13px]\" />\n    </button>\n  );\n}\n"],"mappings":";AA6DI,SACE,KADF;AA3DJ,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AACzD,SAAS,aAAa,oBAAoB;AAgBnC,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA,YAAY;AACd,GAGG;AACD,QAAM,MAAM,OAAuB,IAAI;AACvC,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,IAAI;AAC3C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,IAAI;AAEvC,QAAM,UAAU,YAAY,MAAM;AAChC,UAAM,KAAK,IAAI;AACf,QAAI,CAAC,GAAI;AAKT,UAAM,MAAM;AACZ,eAAW,GAAG,cAAc,GAAG;AAC/B,aAAS,GAAG,aAAa,GAAG,eAAe,GAAG,cAAc,GAAG;AAAA,EACjE,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM;AACd,UAAM,KAAK,IAAI;AACf,QAAI,CAAC,GAAI;AACT,YAAQ;AACR,UAAM,KAAK,IAAI,eAAe,OAAO;AACrC,OAAG,QAAQ,EAAE;AACb,eAAW,SAAS,MAAM,KAAK,GAAG,QAAQ,EAAG,IAAG,QAAQ,KAAK;AAC7D,WAAO,MAAM,GAAG,WAAW;AAAA,EAC7B,GAAG,CAAC,OAAO,CAAC;AAEZ,QAAM,WAAW,CAAC,QAAgB;AAChC,UAAM,KAAK,IAAI;AACf,QAAI,CAAC,GAAI;AAET,UAAM,OAAO,KAAK,IAAI,KAAK,GAAG,cAAc,GAAG;AAC/C,OAAG,SAAS,EAAE,MAAM,MAAM,MAAM,UAAU,SAAS,CAAC;AAAA,EACtD;AAEA,SACE,qBAAC,SAAI,WAAW,YAAY,SAAS,IACnC;AAAA;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,UAAU;AAAA,QACV,WAAU;AAAA,QAET;AAAA;AAAA,IACH;AAAA,IAEC,CAAC,WAAW,oBAAC,gBAAa,MAAK,QAAO,SAAS,MAAM,SAAS,EAAE,GAAG;AAAA,IACnE,CAAC,SAAS,oBAAC,gBAAa,MAAK,SAAQ,SAAS,MAAM,SAAS,CAAC,GAAG;AAAA,KACpE;AAEJ;AAEA,SAAS,aAAa;AAAA,EACpB;AAAA,EACA;AACF,GAGG;AACD,QAAM,OAAO,SAAS,SAAS,cAAc;AAC7C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL;AAAA,MACA,cAAY,SAAS,SAAS,gBAAgB;AAAA,MAC9C,WAAW,6JACT,SAAS,SAAS,YAAY,UAChC;AAAA,MAEA,8BAAC,QAAK,WAAU,qBAAoB;AAAA;AAAA,EACtC;AAEJ;","names":[]}

package/dist/dashboard/home/demo-data.d.ts

@@ -0,0 +1,31 @@
+import type { Order, Invoice, BookingItem, Member, DashboardStats, OutstandingInvoices, MerchantBalance, TopProduct } from '@withpotter/lib/api/types';
+import type { ActivityItem } from '../activity-feed';
+export interface HomeDemoData {
+    orderStats: {
+        total: number;
+        revenue: number;
+        today: number;
+    };
+    bookingStats: {
+        today: number;
+    };
+    recentOrders: Order[];
+    recentInvoices: Invoice[];
+    upcomingBookings: BookingItem[];
+    recentMembers: Member[];
+    activities: ActivityItem[];
+    analytics: DashboardStats;
+    priorAnalytics: DashboardStats;
+    outstanding: OutstandingInvoices;
+    balance: MerchantBalance;
+    lowStockCount: number;
+    newClientsCount: number;
+    /**
+     * Top sellers, so `?demo=1` can exercise the Noticed panel's concentration
+     * finding. Deliberately shaped so the leader beats the rest combined — that
+     * is the condition the finding tests for, and a demo that never trips it
+     * leaves the surface unjudgeable.
+     */
+    topProducts: TopProduct[];
+}
+export declare function buildHomeDemoData(): HomeDemoData;

package/dist/dashboard/home/demo-data.js

@@ -0,0 +1,217 @@
+const hoursFromNow = (h) => new Date(Date.now() + h * 36e5).toISOString();
+const daysFromNow = (d) => new Date(Date.now() + d * 864e5);
+const isoDay = (d) => daysFromNow(d).toISOString().slice(0, 10);
+const NAMES = [
+  "Chidera Okonkwo",
+  "Tolu Adeyemi",
+  "Amaka Nwosu",
+  "Bimpe Salami",
+  "Kelechi Obi",
+  "Zainab Bello",
+  "Femi Adebayo",
+  "Ngozi Eze"
+];
+function revenueSeries(scale) {
+  const shape = [
+    4,
+    6,
+    3,
+    7,
+    9,
+    14,
+    11,
+    5,
+    6,
+    4,
+    8,
+    10,
+    15,
+    12,
+    6,
+    5,
+    7,
+    9,
+    11,
+    16,
+    13,
+    7,
+    6,
+    8,
+    10,
+    12,
+    18,
+    14,
+    9,
+    11
+  ];
+  return shape.map((v, i) => ({
+    date: isoDay(i - 29),
+    value: Math.round(v * scale)
+  }));
+}
+function buildHomeDemoData() {
+  const series = revenueSeries(4800);
+  const priorSeries = revenueSeries(3900);
+  const revenue = series.reduce((a, p) => a + p.value, 0);
+  const priorRevenue = priorSeries.reduce((a, p) => a + p.value, 0);
+  const orders = 148;
+  const mk = (x) => x;
+  return {
+    orderStats: { total: orders, revenue, today: 6 },
+    bookingStats: { today: 7 },
+    lowStockCount: 3,
+    newClientsCount: 5,
+    topProducts: [
+      {
+        contentId: "demo-p1",
+        title: "\xCCs\u1ECD\u0300 Serving Bowl",
+        unitsSold: 62,
+        revenue: 1612e3
+      },
+      {
+        contentId: "demo-p2",
+        title: "Ridged Tumbler",
+        unitsSold: 41,
+        revenue: 574e3
+      },
+      {
+        contentId: "demo-p3",
+        title: "Ash Glaze Mug",
+        unitsSold: 38,
+        revenue: 456e3
+      },
+      {
+        contentId: "demo-p4",
+        title: "Stoneware Jug",
+        unitsSold: 12,
+        revenue: 288e3
+      },
+      {
+        contentId: "demo-p5",
+        title: "Small Planter",
+        unitsSold: 9,
+        revenue: 153e3
+      }
+    ],
+    recentOrders: [0, 1, 2].map(
+      (i) => mk({
+        id: `demo-order-${i}`,
+        orderNumber: `#10${42 + i}`,
+        status: i === 0 ? "pending" : "processing",
+        total: [18500, 42e3, 9500][i],
+        customerName: NAMES[i],
+        customerEmail: `${NAMES[i].split(" ")[0].toLowerCase()}@example.com`,
+        createdAt: hoursFromNow(-(i * 5 + 1))
+      })
+    ),
+    recentInvoices: [
+      mk({
+        id: "demo-inv-1",
+        invoiceNumber: "INV-0084",
+        status: "sent",
+        total: 25e4,
+        amountDue: 25e4,
+        currency: "NGN",
+        customerName: NAMES[3],
+        customerEmail: "bimpe@example.com",
+        dueDate: isoDay(-6),
+        issueDate: isoDay(-20)
+      }),
+      mk({
+        id: "demo-inv-2",
+        invoiceNumber: "INV-0091",
+        status: "sent",
+        total: 9e4,
+        amountDue: 9e4,
+        currency: "NGN",
+        customerName: NAMES[4],
+        customerEmail: "kelechi@example.com",
+        dueDate: isoDay(4),
+        issueDate: isoDay(-2)
+      })
+    ],
+    upcomingBookings: [
+      ["Studio hire \xB7 Evening", 2, "confirmed"],
+      ["Wheel throwing \xB7 Beginner", 4, "confirmed"],
+      ["Glazing workshop", 26, "pending"],
+      ["Studio hire \xB7 Evening", 30, "confirmed"]
+    ].map(([title, hrs, status], i) => {
+      const when = daysFromNow(hrs / 24);
+      return mk({
+        id: `demo-booking-${i}`,
+        bookingNumber: `BK-${200 + i}`,
+        status,
+        date: when.toISOString().slice(0, 10),
+        startTime: `${String(when.getHours()).padStart(2, "0")}:${String(
+          when.getMinutes()
+        ).padStart(2, "0")}`,
+        customerName: NAMES[(i + 2) % NAMES.length],
+        content: { title }
+      });
+    }),
+    recentMembers: [0, 1, 2, 3].map(
+      (i) => mk({
+        id: `demo-member-${i}`,
+        name: NAMES[(i + 4) % NAMES.length],
+        email: `${NAMES[(i + 4) % NAMES.length].split(" ")[0].toLowerCase()}@example.com`,
+        createdAt: hoursFromNow(-(i * 9 + 2))
+      })
+    ),
+    activities: [
+      ["order_placed", "New order", `${NAMES[0]} \xB7 \u20A618,500`, -1],
+      ["member_signup", "New customer", NAMES[4], -3],
+      ["invoice_paid", "Invoice paid", "INV-0079 \xB7 \u20A6140,000", -7],
+      ["order_completed", "Order fulfilled", "#1039", -11],
+      ["product_added", "Added to catalog", "Ash Glaze Mug", -26]
+    ].map(
+      ([type, title, description, hrs], i) => mk({
+        id: `demo-act-${i}`,
+        type,
+        emoji: "",
+        title,
+        description,
+        timestamp: hoursFromNow(hrs)
+      })
+    ),
+    analytics: mk({
+      sales: {
+        totalRevenue: revenue,
+        totalOrders: orders,
+        averageOrderValue: Math.round(revenue / orders),
+        // Order-sourced in the real payload, so the seed keeps it plausible
+        // against the order count rather than a round number: 31 of 148 orders
+        // used a code.
+        totalDiscounted: 214500,
+        discountedOrders: 31
+      },
+      revenueTimeSeries: series
+    }),
+    priorAnalytics: mk({
+      sales: {
+        totalRevenue: priorRevenue,
+        totalOrders: 121,
+        averageOrderValue: Math.round(priorRevenue / 121),
+        totalDiscounted: 168200,
+        discountedOrders: 24
+      },
+      revenueTimeSeries: priorSeries
+    }),
+    outstanding: mk({
+      totalOutstanding: 34e4,
+      count: 2,
+      overdueCount: 1,
+      overdueAmount: 25e4
+    }),
+    balance: mk({
+      inTransit: 486500,
+      heldByPotter: 0,
+      pendingWithdrawals: 0,
+      settledToBank: 214e4,
+      currency: "NGN"
+    })
+  };
+}
+export {
+  buildHomeDemoData
+};
+//# sourceMappingURL=demo-data.js.map

package/dist/dashboard/home/demo-data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/dashboard/home/demo-data.ts"],"sourcesContent":["import type {\n  Order,\n  Invoice,\n  BookingItem,\n  Member,\n  DashboardStats,\n  OutstandingInvoices,\n  MerchantBalance,\n  TopProduct,\n} from '@withpotter/lib/api/types';\nimport type { ActivityItem } from '../activity-feed';\n\n/**\n * Sample data for `?demo=1` on the dashboard home.\n *\n * WHY THIS EXISTS. Every design decision on this page — how money reads at\n * scale, whether \"Next up\" earns its column, whether the rail is worth a third\n * of the width — is impossible to judge against a tenant with nothing in it. A\n * page that only ever renders empty gets designed for the empty case.\n *\n * WHAT IT IS NOT. It writes nothing, touches no API, and is reachable only by\n * typing `?demo=1`. It never activates from real state, so there is no path\n * where a merchant sees invented figures presented as their own. Drop the query\n * param and the page is back on live data.\n *\n * Everything is generated RELATIVE TO NOW so the timeline always looks live:\n * bookings later today, an invoice overdue since last week, orders from this\n * morning.\n */\n\nconst hoursFromNow = (h: number) =>\n  new Date(Date.now() + h * 3_600_000).toISOString();\nconst daysFromNow = (d: number) => new Date(Date.now() + d * 86_400_000);\nconst isoDay = (d: number) => daysFromNow(d).toISOString().slice(0, 10);\n\nconst NAMES = [\n  'Chidera Okonkwo',\n  'Tolu Adeyemi',\n  'Amaka Nwosu',\n  'Bimpe Salami',\n  'Kelechi Obi',\n  'Zainab Bello',\n  'Femi Adebayo',\n  'Ngozi Eze',\n];\n\nexport interface HomeDemoData {\n  orderStats: { total: number; revenue: number; today: number };\n  bookingStats: { today: number };\n  recentOrders: Order[];\n  recentInvoices: Invoice[];\n  upcomingBookings: BookingItem[];\n  recentMembers: Member[];\n  activities: ActivityItem[];\n  analytics: DashboardStats;\n  priorAnalytics: DashboardStats;\n  outstanding: OutstandingInvoices;\n  balance: MerchantBalance;\n  lowStockCount: number;\n  newClientsCount: number;\n  /**\n   * Top sellers, so `?demo=1` can exercise the Noticed panel's concentration\n   * finding. Deliberately shaped so the leader beats the rest combined — that\n   * is the condition the finding tests for, and a demo that never trips it\n   * leaves the surface unjudgeable.\n   */\n  topProducts: TopProduct[];\n}\n\n/** A 30-day revenue series that looks like a real business, not a ramp. */\nfunction revenueSeries(scale: number) {\n  const shape = [\n    4, 6, 3, 7, 9, 14, 11, 5, 6, 4, 8, 10, 15, 12, 6, 5, 7, 9, 11, 16, 13, 7, 6,\n    8, 10, 12, 18, 14, 9, 11,\n  ];\n  return shape.map((v, i) => ({\n    date: isoDay(i - 29),\n    value: Math.round(v * scale),\n  }));\n}\n\nexport function buildHomeDemoData(): HomeDemoData {\n  const series = revenueSeries(4800);\n  const priorSeries = revenueSeries(3900);\n  const revenue = series.reduce((a, p) => a + p.value, 0);\n  const priorRevenue = priorSeries.reduce((a, p) => a + p.value, 0);\n  const orders = 148;\n\n  const mk = <T>(x: T): T => x;\n\n  return {\n    orderStats: { total: orders, revenue, today: 6 },\n    bookingStats: { today: 7 },\n    lowStockCount: 3,\n    newClientsCount: 5,\n\n    topProducts: [\n      {\n        contentId: 'demo-p1',\n        title: 'Ìsọ̀ Serving Bowl',\n        unitsSold: 62,\n        revenue: 1_612_000,\n      },\n      {\n        contentId: 'demo-p2',\n        title: 'Ridged Tumbler',\n        unitsSold: 41,\n        revenue: 574_000,\n      },\n      {\n        contentId: 'demo-p3',\n        title: 'Ash Glaze Mug',\n        unitsSold: 38,\n        revenue: 456_000,\n      },\n      {\n        contentId: 'demo-p4',\n        title: 'Stoneware Jug',\n        unitsSold: 12,\n        revenue: 288_000,\n      },\n      {\n        contentId: 'demo-p5',\n        title: 'Small Planter',\n        unitsSold: 9,\n        revenue: 153_000,\n      },\n    ],\n\n    recentOrders: [0, 1, 2].map((i) =>\n      mk({\n        id: `demo-order-${i}`,\n        orderNumber: `#10${42 + i}`,\n        status: i === 0 ? 'pending' : 'processing',\n        total: [18500, 42000, 9500][i],\n        customerName: NAMES[i],\n        customerEmail: `${NAMES[i].split(' ')[0].toLowerCase()}@example.com`,\n        createdAt: hoursFromNow(-(i * 5 + 1)),\n      } as unknown as Order),\n    ),\n\n    recentInvoices: [\n      mk({\n        id: 'demo-inv-1',\n        invoiceNumber: 'INV-0084',\n        status: 'sent',\n        total: 250000,\n        amountDue: 250000,\n        currency: 'NGN',\n        customerName: NAMES[3],\n        customerEmail: 'bimpe@example.com',\n        dueDate: isoDay(-6),\n        issueDate: isoDay(-20),\n      } as unknown as Invoice),\n      mk({\n        id: 'demo-inv-2',\n        invoiceNumber: 'INV-0091',\n        status: 'sent',\n        total: 90000,\n        amountDue: 90000,\n        currency: 'NGN',\n        customerName: NAMES[4],\n        customerEmail: 'kelechi@example.com',\n        dueDate: isoDay(4),\n        issueDate: isoDay(-2),\n      } as unknown as Invoice),\n    ],\n\n    upcomingBookings: [\n      ['Studio hire · Evening', 2, 'confirmed'],\n      ['Wheel throwing · Beginner', 4, 'confirmed'],\n      ['Glazing workshop', 26, 'pending'],\n      ['Studio hire · Evening', 30, 'confirmed'],\n    ].map(([title, hrs, status], i) => {\n      const when = daysFromNow((hrs as number) / 24);\n      return mk({\n        id: `demo-booking-${i}`,\n        bookingNumber: `BK-${200 + i}`,\n        status,\n        date: when.toISOString().slice(0, 10),\n        startTime: `${String(when.getHours()).padStart(2, '0')}:${String(\n          when.getMinutes(),\n        ).padStart(2, '0')}`,\n        customerName: NAMES[(i + 2) % NAMES.length],\n        content: { title },\n      } as unknown as BookingItem);\n    }),\n\n    recentMembers: [0, 1, 2, 3].map((i) =>\n      mk({\n        id: `demo-member-${i}`,\n        name: NAMES[(i + 4) % NAMES.length],\n        email: `${NAMES[(i + 4) % NAMES.length]\n          .split(' ')[0]\n          .toLowerCase()}@example.com`,\n        createdAt: hoursFromNow(-(i * 9 + 2)),\n      } as unknown as Member),\n    ),\n\n    activities: [\n      ['order_placed', 'New order', `${NAMES[0]} · ₦18,500`, -1],\n      ['member_signup', 'New customer', NAMES[4], -3],\n      ['invoice_paid', 'Invoice paid', 'INV-0079 · ₦140,000', -7],\n      ['order_completed', 'Order fulfilled', '#1039', -11],\n      ['product_added', 'Added to catalog', 'Ash Glaze Mug', -26],\n    ].map(([type, title, description, hrs], i) =>\n      mk({\n        id: `demo-act-${i}`,\n        type,\n        emoji: '',\n        title,\n        description,\n        timestamp: hoursFromNow(hrs as number),\n      } as unknown as ActivityItem),\n    ),\n\n    analytics: mk({\n      sales: {\n        totalRevenue: revenue,\n        totalOrders: orders,\n        averageOrderValue: Math.round(revenue / orders),\n        // Order-sourced in the real payload, so the seed keeps it plausible\n        // against the order count rather than a round number: 31 of 148 orders\n        // used a code.\n        totalDiscounted: 214_500,\n        discountedOrders: 31,\n      },\n      revenueTimeSeries: series,\n    } as unknown as DashboardStats),\n\n    priorAnalytics: mk({\n      sales: {\n        totalRevenue: priorRevenue,\n        totalOrders: 121,\n        averageOrderValue: Math.round(priorRevenue / 121),\n        totalDiscounted: 168_200,\n        discountedOrders: 24,\n      },\n      revenueTimeSeries: priorSeries,\n    } as unknown as DashboardStats),\n\n    outstanding: mk({\n      totalOutstanding: 340000,\n      count: 2,\n      overdueCount: 1,\n      overdueAmount: 250000,\n    } as unknown as OutstandingInvoices),\n\n    balance: mk({\n      inTransit: 486500,\n      heldByPotter: 0,\n      pendingWithdrawals: 0,\n      settledToBank: 2140000,\n      currency: 'NGN',\n    } as unknown as MerchantBalance),\n  };\n}\n"],"mappings":"AA8BA,MAAM,eAAe,CAAC,MACpB,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,IAAS,EAAE,YAAY;AACnD,MAAM,cAAc,CAAC,MAAc,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAU;AACvE,MAAM,SAAS,CAAC,MAAc,YAAY,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE;AAEtE,MAAM,QAAQ;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AA0BA,SAAS,cAAc,OAAe;AACpC,QAAM,QAAQ;AAAA,IACZ;AAAA,IAAG;AAAA,IAAG;AAAA,IAAG;AAAA,IAAG;AAAA,IAAG;AAAA,IAAI;AAAA,IAAI;AAAA,IAAG;AAAA,IAAG;AAAA,IAAG;AAAA,IAAG;AAAA,IAAI;AAAA,IAAI;AAAA,IAAI;AAAA,IAAG;AAAA,IAAG;AAAA,IAAG;AAAA,IAAG;AAAA,IAAI;AAAA,IAAI;AAAA,IAAI;AAAA,IAAG;AAAA,IAC1E;AAAA,IAAG;AAAA,IAAI;AAAA,IAAI;AAAA,IAAI;AAAA,IAAI;AAAA,IAAG;AAAA,EACxB;AACA,SAAO,MAAM,IAAI,CAAC,GAAG,OAAO;AAAA,IAC1B,MAAM,OAAO,IAAI,EAAE;AAAA,IACnB,OAAO,KAAK,MAAM,IAAI,KAAK;AAAA,EAC7B,EAAE;AACJ;AAEO,SAAS,oBAAkC;AAChD,QAAM,SAAS,cAAc,IAAI;AACjC,QAAM,cAAc,cAAc,IAAI;AACtC,QAAM,UAAU,OAAO,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,OAAO,CAAC;AACtD,QAAM,eAAe,YAAY,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,OAAO,CAAC;AAChE,QAAM,SAAS;AAEf,QAAM,KAAK,CAAI,MAAY;AAE3B,SAAO;AAAA,IACL,YAAY,EAAE,OAAO,QAAQ,SAAS,OAAO,EAAE;AAAA,IAC/C,cAAc,EAAE,OAAO,EAAE;AAAA,IACzB,eAAe;AAAA,IACf,iBAAiB;AAAA,IAEjB,aAAa;AAAA,MACX;AAAA,QACE,WAAW;AAAA,QACX,OAAO;AAAA,QACP,WAAW;AAAA,QACX,SAAS;AAAA,MACX;AAAA,MACA;AAAA,QACE,WAAW;AAAA,QACX,OAAO;AAAA,QACP,WAAW;AAAA,QACX,SAAS;AAAA,MACX;AAAA,MACA;AAAA,QACE,WAAW;AAAA,QACX,OAAO;AAAA,QACP,WAAW;AAAA,QACX,SAAS;AAAA,MACX;AAAA,MACA;AAAA,QACE,WAAW;AAAA,QACX,OAAO;AAAA,QACP,WAAW;AAAA,QACX,SAAS;AAAA,MACX;AAAA,MACA;AAAA,QACE,WAAW;AAAA,QACX,OAAO;AAAA,QACP,WAAW;AAAA,QACX,SAAS;AAAA,MACX;AAAA,IACF;AAAA,IAEA,cAAc,CAAC,GAAG,GAAG,CAAC,EAAE;AAAA,MAAI,CAAC,MAC3B,GAAG;AAAA,QACD,IAAI,cAAc,CAAC;AAAA,QACnB,aAAa,MAAM,KAAK,CAAC;AAAA,QACzB,QAAQ,MAAM,IAAI,YAAY;AAAA,QAC9B,OAAO,CAAC,OAAO,MAAO,IAAI,EAAE,CAAC;AAAA,QAC7B,cAAc,MAAM,CAAC;AAAA,QACrB,eAAe,GAAG,MAAM,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,EAAE,YAAY,CAAC;AAAA,QACtD,WAAW,aAAa,EAAE,IAAI,IAAI,EAAE;AAAA,MACtC,CAAqB;AAAA,IACvB;AAAA,IAEA,gBAAgB;AAAA,MACd,GAAG;AAAA,QACD,IAAI;AAAA,QACJ,eAAe;AAAA,QACf,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,WAAW;AAAA,QACX,UAAU;AAAA,QACV,cAAc,MAAM,CAAC;AAAA,QACrB,eAAe;AAAA,QACf,SAAS,OAAO,EAAE;AAAA,QAClB,WAAW,OAAO,GAAG;AAAA,MACvB,CAAuB;AAAA,MACvB,GAAG;AAAA,QACD,IAAI;AAAA,QACJ,eAAe;AAAA,QACf,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,WAAW;AAAA,QACX,UAAU;AAAA,QACV,cAAc,MAAM,CAAC;AAAA,QACrB,eAAe;AAAA,QACf,SAAS,OAAO,CAAC;AAAA,QACjB,WAAW,OAAO,EAAE;AAAA,MACtB,CAAuB;AAAA,IACzB;AAAA,IAEA,kBAAkB;AAAA,MAChB,CAAC,4BAAyB,GAAG,WAAW;AAAA,MACxC,CAAC,gCAA6B,GAAG,WAAW;AAAA,MAC5C,CAAC,oBAAoB,IAAI,SAAS;AAAA,MAClC,CAAC,4BAAyB,IAAI,WAAW;AAAA,IAC3C,EAAE,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,GAAG,MAAM;AACjC,YAAM,OAAO,YAAa,MAAiB,EAAE;AAC7C,aAAO,GAAG;AAAA,QACR,IAAI,gBAAgB,CAAC;AAAA,QACrB,eAAe,MAAM,MAAM,CAAC;AAAA,QAC5B;AAAA,QACA,MAAM,KAAK,YAAY,EAAE,MAAM,GAAG,EAAE;AAAA,QACpC,WAAW,GAAG,OAAO,KAAK,SAAS,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC,IAAI;AAAA,UACxD,KAAK,WAAW;AAAA,QAClB,EAAE,SAAS,GAAG,GAAG,CAAC;AAAA,QAClB,cAAc,OAAO,IAAI,KAAK,MAAM,MAAM;AAAA,QAC1C,SAAS,EAAE,MAAM;AAAA,MACnB,CAA2B;AAAA,IAC7B,CAAC;AAAA,IAED,eAAe,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE;AAAA,MAAI,CAAC,MAC/B,GAAG;AAAA,QACD,IAAI,eAAe,CAAC;AAAA,QACpB,MAAM,OAAO,IAAI,KAAK,MAAM,MAAM;AAAA,QAClC,OAAO,GAAG,OAAO,IAAI,KAAK,MAAM,MAAM,EACnC,MAAM,GAAG,EAAE,CAAC,EACZ,YAAY,CAAC;AAAA,QAChB,WAAW,aAAa,EAAE,IAAI,IAAI,EAAE;AAAA,MACtC,CAAsB;AAAA,IACxB;AAAA,IAEA,YAAY;AAAA,MACV,CAAC,gBAAgB,aAAa,GAAG,MAAM,CAAC,CAAC,sBAAc,EAAE;AAAA,MACzD,CAAC,iBAAiB,gBAAgB,MAAM,CAAC,GAAG,EAAE;AAAA,MAC9C,CAAC,gBAAgB,gBAAgB,+BAAuB,EAAE;AAAA,MAC1D,CAAC,mBAAmB,mBAAmB,SAAS,GAAG;AAAA,MACnD,CAAC,iBAAiB,oBAAoB,iBAAiB,GAAG;AAAA,IAC5D,EAAE;AAAA,MAAI,CAAC,CAAC,MAAM,OAAO,aAAa,GAAG,GAAG,MACtC,GAAG;AAAA,QACD,IAAI,YAAY,CAAC;AAAA,QACjB;AAAA,QACA,OAAO;AAAA,QACP;AAAA,QACA;AAAA,QACA,WAAW,aAAa,GAAa;AAAA,MACvC,CAA4B;AAAA,IAC9B;AAAA,IAEA,WAAW,GAAG;AAAA,MACZ,OAAO;AAAA,QACL,cAAc;AAAA,QACd,aAAa;AAAA,QACb,mBAAmB,KAAK,MAAM,UAAU,MAAM;AAAA;AAAA;AAAA;AAAA,QAI9C,iBAAiB;AAAA,QACjB,kBAAkB;AAAA,MACpB;AAAA,MACA,mBAAmB;AAAA,IACrB,CAA8B;AAAA,IAE9B,gBAAgB,GAAG;AAAA,MACjB,OAAO;AAAA,QACL,cAAc;AAAA,QACd,aAAa;AAAA,QACb,mBAAmB,KAAK,MAAM,eAAe,GAAG;AAAA,QAChD,iBAAiB;AAAA,QACjB,kBAAkB;AAAA,MACpB;AAAA,MACA,mBAAmB;AAAA,IACrB,CAA8B;AAAA,IAE9B,aAAa,GAAG;AAAA,MACd,kBAAkB;AAAA,MAClB,OAAO;AAAA,MACP,cAAc;AAAA,MACd,eAAe;AAAA,IACjB,CAAmC;AAAA,IAEnC,SAAS,GAAG;AAAA,MACV,WAAW;AAAA,MACX,cAAc;AAAA,MACd,oBAAoB;AAAA,MACpB,eAAe;AAAA,MACf,UAAU;AAAA,IACZ,CAA+B;AAAA,EACjC;AACF;","names":[]}

package/dist/dashboard/home/greeting.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The home greeting.
+ *
+ * MODELLED ON CLAUDE'S, THEN TAKEN FURTHER. Claude.ai rotates a greeting keyed
+ * to real context rather than novelty: time of day ("Good morning", "Evening"),
+ * day of week ("Happy Friday", "Welcome to the weekend"), a contextual set
+ * ("Hello, night owl"), a casual set ("Back at it", "What's new"), and a
+ * fallback when it doesn't know your name. The name is appended, never required.
+ *
+ * Copying that verbatim would give Box a chat app's greeting. Box knows
+ * things a chat app doesn't — what the business has done today, where you are
+ * in the month, how long since you last opened this — so those are layers of
+ * their own. The clock is the floor, not the ceiling.
+ *
+ * THE ONE RULE. Every line is either a plain greeting or a statement that is
+ * literally TRUE at the moment it renders. That is what separates this from the
+ * slogans it replaced ("Let's make money today", "Who's buying today?"), which
+ * were marketing copy bolted onto a business tool. Personality comes from voice
+ * and from noticing real things — never from claiming things.
+ *
+ * PRIORITY, highest first. Each layer REPLACES the ones below it, so the most
+ * specific true thing wins:
+ *   1. return    you've been away a while
+ *   2. state     what the business has done today
+ *   3. calendar  first/last day of the month, new year
+ *   4. time + day  time of day, MIXED with any day-of-week flavour
+ *
+ * The first three replace what's below them. The last is the floor and always
+ * resolves, so there is no state in which the greeting comes out empty.
+ *
+ * STABILITY. Deterministic, seeded by date + day-part. It cannot reshuffle on a
+ * remount, a re-render or a route change — only when the clock crosses into a
+ * new part of the day. The version this replaced reshuffled on every remount,
+ * which made the page feel unstable.
+ */
+export interface GreetingContext {
+    /** First name, already capitalised. Omit and the lines drop the name. */
+    firstName?: string;
+    /** Orders/sales recorded today. */
+    todayOrders: number;
+    /** Bookings starting today. */
+    todaysBookings: number;
+    /** Whole days since this person last opened the dashboard, if known. */
+    daysSinceLastSeen?: number;
+    /** Injected so this is pure and testable. */
+    now: Date;
+}
+export declare function resolveGreeting(ctx: GreetingContext): string;

package/dist/dashboard/home/greeting.js

@@ -0,0 +1,154 @@
+const BANDS = [
+  "lateNight",
+  "earlyMorning",
+  "morning",
+  "afternoon",
+  "evening",
+  "night"
+];
+function band(hour) {
+  if (hour < 5) return "lateNight";
+  if (hour < 9) return "earlyMorning";
+  if (hour < 12) return "morning";
+  if (hour < 17) return "afternoon";
+  if (hour < 22) return "evening";
+  return "night";
+}
+const TIME_LINES = {
+  lateNight: [
+    "Still up, {name}",
+    "Late one",
+    "Burning the midnight oil",
+    "The night shift",
+    "Quiet hours, {name}"
+  ],
+  earlyMorning: [
+    "Early start, {name}",
+    "Good morning, {name}",
+    "First one in",
+    "Bright and early, {name}"
+  ],
+  morning: [
+    "Good morning, {name}",
+    "Morning, {name}",
+    "Hey {name}",
+    "Here we go, {name}",
+    "Right then, {name}"
+  ],
+  afternoon: [
+    "Good afternoon, {name}",
+    "Afternoon, {name}",
+    "How\u2019s it going, {name}",
+    "Back at it, {name}"
+  ],
+  evening: ["Good evening, {name}", "Evening, {name}", "Home stretch, {name}"],
+  night: [
+    "Winding down, {name}",
+    "Good evening, {name}",
+    "Late one, {name}",
+    "One last look, {name}"
+  ]
+};
+const DAY_LINES = {
+  0: [
+    "Working the weekend, {name}",
+    "Sunday shift, {name}",
+    "Happy Sunday, {name}"
+  ],
+  1: ["Happy new week, {name}", "New week, {name}", "Happy Monday, {name}"],
+  2: ["Happy Tuesday, {name}"],
+  3: ["Midweek, {name}", "Happy Wednesday, {name}"],
+  4: ["Happy Thursday, {name}", "Nearly there, {name}"],
+  5: [
+    "Happy Friday, {name}",
+    "That Friday feeling",
+    "Made it to Friday, {name}"
+  ],
+  6: [
+    "Weekend shift, {name}",
+    "Happy Saturday, {name}",
+    "Saturday trade, {name}"
+  ]
+};
+function calendarLines(now) {
+  const day = now.getDate();
+  const lastOfMonth = new Date(
+    now.getFullYear(),
+    now.getMonth() + 1,
+    0
+  ).getDate();
+  const month = now.toLocaleDateString(void 0, { month: "long" });
+  if (now.getMonth() === 0 && day === 1) {
+    return ["Happy new year, {name}", "New year, {name}"];
+  }
+  if (day === 1) {
+    return [
+      "Happy new month, {name}",
+      `${month}, {name}`,
+      "Clean slate, {name}"
+    ];
+  }
+  if (day === lastOfMonth) {
+    return ["Last day of the month, {name}", "Closing out the month, {name}"];
+  }
+  return [];
+}
+function returnLines(days) {
+  if (days === void 0 || days <= 1) return [];
+  if (days < 7) return ["Welcome back, {name}", "Good to see you, {name}"];
+  if (days < 30) {
+    return [
+      "Been a minute, {name}",
+      "Welcome back, {name}",
+      "It\u2019s been a week, {name}"
+    ];
+  }
+  return ["Long time, {name}", "Welcome back, {name}"];
+}
+function stateLines(ctx) {
+  const { todayOrders, todaysBookings, now } = ctx;
+  const activity = todayOrders + todaysBookings;
+  const hour = now.getHours();
+  if (activity >= 20) {
+    return ["What a day, {name}", "Flat out, {name}", "Big one today, {name}"];
+  }
+  if (activity >= 10) {
+    return [
+      "Busy one, {name}",
+      "Good day so far, {name}",
+      "Steady stream, {name}"
+    ];
+  }
+  if (activity > 0 && hour < 11) {
+    return ["Off to a start, {name}", "First one\u2019s in, {name}"];
+  }
+  if (activity > 0) {
+    return ["Ticking along, {name}", "Wheels turning, {name}"];
+  }
+  return [];
+}
+function seed(now, bandName) {
+  const dayOfYear = Math.floor(
+    (now.getTime() - new Date(now.getFullYear(), 0, 0).getTime()) / 864e5
+  );
+  return dayOfYear * 7 + BANDS.indexOf(bandName);
+}
+function firstNonEmpty(lists) {
+  for (const l of lists) if (l.length) return l;
+  return void 0;
+}
+function resolveGreeting(ctx) {
+  const { firstName, now, daysSinceLastSeen } = ctx;
+  const b = band(now.getHours());
+  const pool = firstNonEmpty([
+    returnLines(daysSinceLastSeen),
+    stateLines(ctx),
+    calendarLines(now)
+  ]) ?? [...TIME_LINES[b], ...DAY_LINES[now.getDay()] ?? []];
+  const line = pool[seed(now, b) % pool.length] ?? "Good morning, {name}";
+  return firstName ? line.replace("{name}", firstName) : line.replace(/,?\s*\{name\}/, "").replace(/^Hey$/, "Hey there");
+}
+export {
+  resolveGreeting
+};
+//# sourceMappingURL=greeting.js.map